Methods to Open an Android App from the Browser

This weblog put up was initially revealed in 2018. It has been up to date to mirror adjustments in Android App Hyperlinks.

Opening an put in app from a browser is called “deep linking,” and with this information you’ll discover ways to deep hyperlink into your Android app from the cell internet. We’ll focus solely on find out how to set off an app open from a web site web page, quite than from the press of a hyperlink inside different apps. 

Android is, by far, one of the fragmented platforms that builders have ever needed to handle, resulting from Google’s choice to power gadget producers to be chargeable for porting the OS, which requires backwards compatibility and assist of a mess of units. On this ecosystem, we, the app builders, are left to select up the items. Deep linking on Android is sadly no completely different— over time, we’ve seen a plethora of technical necessities that should be used relying on the circumstance and context of the person.

Word that Department will implement all of this complexity for you, host the deep hyperlinks, and even offer you strong analytics behind clicks, app opens, and down funnel occasions. You may mess around with Department hyperlinks without cost by signing up right here. We extremely advocate utilizing our instruments as a substitute of making an attempt to rebuild them from scratch, since constructing deep hyperlinks is extremely sophisticated. 

Overview of Android App Hyperlinks

Android App Hyperlinks are Android’s answer to take customers to particular in-app content material. They permit your customers to bypass the disambiguation dialogue the place they choose in the event that they wish to see content material on the cell internet or within the app, corresponding to within the following picture:

App Hyperlinks use HTTP and HTTPS URLs related along with your web site area, and permit a particular app to be the default proprietor of a given kind of hyperlink. This ensures that no different app can use your hyperlinks for deep linking. Word that with App Hyperlinks, customers who would not have your app put in will probably be taken to your cell web site. Due to this fact, for the most effective person expertise, configure your cell web site to deal with your App Hyperlink to stop customers from viewing a 404 web page.

Steps to Create Android App Hyperlinks:

1. Create intent filters for incoming hyperlinks, and outline values in your manifest

To hyperlink to your app content material, create an intent filter with the next components and attribute values for use in your Exercise tag inside your manifest:  

• <motion>: To specify the VIEW intent motion in order that the intent filter might be reached from Google Search or different internet hyperlink clicks.
• <knowledge> : The <knowledge> tag should embrace the android:scheme attribute. The information tags symbolize a URI format that resolves to the exercise.
• BROWSABLE class: required to ensure that the intent filter to be accessible from an internet browser. With out it, clicking a hyperlink in a browser can not route customers to your app. 
• DEFAULT class: to permit your app to answer implicit intents. 

Right here’s an instance of an intent filter inside a manifest for deep linking, utilizing the URI “https://www.instance.com/gizmos” : 

<intent-filter 
    android:autoVerify="true"        
    android_label="@string/filter_view_http_gizmos">
        <motion android_name="android.intent.motion.VIEW" />
        <class android_name="android.intent.class.DEFAULT" />
        <class android_name="android.intent.class.BROWSABLE" />
        <!-- Accepts URIs that start with "https://www.instance.com/gizmos” -->
        <knowledge android_scheme="https"
              android_host="www.instance.com"
              android_pathPrefix="/gizmos" />
        <!-- be aware that the main "/" is required for pathPrefix-->

Word that you should use http however then add the community configuration XML file with cleartextTrafficPermitted=true. Extra info right here. Additionally, be aware that cleartext info transmitted is just not encrypted and isn’t safe. 

Including intent filters with URIs for exercise content material to your app manifest permits Android to route any Intent that has matching URIs to your app.

2. Learn knowledge from incoming intents

Use knowledge out of your intent to find out the content material to indicate your customers. Name the getData() and getAction() strategies to retrieve the information and motion related to the incoming intent. 

Right here’s a code snippet displaying find out how to retrieve knowledge from an intent in Java:

@Override
public void onCreate(Bundle savedInstanceState) {
    tremendous.onCreate(savedInstanceState);
    setContentView(R.structure.important);

    Intent intent = getIntent();
    String motion = intent.getAction();
    Uri knowledge = intent.getData();
}

Or in Kotlin:

override enjoyable onCreate(savedInstanceState: Bundle?) {
   tremendous.onCreate(savedInstanceState)
   setContentView(R.structure.important)
   val intent: Intent = intent
   val motion: String? = intent.motion
   val knowledge: Uri? = intent.knowledge
}

3. Confirm possession of your app and web site

As of January 2023, the Google Play Retailer is requiring all new apps and updates to focus on at minimal Android 12, or API degree 31. Beginning with Android 12, you should confirm possession of each your app and your web site to be able to deep hyperlink your customers to your app content material. Observe these steps:

Request computerized app hyperlink verification in your manifest. 

This can ask the Android system to confirm that your app belongs to the URL area utilized in your intent filters.

Setting android_autoVerify=”true” declares your app to be the default handler for a kind of hyperlink for any one of many internet URL intent filters in your app manifest that embrace the android.intent.motion.VIEW intent motion and android.intent.class.BROWSABLE intent class.

Declare the connection between your web site and your intent filters 

To point the Android apps related along with your web site and app URL intents, begin by publishing a Digital Asset Hyperlinks JSON file at https://area.identify/.well-known/assetlinks.json.

You’ll want the next info to publish the Digital Asset Hyperlinks JSON file: 

• namespace: This worth is “android_app”
• package_name: The applying ID declared within the app’s construct.gradle file.
• sha256_cert_fingerprints: The SHA256 fingerprints of your app’s signing certificates. You should utilize the next command to generate the fingerprint by way of the Java keytool:

$ keytool -list -v -keystore my-release-key.keystore

Right here’s an instance:

https://branchster.app.hyperlink/.well-known/assetlinks.json

Guarantee that your assetlinks.json file is:

• served with content-type utility/json.
• accessible over an HTTPS connection, no matter whether or not your app’s intent filters declare HTTPS as the information scheme.
• accessible with none redirects (no 301 or 302 redirects) and accessible by bots (your robots.txt should permit crawling /.well-known/assetlinks.json).
• revealed on every area in case your app hyperlinks helps a number of host domains

Lastly, verify that the Digital Asset Hyperlinks JSON file is correctly hosted and outlined by utilizing the Digital Asset Hyperlinks API.

4. Check URL Intents

After verifying the web sites related along with your app and making certain that the hosted JSON file is legitimate, set up the app in your gadget. Wait no less than 20 seconds for the asynchronous verification course of to finish. Use the next command to examine whether or not the system verified your app and set the right hyperlink dealing with insurance policies:

adb shell am begin -a android.intent.motion.VIEW 
    -c android.intent.class.BROWSABLE 
    -d "https://area.identify:optional_port"

The adb device will launch an implicit intent android.intent.motion.VIEW with the class BROWSABLE and knowledge being your web site URL you’ve configured.

You may also evaluate an inventory of the hyperlinks dealt with by all of your apps with the next command: 

adb shell dumpsys bundle domain-preferred-apps

You’ll see within the output all of the linking behaviors for apps. Make sure that your app is ready to all the time open on a hyperlink click on.

“Bundle: your.app.bundle

Domains: your.area.com

Standing: all the time : 20000000c

The hexadecimal worth is the Android system’s document for app linking habits. 

And also you’re accomplished! That being mentioned, deep linking on Android is extremely sophisticated, and there are edge circumstances in every single place. You’ll suppose every thing goes properly till you come throughout distinctive edge circumstances and damaged hyperlinks. That’s why it’s best to use a device like Department — to avoid wasting you from that nightmare and be certain that your hyperlinks work in every single place. Contact us to find how one can implement deep hyperlinks that rework your person expertise, cut back churn, and enhance ROI.