Developer guides
Developer guides
Integration notes, migration guides and answers to the questions that come up most.
-
01 Sept 2026 · FieldTrack360
Known limitations
Stated, not discovered.
Read -
01 Sept 2026 · FieldTrack360
Usage
One unified API, with platform-specific namespaces for the rest.
Read -
01 Sept 2026 · FieldTrack360
iOS setup
One unavoidable native line, because Apple requires background-task registration before JS starts.
Read -
01 Sept 2026 · FieldTrack360
Android setup
JitPack credentials, SDK floors and a Maps key - all host steps a library cannot do for you.
Read -
01 Sept 2026 · FieldTrack360
Install
RN 0.76+ with the New Architecture. Bare CLI is the primary path.
Read -
01 Sept 2026 · FieldTrack360
Known limitations
Stated, not discovered.
Read -
01 Sept 2026 · FieldTrack360
Background tracking, and the Android OEM asterisk
Capture survives a swipe-kill on stock Android. Several OEM skins override that, and no SDK can defeat it from inside the app.
Read -
01 Sept 2026 · FieldTrack360
Drawing a track - two mistakes that silently ruin the render
Precision 6, not 5. And green is the fastest band, not the slowest.
Read -
01 Sept 2026 · FieldTrack360
What your app must implement
The plugin shows no UI, prompts nothing and draws nothing. Skipping any of this is a bug that looks like the SDK misbehaving.
Read -
01 Sept 2026 · FieldTrack360
The AGP 9 problem, and the workaround
As shipped, the SDK and Flutter Gradle have mutually exclusive requirements. Here is the pin that breaks the tie.
Read -
01 Sept 2026 · FieldTrack360
Install
A bridge, not a port. Every decision happens in the native SDKs.
Read -
01 Sept 2026 · FieldTrack360
Licensing
Checked once in ready(), entirely offline. Development needs no token.
Read -
01 Sept 2026 · FieldTrack360
Geofences and dwell
Circular regions that fire whether or not you are recording - plus the two ways crossings arrive.
Read -
01 Sept 2026 · FieldTrack360
Quick start
ready() belongs in your App initialiser, not a view task.
Read -
01 Sept 2026 · FieldTrack360
Host configuration - not optional
Without these Info.plist keys the SDK cannot capture in the background, and registration raises an exception no Swift catch can reach.
Read -
01 Sept 2026 · FieldTrack360
Install
iOS 17+, Swift 6. Five binary frameworks; hosts never receive source.
Read -
01 Sept 2026 · FieldTrack360
Licensing on Android
Release builds require a license token. Debuggable builds are waived automatically.
Read -
01 Sept 2026 · FieldTrack360
Observing and reading data
State, events and the live track, as Kotlin flows.
Read -
01 Sept 2026 · FieldTrack360
Tracking modes and configuration
Three capture strategies, three accuracy profiles, four providers.
Read -
01 Sept 2026 · FieldTrack360
Quick start
getInstance, ready, start, stop - in that order.
Read -
01 Sept 2026 · FieldTrack360
Install
minSdk 26, compileSdk 37, JDK 17. Kotlin-first, no Gradle plugin required.
Read -
01 Sept 2026 · FieldTrack360
Why we verify licences on the device, not on our servers
A tracking app that stops because a licence server was unreachable is worse than a licence that survives a few hours too long.
Read -
01 Sept 2026 · FieldTrack360
Application keys: what one key actually covers
One key, one app identifier, both platforms, forever. Here is why it is bound that way and what to do when the id changes.
Read