Skip to main content

​
Is the SDK safe to run in production?

Yes. The SDK is designed to run continuously during delivery sessions:
  • It batches telemetry to reduce network overhead.
  • It uses efficient system APIs for motion/location and networking.
  • You control which environment it talks to (SANDBOX vs LIVE).
We still recommend starting with a small pilot group and monitoring app performance and crash reports.

​
What happens if the device is offline?

If the device is temporarily offline:
  • startSession / startSessionWithDeviceInfo and stopSession may fail if the backend cannot be reached.
  • Telemetry uploads can be delayed until connectivity returns.
Integration tips:
  • Handle errors from startSession / stopSession gracefully in your UI.
  • Consider allowing drivers to retry stopSession if the first attempt fails.

​
Can I disable or remove the SDK?

Yes. You can:
  • Stop calling Desmo.setup and any session APIs.
  • Remove the desmo-android-sdk dependency from your Gradle configuration.
If you need to immediately disable ingest on the backend side, you can revoke the publishable key in the Desmo dashboard.

​
How do I test without affecting production data?

Use:
  • A sandbox publishable key (pk_sandbox_...).
  • DesmoEnvironment.SANDBOX when calling Desmo.setup.
This keeps test sessions and telemetry separate from live deliveries. You can create dedicated sandbox projects/tenants as needed.

​
How do I see what the SDK is doing?

  • Ensure logging is enabled (the default).
  • Watch Logcat for:
    • Session start/stop events.
    • HTTP requests and responses.
    • Any warnings or errors emitted by the SDK.
  • Use the Android Logging, Debugging & Troubleshooting guide for a detailed checklist.

​
How do I upgrade the SDK?

When a new version is released:
  1. Update the version in your Gradle dependency:
implementation("com.github.kubocreate:desmo-android-sdk:<new-git-tag>")
  1. Sync Gradle and rebuild your app.
  2. Re-run your tests and core delivery flows.
Because integration goes through Desmo.setup, startSession, and stopSession, most changes are backwards compatible as long as you stay within the same major version.

​
Who do I contact for support?

For API keys, backend configuration, or integration questions:
  • Reach out to your Desmo contact.
  • Or use the support channel linked from the Desmo dashboard.