Receive Firebase Dynamic Links on Android

< intent-filter 
> <action android:name="android.intent.action.VIEW"/> 
 <category android:name="android.intent.category.DEFAULT"/> 
 <category android:name="android.intent.category.BROWSABLE"/> 
 <data 
 android:host="example.com" 
 android:scheme="https"/ 
>
< /intent-filter> 
 AndroidManifest.xml 
 
 

When users open a Dynamic Link with a deep link to the scheme and host you specify, your app will start the activity with this intent filter to handle the link.

Handle deep links

To receive the deep link, call the getDynamicLink() method:

 Firebase 
 . 
 dynamicLinks 
  
 . 
 getDynamicLink 
 ( 
 intent 
 ) 
  
 . 
 addOnSuccessListener 
 ( 
 this 
 ) 
  
 { 
  
 pendingDynamicLinkData 
 : 
  
 PendingDynamicLinkData? 
 - 
>  
 // Get deep link from result (may be null if no link is found) 
  
 var 
  
 deepLink 
 : 
  
 Uri? 
 = 
  
 null 
  
 if 
  
 ( 
 pendingDynamicLinkData 
  
 != 
  
 null 
 ) 
  
 { 
  
 deepLink 
  
 = 
  
 pendingDynamicLinkData 
 . 
 link 
  
 } 
  
 // Handle the deep link. For example, open the linked 
  
 // content, or apply promotional credit to the user's 
  
 // account. 
  
 // ... 
  
 } 
  
 . 
 addOnFailureListener 
 ( 
 this 
 ) 
  
 { 
  
 e 
  
 - 
>  
 Log 
 . 
 w 
 ( 
 TAG 
 , 
  
 "getDynamicLink:onFailure" 
 , 
  
 e 
 ) 
  
 } 
 
  MainActivity 
 . 
 kt 
 
 

 FirebaseDynamicLinks 
 . 
 getInstance 
 () 
  
 . 
 getDynamicLink 
 ( 
 getIntent 
 ()) 
  
 . 
 addOnSuccessListener 
 ( 
 this 
 , 
  
 new 
  
 OnSuccessListener<PendingDynamicLinkData> 
 () 
  
 { 
  
 @Override 
  
 public 
  
 void 
  
 onSuccess 
 ( 
 PendingDynamicLinkData 
  
 pendingDynamicLinkData 
 ) 
  
 { 
  
 // Get deep link from result (may be null if no link is found) 
  
 Uri 
  
 deepLink 
  
 = 
  
 null 
 ; 
  
 if 
  
 ( 
 pendingDynamicLinkData 
  
 != 
  
 null 
 ) 
  
 { 
  
 deepLink 
  
 = 
  
 pendingDynamicLinkData 
 . 
 getLink 
 (); 
  
 } 
  
 // Handle the deep link. For example, open the linked 
  
 // content, or apply promotional credit to the user's 
  
 // account. 
  
 // ... 
  
 // ... 
  
 } 
  
 }) 
  
 . 
 addOnFailureListener 
 ( 
 this 
 , 
  
 new 
  
 OnFailureListener 
 () 
  
 { 
  
 @Override 
  
 public 
  
 void 
  
 onFailure 
 ( 
 @NonNull 
  
 Exception 
  
 e 
 ) 
  
 { 
  
 Log 
 . 
 w 
 ( 
 TAG 
 , 
  
 "getDynamicLink:onFailure" 
 , 
  
 e 
 ); 
  
 } 
  
 }); 

You must call getDynamicLink() in every activity that might be launched by the link, even though the link might be available from the intent using getIntent().getData() . Calling getDynamicLink() retrieves the link and clears that data so it is only processed once by your app.

You normally call getDynamicLink() in the main activity as well as any activities launched by intent filters that match the link.

Record analytics

The following events can be automatically tracked in Google Analytics and shown in the Firebase console.

• dynamic_link_app_open
• dynamic_link_first_open
• dynamic_link_app_update

In order to register these events, you need to configure Google Analytics before you retrieve the deep link. Check the following conditions are met:

• Call FirebaseDynamicLinks.getDynamicLink() in your app entry points:
• Launcher activities. e.g.: action="android.intent.action.MAIN" , category="android.intent.category.LAUNCHER" .
• Activity entry points. e.g.: onStart() , onCreate() .
• Deep link activities.
• Set up and use Google Analytics :
• Include the Google Analytics dependency. This is usually automatically added by the google-services Gradle plugin.
• Include the google-services.json config file in your app.
• Call FirebaseAnalytics.getInstance() before calling FirebaseDynamicLinks.getDynamicLink() .

Handling Dynamic Links using App Links

On Android 6.0 (API level 23) and higher, you can set up your app to handle Dynamic Links directly when your app is already installed by using Android App Links .

Ensure that you have added the SHA256 certificate fingerprint for your app into your project in the Firebase console . Dynamic Links will handle setting up the App Links website association for your Dynamic Links domain.

Add an auto-verified intent filter to the Activity that will handle the Dynamic Link , setting the host to your project's Dynamic Links domain as found in the Firebase console . In the AndroidManifest.xml :

<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:host="example.com/link" android:scheme="http"/>
    <data android:host="example.com/link" android:scheme="https"/>
</intent-filter>

Note that the android:host must be set to your Dynamic Links domain, and not the domain of your deep link.

All autoVerify intent filters in your manifest must be registered in order for App Links to engage. Firebase handles this automatically for your Dynamic Links domains, but you can check this by opening the assetlinks.json file hosted on your Dynamic Links domain:

https:// YOUR_DOMAIN 
/.well-known/assetlinks.json

Dynamic Links will now be sent directly to your app. You will be able to get the deep link and other Dynamic Link data by calling getDynamicLink() in the Activity you added the App Links intent filter to (as described in Handle deep links ).

Note: Since invoking through App Links takes the user directly to the app, a Dynamic Link cannot honor the required minimum version. So once the app is opened, you need to compare the Dynamic Link's minimum version ( getminimumappversion ) against PackageInfo.versionCode and redirect the user to upgrade the app if required using getUpdateAppIntent .