Modified on: Fri, Apr 27, 2018 at 7:30 AM
Troubleshooting guide for Android app not opening when using Branch links
Preface: Everything about the opening of the Android App is configured via the following 3 components:
App's Android Manifest file
App Link settings on Dashboard->Link settings->Android redirects
Make sure you have followed our documentation to set up the Android SDK
Fill out the Android App's package name and URL on the Dashboard->Link settings->Android redirects.
Add Branch link in the Intent-Filter of the Launcher Activity. (You can copy the exact same code and replace the xxxx with your Branch link domain. If you do not know what your domain is, please refer to Step 2.)
Branch link verification: Please make sure that the link you are testing with belongs to your app. This can easily be verified from the link domain that is present on your Dashboard-> Link settings->Link Domain. The Branch link domain resembles like "xxxx.app.link".
- Setup verification
Make sure that:
Package name on the Manifest file matches EXACTLY with what is configured on Link Settings.
There is an Activity with an intent filter having the scheme EXACTLY the as configured in the URI scheme section on Dashboard->Link Settings-Android->URI Scheme. This usually is your app's splash activity.
URI scheme host in manifest matches Branch link. Our docs recommend "host=open", but if you have $deeplink_path with something other than "open", then the link will fail to open the app.
Platform Behavior Verification: Clicking the Branch link from different apps such as Facebook, Twitter etc. can produce different redirection behaviors. Please make sure you go through the expected behaviors of the various known platforms as mentioned in our documentation.
Advanced Branch link verification(These verifications may vary for different link behaviors and are only for advanced use-cases)
If you are using the $android_deeplink_path Branch link property, instead of using the custom key-value Branch link property, you would need to make sure you have set the URI scheme path in the Manifest file to handle that incoming URI scheme. Branch will append the value in $android_deeplink_path to your app's URI scheme so ensure that there is a corresponding intent filter.
Use the interactive troubleshooting guide to resolve common Android app not opening errors.
Did you find it helpful?Send feedback