Troubleshoot Android Instant Apps development issues

This page describes common problems or issues that can arise when developing Android Instant Apps and how to fix them. If you encounter other challenges while developing your instant app, check the Android Instant Apps posts on StackOverflow.

Run the Instant App APK

A common issue when you run an instant app is that the browser tries to load the URL instead of running the instant app. This problem can occur for a variety of different reasons.

Here are some steps to try to fix it:

• Check adb logcat to see if there are any details on why the browser was triggered instead of the instant app.
• Ensure you are using a URL that is mapped in the AndroidManifest.xml of the base library. Check the <intent-filter> and that the URL being used uses the corresponding scheme, host, and path.

<intent-filter android:order="2">
    <action android:name="android.intent.action.VIEW" />
    <category android:name="android.intent.category.BROWSABLE" />
    <category android:name="android.intent.category.DEFAULT" />
    <data
        android:host="example.com"
        android:scheme="https"
        android:pathPrefix="/hello"/>
</intent-filter>

Here are some other issues that can occur when you run your instant app: