TransistorAuthorizationService

public enumTransistorAuthorizationService

Client for the Transistor Software demo tracking server.

Transistor Software hosts a public demo server at tracker.transistorsoft.com that consumes location data from devices running the Background Geolocation SDK. You can also run a local instance — see background-geolocation-console.

The demo server is useful for evaluating the SDK or for sharing tracking results with Transistor Support when debugging.

Viewing results

To view tracking results in a browser, visit:

https://tracker.transistorsoft.com/<your-organization-name>

// Not available in native Swift API

---

Members

destroyToken

public static func destroyToken(url: String)

Remove the cached token associated with the given tracker URL.

findOrCreateToken

public static func findOrCreateToken( org: String, username: String, url: String, framework: String = "Swift" ) async throws ->BGGeo.TransistorToken

Find or create an authorization token for the given organization and username.

If a token already exists in the local cache for this orgName + url combination, the cached token is returned. Otherwise a new token is requested from the server and cached for future calls.

If the server refuses the registration (HTTP 403), the call fails: the Promise rejects with an error whose status is 403, and in Dart the Future completes with an error whose code is 403. Any other failure, such as no network connection, returns a placeholder token whose accessToken is DUMMY_TOKEN. In the Kotlin and Swift APIs, findOrCreateToken throws on any failure.

let bgGeo = BGGeo.shared
Task {
    do {
        let token = try await BGGeo.TransistorAuthorizationService.findOrCreateToken(
            org: "my-company-name",
            username: "my-username",
            url: "https://tracker.transistorsoft.com"
        )
        bgGeo.ready(transistorAuthorizationToken: token) { _ in }
    } catch {
        print("[findOrCreateToken] Error: \(error)")
    }
}