Compatibility
| Requirement | Supported |
|---|---|
| Dart SDK | >=3.4.0 <4.0.0 |
| Flutter | >=3.22.0 |
| iOS | ≥ 15.5 |
| Android | minSdk 24, compileSdk 36 |
| Kotlin (consumer) | 2.1.20 toolchain (matches the plugin’s own build) |
| Android Gradle Plugin | 8.7.3 |
See Installation for the full setup steps, and Migrating from Transistorsoft if you’re moving from that library.
iOS & Android only
BGeo Flutter has no Flutter web or desktop support — the closed-source native
engine (BGeoCore.xcframework / dev.bgeo:bgeo-android) is mobile-only, so
the plugin only registers platform implementations for iOS and Android. There
is no web, macOS, Windows, or Linux target, and none is planned. See
Limitations.
Binary distribution
The engine ships as prebuilt binaries inside the bgeo_background_geolocation
pub package:
- iOS —
BGeoCore.xcframework(device + simulator slices), vendored by the podspec (s.platform = :ios, '15.5'). dSYMs are not shipped; crash reports are symbolicated by us on request. - Android —
dev.bgeo:bgeo-androidAAR in a local Maven repo inside the package (android/libs), R8-obfuscated internals. The plugin’s ownandroid/build.gradlepins the AAR version (0.13.0) it was built and tested against; you don’t select it yourself. Consumer apps must add the plugin’s local-maven repo to their ownandroid/app/build.gradle(.kts)— see Installation.
Kotlin metadata
The AAR is compiled with Kotlin 2.1.20. If your app uses a significantly older Kotlin toolchain and hits a metadata error, upgrade the Kotlin plugin or contact support.