Android App Links
Branch makes it simple to enable Android App Links all while greatly improving on them, offering full attribution, supporting edge cases where Android App Links fail (common) and allowing you to deep link when the user doesn't have your app installed. Note that Android App Links only work on Android 6+. Don't worry, Branch will handle all the other edge cases.
Generate signing certificate fingerprint¶
Start by generating a SHA256 fingerprint of your app's signing certificate.
- Navigate to your keystore file. This is the file that you use to build the debug and production version of your APK file before deploying it.
- Run this command on it to generate the fingerprint:
keytool -list -v -keystore my-release-key.keystore
- You'll see a value like
14:6D:E9:83:C5:73:06:50:D8:EE:B9:95:2F:34:FC:64:16:A0:83:42:E6:1D:BE:A8:8A:04:96:B2:3F:CF:44:E5come out the other end. Copy this.
Enable App Links on the Branch dashboard¶
- Head to the Link Settings page on the Branch dashboard.
- Toggle the Enable App Links checkbox in the Android section.
- Paste the copied fingerprint value into the SHA256 Cert Fingerprints field that appears.
- Scroll down and click
Using multiple fingerprints
You can insert both your debug and production fingerprints for testing. Simply separate them with a comma.
Add Intent Filter to Manifest¶
- Go to the Link Settings page on the dashboard.
- Scroll down to the
- Copy your domain name.
- Choose the
Activityyou want to open up when a link is clicked. This is typically your
BaseActivitythat all other activities inherit from (and likely the same one you selected in the SDK integration guide).
- Inside your
AndroidManifest.xml, locate where the selected
- Within the
Activitydefinition, insert the intent filter provided below (making sure that
xxxxmatches the subdomain prefix you've been assigned or selected for yourself). Be sure to add this as its own separate intent filter.
Using a custom domain or subdomain?
If you use a custom domain or subdomain for your Branch links, you should also add an entry for:
<data android:scheme="https" android:host="mycustomdomainorsubdomain" />
<intent-filter android:autoVerify="true"> <action android:name="android.intent.action.VIEW" /> <category android:name="android.intent.category.DEFAULT" /> <category android:name="android.intent.category.BROWSABLE" /> <data android:scheme="https" android:host="xxxx.app.link" /> <data android:scheme="https" android:host="xxxx-alternate.app.link" /> <data android:scheme="https" android:host="xxxx.test-app.link" /> <data android:scheme="https" android:host="xxxx-alternate.test-app.link" /> </intent-filter>
The system must be able to verify every host specified in the app’s URL intent filters’ data elements against the Digital Asset Links files hosted on all the respective web domains. If any verification fails, the app is not verified to be a default handler for any of the URL patterns defined in the app's intent filters. You can use Google's Statement List Asset Generator to test your existing statement file.
Get APK SHA256 Fingerprints¶
keytool -printcert -jarfile my_app.apk on your APK file.