Compatibility
| Requirement | Supported |
|---|---|
| React Native | ≥ 0.76 (New Architecture / TurboModule only) |
| iOS | ≥ 15.5 |
| Android | minSdk 24, compileSdk/targetSdk 36 |
| Kotlin (consumer) | 2.1.20 toolchain (matches the module’s own build) |
| Android Gradle Plugin | 8.13.0 |
See Installation for the full setup steps, and Migrating from Transistorsoft if you’re moving from that library.
New Architecture only
BGeo is TurboModule-only. There is no Old Architecture (bridge) build — the
Android module only applies the com.facebook.react Gradle plugin when
newArchEnabled=true, and the podspec’s install_modules_dependencies call
configures New Architecture build flags unconditionally. If your app hasn’t
migrated to the New Architecture (default since RN 0.76), do that first. See
Limitations.
Binary distribution
The engine ships as prebuilt binaries inside the npm package:
- iOS —
BGeoCore.xcframework(device + simulator slices), vendored by the podspec (s.platforms = { :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 module’sandroid/build.gradlepins the AAR version it was built and tested against; you don’t select it yourself.
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.