I am trying to test android deep link urls through adb to launch my app

Question

When I type the command in adb:

./adb shell am start -W -a android.intent.action.VIEW -d "example:gizmos" com.myapp

I get this error:

Starting: Intent { act=android.intent.action.VIEW dat=example://gizmos pkg=com.myapp }
Error: Activity not started, unable to resolve Intent { act=android.intent.action.VIEW dat=example://gizmos flg=0x10000000 pkg=com.myapp }

But when I type the command in adb:

./adb shell am start -W -a android.intent.action.VIEW -d "example:gizmos" com.myapp.activity.DeepLinkActivity

Everything works fine and I get the message and I can see the activity launch on the phone:

Starting: Intent { act=android.intent.action.VIEW dat=example://gizmos cmp=com.myapp.activity.DeepLinkActivity }
Status: timeout
Activity: com.myapp.activity.DrawerActivity
Complete

My question is why do I need to get full path of my activity and not just package name? Because when the external apps or browser will try to deep link they will not invoke the activity in my app.

This is my AndroidManifest.xml

<activity
        android:name=".activity.DeepLinkActivity">
        <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:scheme="example"
                  android:host="gizmos" />

        </intent-filter>
</activity>

pixel · Answer 1 · 2017-11-06T15:50:42.930

193

You don't need to specify full path to your activity, but if you want to test whether you react properly to URI in your app just specify app package:

adb shell am start -a android.intent.action.VIEW -d "example://gizmos" com.myapp

Also there is bug in command you provided - there should be example://gizmos not example:gizmos

edited Nov 06 '17 at 15:50

answered Apr 13 '15 at 08:41

pixel

24,905
36
149
251

While this works, when launch in `Terminal` of Android Studio it can write: `/system/bin/sh: com.myapp: inaccessible or not found`. The app link starts without error. To avoid this message, just remove `com.myapp` from the end. – CoolMind Jun 08 '23 at 18:01

score 117 · Answer 2 · answered Nov 07 '19 at 05:24

117

Here is the command

adb shell am start -d your-deep-link

Example

adb shell am start -d rm://yoursettingpage/v1

answered Nov 07 '19 at 05:24

Farid Haq

3,728
1
21
15

4

This is the best and simple answer for this question. – coder Dec 13 '20 at 10:10
Completely agree: Best answer so far – Joaquin Iurchuk Mar 31 '21 at 18:11
14

if you have extras in your deeplink (e.g. "?a=100&b=200") surround deeplink with `"`s and surround adb-shell with `'`s. example: `adb shell 'am start -d "example://deeplink?a=100&b=200"'` – Re'em Apr 08 '21 at 13:37
this shows my app status as Ask, any solution? even i added autoVerify = true – Moustafa EL-Saghier Jan 10 '22 at 15:56
Interesting, keep in mind that this won't add the categories BROWSABLE or action VIEW, Amaury answer is good too. – htafoya Mar 24 '22 at 17:54
What is the difference between declaring and omitting the `-a android.intent.action.VIEW` action argument? – adravel Aug 07 '23 at 03:55

score 56 · Answer 3 · answered Mar 24 '17 at 09:50

56

The best solution for android studio is explained here: https://code.tutsplus.com/tutorials/how-to-enable-deep-links-on-android--cms-26317

TLDR : Android Studio --> Run --> Edit Configurations

Change Launch in Launch Options to "URL" and enter in the text field URL the correct url: "something://"

answered Mar 24 '17 at 09:50

RoaflinSabos

937
8
9

2

this is the best and easiest way, thanks! – tasjapr Aug 01 '22 at 11:39

score 24 · Answer 4 · answered Dec 30 '20 at 13:18

24

You can test your deeplink from Android Studio interface.

Select Tools > App Links Assistant.
Click Test App Links in the App Links Assistant.
Enter the URL you want to test in the URL field, for example, http://recipe-app.com/recipe/grilled-potato-salad.
Click Run Test.

Take a look for learn how to implement applinks via Android Studio Interface. https://developer.android.com/studio/write/app-link-indexing#testindent

answered Dec 30 '20 at 13:18

Savas Adar

4,083
3
46
54

2

This appears to only work for app links with an http or https scheme – Julian K Aug 04 '21 at 18:02
3

When I press run test, I get a success message but the page opens in my device's web browser. – SimpleJ Jan 04 '22 at 21:30
It works. First `Gradle` builds for a minute, then in emulator a dialog appears to choose between Chrome and an application. After selecting the application it opens a right screen. But it launches the application from the beginning (if it was opened before, it will be reopened). – CoolMind Mar 22 '22 at 08:02
@SimpleJ You need to enable the link handling in the app-info screen too. I think it gets enabled automatically only when installed by the Play Store, or something. If you know this already, please share your insights of how it works. – android developer Aug 17 '22 at 09:26

score 16 · Answer 5 · answered Mar 27 '16 at 17:50

As the other answer mentioned, it should be "example://gizmos" and not "example:gizmos"

Alternatively, instead of using adb, you can test deep links directly on android using deep link tester app:

https://play.google.com/store/apps/details?id=com.manoj.dlt

No need to mention any package name or component name. Just type the deep link and fire.

I've found testing deep links through adb to be cubersome and difficult at times. Hence, I've built this small app to do it.

Abdallah Abdelazim · Answer 6 · 2021-03-23T13:25:07.237

15

The best way I found is through Android Studio itself.

Open the Run/Debug Configurations dialog by selecting Edit Configurations... option like in the image below:
After that add a new configuration with options like in the below image (if you're using Firebase Dynamic Links then enter your dynamic link's short link in the URL field else enter your deep link instead in the URL field):
After that, you'll find the run configuration, select it, and just press Run:

Add as many run configurations for each link you want to test.

edited Mar 23 '21 at 13:25

answered Mar 23 '21 at 13:15

Abdallah Abdelazim

362
2
14

1

This should be the current answer, as the screenshot shows what to do. – Martin Zeitler Dec 18 '21 at 18:03
I suppose, it will start an application from the beginning. If we want to test an already opened app, it will start again. – CoolMind Mar 22 '22 at 08:33

score 13 · Answer 7 · edited Dec 15 '19 at 22:07

13

Try this:

adb shell am start -a android.intent.action.VIEW -c android.intent.category.BROWSABLE -d 'yourdeeplink'

-a android.intent.action.VIEW -> action  -c android.intent.category.BROWSABLE -> category -d 'deeplink' -> data

and also you need to install the app first in order to register the deeplink.

edited Dec 15 '19 at 22:07

nbk

45,398
8
30
47

answered Dec 13 '19 at 15:14

Amaury Ricardo

267
2
5

-a android.intent.action.VIEW -> action ---------- -c android.intent.category.BROWSABLE -> category ---------- -d 'deeplink' -> data ---------- and also you need to install the app first in order to register the deeplink. – Amaury Ricardo Dec 15 '19 at 19:09

score 8 · Answer 8 · answered Jan 18 '22 at 14:38

8

If your deeplink has http or https scheme you can use the google text box in Android:

Just copy your deeplink there

answered Jan 18 '22 at 14:38

Ilya Mashin

904
1
12
28

1

It works! Работает! – CoolMind Mar 22 '22 at 08:38
It doesnt work for mine, maybe you already have your site already associated? – htafoya Mar 24 '22 at 17:23
@htafoya Try to check your application settings in android and look at "Open by default" Maybe you have to add your link there – Ilya Mashin Mar 25 '22 at 06:41

score 7 · Answer 9 · edited Aug 16 '16 at 13:04

Your command is incorrect because you are trying with an incorrect package name, Instead of com.myapp.activity.DeepLinkActivity you have to write only the package name specified in build gradle(Module: app) by 'application Id' e.g if your applicationId is com.companyname, then your command would be like this:

adb shell am start -W -a android.intent.action.VIEW -d  "example://gizmos" com.companyname

score 7 · Answer 10 · answered Aug 17 '20 at 09:57

7

The command

adb shell dumpsys package domain-preferred-apps

is also very helpful to print all active deep link handlers known to the system. If your app is missing here, there's obviously something wrong with your deep link setup.

answered Aug 17 '20 at 09:57

Lars Blumberg

19,326
11
90
127

score 3 · Answer 11 · answered Apr 11 '19 at 21:18

Just in case someone else has the problem that I had, namely that adb shell am start ... does not work, if you have a file:///... or content://...URI in your intent filter that has a mime type specified, for example

<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:scheme="content" />
  <data android:scheme="file" />
  <data android:mimeType="text/plain" />
  <data android:host="*" />
</intent-filter>

You need to specify the mime type on the command line by using the -t parameter:

adb shell am start -W -a android.intent.action.VIEW -d "file:///sdcard/myfolder/myfile.txt" -t "text/plain" com.myapp

or else you get the same error message as the OP.

Based on the experience I just had I recommend using this list of available adb commands. It seems to be more recent than the help texts from the shell of my test device running Android 8.

score 2 · Answer 12 · answered Mar 22 '22 at 09:17

2

Search Google Play for DeepLink. Download apk (via other sites that support downloading). Then install the application on emulator. For instance, https://play.google.com/store/apps/details?id=com.waterbottle.testdeeplink.

answered Mar 22 '22 at 09:17

CoolMind

26,736
15
188
224

score 2 · Answer 13 · answered May 18 '22 at 11:22

Following should work

adb shell am start -W -a android.intent.action.VIEW -d "example://gizmos" com.myapp

Here

example://gizmos

is the URI scheme that you have setup.

But if you want to pass additional parameters to URI scheme and test it,

example

example://gizmos?parameter1=23&parameter2=test

then the command would be,

adb shell 'am start -W -a android.intent.action.VIEW -d "example://gizmos?parameter1=23&parameter2=test"' com.myapp

score 1 · Answer 14 · answered Aug 22 '20 at 06:37

Testing deep-linking by running adb shell command seems troublesome to me. So I tried an Easy Solution to reduce my task and time to test deep-linking multiple time using .bat file.

Step 1: First create a .txt file and paste here your ADB command -

adb shell am start -W -an android.intent.action.VIEW -d <Your URL> <Your Package>

and save the file changing .txt extension into .bat. Now you have just created your bat file to test deeplink. Try to use just one letter to name the bat file (Like I named d.bat , "d" for "deeplinking" for easy understanding) because it reduce your time of typing.

Step 2: Now open your terminal in Android studio and go to your bat file location and just type your file name (without extension) and press enter. For example cd your/bat/file/location/d here suppose "d" is your bat file name.

It will work spiffy!

missing "-c android.intent.category.BROWSABLE" – Aure77 May 25 '21 at 09:23 — Aure77, May 25 '21 at 09:23

score 1 · Answer 15 · answered Jan 05 '21 at 10:18

I found Savas Adar's answer the most friendly to use, also makes much more sense to have an inbuilt tool for that purpose.

Just use that!

I have three quick disclaimers about the App Links Assistant which are missing in his answer and a comment was too long.

Open App Links Assistant. I couldn't find it in the Tools menu. So double press Shift and type App Link Assistant to run it from Android Studio
Pressing "Run Test" would clear the edit text box so I found myself having to copy and paste my link every time I wanted to re-try the test. Foolish of myself not reading the text literally above it saying that after running a test a Run Configuration gets created with the previous url attached to it. (Top of the screen, left of the device menu). Just select the run configuration with the url you want.
I found that pressing "Run Test" would restart the app unlike the ABD approach which is no biggie (just slower) until I wanted to debug. I ran the app in the debug mode and then pressed Run Test which would stop my debugging sessions and restart the app...

Solution is to choose the Run Configuration from point 2, and just run it as a debug.

I am trying to test android deep link urls through adb to launch my app

15 Answers15

Linked