Skip to main content

SDK Troubleshooting & FAQ

Common Issues

SDK not starting

  • Verify your API key is correct
  • Ensure Orbitly.init() is called before Orbitly.start()
  • Check that user consent has been given: Orbitly.hasConsent()
  • Confirm the device has an active internet connection

Build errors after adding the SDK

  • Make sure the Orbitly Maven repository is added to your Gradle config
  • Verify the SDK version number is correct
  • Run File → Invalidate Caches / Restart in Android Studio
  • Check for dependency conflicts with ./gradlew dependencies

Low or no earnings

  • Confirm Orbitly.isRunning() returns true
  • Earnings depend on demand, location, and connection quality
  • Allow time for the SDK to establish connections

Battery drain

  • The SDK is designed for minimal battery impact
  • If users report high battery usage, ensure you are not calling start() and stop() in rapid succession
  • Use setWifiOnly(true) to reduce mobile radio usage

Frequently Asked Questions

Does the SDK work on all Android devices?

The SDK supports Android 7.0 (API 24) and above. It works on all major manufacturers including Samsung, Xiaomi, Huawei, Google Pixel, and more.

How much does the SDK add to my APK size?

The SDK adds approximately 1–2 MB to your APK size.

Can I use the SDK alongside ad networks?

Yes. The Orbitly SDK is fully compatible with all major ad networks (AdMob, Unity Ads, AppLovin, etc.).

How do I get my developer API key?

Sign up at orbitlyapp.com/developers and create a project in the developer portal.

Where can I get developer support?

Contact the SDK team at sdk-support@orbitlyapp.com or visit the developer documentation portal.