Developer guides

01 Sept 2026 · Field Track 360

Known limitations

Stated, not discovered.

01 Sept 2026 · Field Track 360

Usage

One unified API, with platform-specific namespaces for the rest.

01 Sept 2026 · Field Track 360

iOS setup

One unavoidable native line, because Apple requires background-task registration before JS starts.

01 Sept 2026 · Field Track 360

Android setup

JitPack credentials, SDK floors and a Maps key - all host steps a library cannot do for you.

01 Sept 2026 · Field Track 360

Install

RN 0.76+ with the New Architecture. Bare CLI is the primary path.

01 Sept 2026 · Field Track 360

Known limitations

Stated, not discovered.

01 Sept 2026 · Field Track 360

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.

01 Sept 2026 · Field Track 360

Drawing a track - two mistakes that silently ruin the render

Precision 6, not 5. And green is the fastest band, not the slowest.

01 Sept 2026 · Field Track 360

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.

01 Sept 2026 · Field Track 360

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.

01 Sept 2026 · Field Track 360

Install

A bridge, not a port. Every decision happens in the native SDKs.

01 Sept 2026 · Field Track 360

Licensing

Checked once in ready(), entirely offline. Development needs no token.

01 Sept 2026 · Field Track 360

Geofences and dwell

Circular regions that fire whether or not you are recording - plus the two ways crossings arrive.

01 Sept 2026 · Field Track 360

Quick start

ready() belongs in your App initialiser, not a view task.

01 Sept 2026 · Field Track 360

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.

01 Sept 2026 · Field Track 360

Install

iOS 17+, Swift 6. Five binary frameworks; hosts never receive source.

01 Sept 2026 · Field Track 360

Licensing on Android

Release builds require a license token. Debuggable builds are waived automatically.

01 Sept 2026 · Field Track 360

Observing and reading data

State, events and the live track, as Kotlin flows.

01 Sept 2026 · Field Track 360

Tracking modes and configuration

Three capture strategies, three accuracy profiles, four providers.

01 Sept 2026 · Field Track 360

Quick start

getInstance, ready, start, stop - in that order.

01 Sept 2026 · Field Track 360

Install

minSdk 26, compileSdk 37, JDK 17. Kotlin-first, no Gradle plugin required.

01 Sept 2026 · Field Track 360

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.

01 Sept 2026 · Field Track 360

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.