Skip to main content

Universal Deeplink Issues

Common deeplink and deferred deeplink issues across all AppTrove SDKs.

  • Normal Deeplinks: App installed → Opens directly
  • Deferred Deeplinks: App not installed → Redirects to store → After install, opens with data
  • Universal Links (iOS): Uses apple-app-site-association file

Common Issues​

Symptoms: Opens browser instead of app, "No app found" error Issues: Incorrect URL scheme, missing intent filters, wrong host configuration Check: URL scheme, intent filters, browser defaults

2. Play Store Redirection Issues​

Symptoms: Doesn't redirect to store, wrong store, "App not found" Issues: Store redirect not configured, wrong store URL, app not published Check: Trackier Panel settings, store URL, app availability

3. App Not Opening Specific Page After Installation​

Symptoms: Opens to home screen, no deeplink data received Issues: Callback not set before SDK init, network issues, timing problems Check: Callback timing, SDK initialization order, network connectivity

4. Deeplink Opens App But Wrong Page​

Symptoms: Navigates to wrong screen, parameters not processed Issues: Parameter parsing errors, navigation logic issues, URL encoding problems Check: Parameter parsing, navigation routing, URL encoding

Symptoms: Opens Safari instead of app, Associated Domains errors Issues: Missing Associated Domains, incorrect apple-app-site-association file Check: Xcode configuration, file hosting, Bundle ID matching

6. Works on Some Devices But Not Others​

Symptoms: Works on Android but not iOS, inconsistent behavior Issues: Platform-specific configuration, OS version compatibility Check: Platform configs, OS compatibility, device-specific implementations

7. Works in Development But Not Production​

Symptoms: Works in dev, fails in production Issues: Environment differences, SDK key differences, ProGuard obfuscation Check: Environment settings, SDK keys, build configuration

Platform-Specific Issues​

Android​

  • Android 12+: Requires android:exported="true"
  • ProGuard: Add rules to prevent obfuscation
  • Intent Filters: Must be properly configured

iOS​

  • Associated Domains: Must be enabled in Xcode
  • apple-app-site-association: Must be hosted correctly
  • Bundle ID: Must match across all configurations

Common Errors​

  • Android: ActivityNotFoundException, SecurityException, ClassNotFoundException
  • iOS: Associated Domains not configured, Universal Link failed, Bundle ID mismatch

Support​

Note: Always test on real devices and verify configuration matches documentation.