How do I send an intent using Android's ADB tools?
18 Answers
adb shell
am start -n com.package.name/com.package.name.ActivityName
Or you can use this directly:
adb shell am start -n com.package.name/com.package.name.ActivityName
You can also specify actions to be filter by your intent-filters:
am start -a com.example.ACTION_NAME -n com.package.name/com.package.name.ActivityName
-
27Thank you very much , i've made it shell function in ~/.bash_profile to be much faster
function androidrun(){ ant clean debug adb shell am start -n $1/$1.MainActivity }
and its usageandroidrun com.example.test
Feb 16, 2013 at 12:43 -
3
adb shell am
will give you a list of other options to pass to theam
command. You can find out more at developer.android.com/tools/help/adb.html#am May 14, 2013 at 23:17 -
1
-
33is is possible to run the default activity, instead of being so specific to which activity i intend it should start? Jul 25, 2013 at 8:23
-
3I had problems finding the application and activity. I used this pipe line
adb logcat | grep --line-buffered ActivityManager | grep --line-buffered
to list all applications that were displayed.– Att RighMar 10, 2017 at 20:07
It's possible to run an application specifying the package name only using the monkey tool by follow this pattern:
adb shell monkey -p your.app.package.name -c android.intent.category.LAUNCHER 1
The command is used to run the app using the monkey tool which generates random input for the application. The last part of the command is an integer which specifies the number of generated random input for the app. In this case the number is 1, which in fact is used to launch the app (icon click).
-
143Launcher is default. You can simplify to
adb shell monkey -p your.app.package.name 1
Oct 28, 2015 at 16:06 -
3Is it possible to use the APK file name, instead of the package name? Suppose I have an APK file, and I want to be able to install&run it, is it possible? Jun 15, 2016 at 7:42
-
3
-
3@IgorGanapolsky if no activities found, it's a Service app and has no Activity at all.– m3ndaSep 6, 2016 at 8:42
-
1@IgorGanapolsky if it is a service use
adb shell am startservice com.some.package.name/.YourServiceSubClassName
see here: stackoverflow.com/a/18703083/211292– ThomasWMar 25, 2019 at 5:52
Or, you could use this:
adb shell am start -n com.package.name/.ActivityName
-
87is it possible to do it without specifying the activity name, so that the default main activity will start? May 16, 2013 at 11:13
-
6@androiddeveloper See the monkey command below from depodefi: no need to specify activity name! Feb 28, 2015 at 8:17
-
14
-
2Run ~/android-sdk-linux/build-tools/20.0.0/aapt dump badging yourapp.apk , which will list the following entry: launchable-activity: name='com.company.android.package.YourLaunchableActivity'– JohnyTexSep 16, 2016 at 9:59
-
23
Linux and Mac users can also create a script to run an APK file with something like the following:
Create a file named "adb-run.sh" with these three lines:
pkg=$(aapt dump badging $1|awk -F" " '/package/ {print $2}'|awk -F"'" '/name=/ {print $2}')
act=$(aapt dump badging $1|awk -F" " '/launchable-activity/ {print $2}'|awk -F"'" '/name=/ {print $2}')
adb shell am start -n $pkg/$act
Then "chmod +x adb-run.sh" to make it executable.
Now you can simply:
adb-run.sh myapp.apk
The benefit here is that you don't need to know the package name or launchable activity name. Similarly, you can create "adb-uninstall.sh myapp.apk"
Note: This requires that you have Android Asset Packaging Tool (aapt
) in your path. You can find it under the new build tools folder in the SDK.
-
-
3Your post made me look up AWK. I went ahead and re-created your script. pastebin.com/X7X1SsFa– KyleDec 6, 2013 at 16:20
-
2This is fabulous. Why this isn't a standard adb command we'll never know. Jun 8, 2014 at 7:51
-
You won't need to have aapt in your path (as long as "android" is) if you set the PATH in the adb-run.sh script, like this: PATH=$(dirname $(which android))/../build-tools/20.0.0:$PATH Oct 23, 2014 at 20:16
-
@dljava why does this not work on play.google.com/store/apps/details?id=com.amaze.filemanager ?– WSSApr 18, 2018 at 19:53
Step 1: First get all the package names of the apps installed in your device, by using:
adb shell pm list packages
Step 2: You will get all the package names. Copy the one you want to start using ADB.
Step 3: Add your desired package name in the below command.
adb shell monkey -p 'your package name' -v 500
For example,
adb shell monkey -p com.estrongs.android.pop -v 500
to start the Es explorer.
-
24This will launch your application and send 500 pseudo-random events to it. So use '1' to replace '500' is better.– LynDec 26, 2018 at 7:11
-
What is "Es explorer"? For example, can you add a reference to it? (But without "Edit:", "Update:", or similar - the answer should appear as if it was written today.) Nov 8, 2021 at 14:04
The shortest command yet is the following:
adb shell monkey -p your.app.package.name 1
This will launch the default activity for the package that is in the launcher.
Thanks to Androiderson for the tip.
Also, I want to mention one more thing.
When you start an application from adb shell am
, it automatically adds FLAG_ACTIVITY_NEW_TASK flag which makes behavior change. See the code.
For example, if you launch a Play Store activity from adb shell am
, pressing the 'Back' button (hardware back button) wouldn't take you back to your app. Instead, it would take you to the previous Play Store activity if there was some (if there was not a Play store task, then it would take you back to your app). FLAG_ACTIVITY_NEW_TASK documentation says:
if a task is already running for the activity you are now starting, then a new activity will not be started; instead, the current task will simply be brought to the front of the screen with the state it was last in
This caused me to spend a few hours to find out what went wrong.
So, keep in mind that adb shell am
add FLAG_ACTIVITY_NEW_TASK flag.
-
1Also, worth mentioning that that there is no way to clear said flag, which is annoying Jul 17, 2019 at 21:26
-
-
1What do you mean by "take you your app" (seems incomprehensible. Two instances)? Please respond by editing (changing) your answer, not here in comments (without "Edit:", "Update:", or similar - the answer should appear as if it was written today). Nov 8, 2021 at 13:42
We can as well start an application by knowing the application type and feeding it with data:
adb shell am start -d "file:///sdcard/sample.3gp" -t "video/3gp" -a android.intent.action.VIEW
This command displays available *video players to play a sample.3gp file.
You can find your app package name by the below command:
adb shell pm list packages
The above command returns a package list of all apps. Example:
org.linphone.debug
.
.
com.android.email
Now I want to start app linphone by using the below command and this worked for me:
adb shell am start org.linphone.debug
-
2Hmm, didn't work on Android 4.4. 1. the package names are all prefixed with
package:
(e.g.package:com.cnn.mobile.android.phone
). 2. When trying to launch (with or without thepackage:
prefix), I getStarting: Intent { act=android.intent.action.MAIN cat=[android.intent.category.LAUNCHER] pkg=com.cnn.mobile.android.phone } Error: Activity not started, unable to resolve Intent { act=android.intent.action.MAIN cat=[android.intent.category.LAUNCHER] flg=0x10000000 pkg=com.cnn.mobile.android.phone }
. Oct 20, 2021 at 14:45
Open file ~/.bash_profile, and add these Bash functions to the end of the file
function androidinstall(){
adb install -r ./bin/$1.apk
}
function androidrun(){
ant clean debug
adb shell am start -n $1/$1.$2
}
Then open the Android project folder:
androidinstall app-debug && androidrun com.example.app MainActivity
-
2
-
3@TrevorSenior app-debug is the title of the apk file , usually in debug mode the generated apk file is titled "APPLICATION NAME-debug.apk" Mar 10, 2013 at 15:40
monkey --pct-syskeys 0
for development boards
This argument is needed for development boards without keys/display:
adb shell monkey --pct-syskeys 0 -p com.cirosantilli.android_cheat.textviewbold 1
Without it, the app won't open, and you will get an error message like:
SYS_KEYS has no physical keys but with factor 2.0%
It was tested on HiKey960, Android O AOSP.
Learned from: this GitHub issue
Also asked at: How to use the monkey command with an Android system that doesn't have physical keys?
Use:
adb shell am start -n '<appPackageName>/<appActitivityName>'
To get <appPackageName>
run :
adb shell pm list packages
To get <appActitivityName>
lunch app and run
adb shell dumpsys window | grep -E 'mCurrentFocus'
Use:
adb shell am start -n '<appPackageName>/.<appActitivityName>
Example:
adb shell am start -n 'com.android.settings/.wifi.WifiStatusTest'
You can use the APK-INFO application to know the list of app activities with respect to each app package.
-
2
-
What is "APK-INFO"? For example, can you add a reference to it? (But without "Edit:", "Update:", or similar - the answer should appear as if it was written today.) Nov 8, 2021 at 14:00
adb shell am start -n com.app.package.name/com.java.package.name.ActivityName
Example
adb shell am start -n com.google.android.googlequicksearchbox/com.google.android.search.core.google.GoogleSearch
If the Java package is the same, then it can be shortened:
adb shell am start -n com.example.package/.subpackage.ActivityName
The right way would be to use cmd package resolve-activity
to find the startup activity before launching, so you can launch with
am start $(cmd package resolve-activity --brief com.package.name | tail -n 1)
Try this, for opening an Android photo app and with the specific image file to open as a parameter.
adb shell am start -n com.google.android.apps.photos/.home.HomeActivity -d file:///mnt/user/0/primary/Pictures/Screenshots/Screenshot.png
It will work on latest version of Android. No pop up will come to select an application to open as you are giving the specific app to which you want to open your image with.
-
I have a player app, which is able to stream a video from url, how can i pass this url as a parameter and stream from that url? suppose a url from youtube?– VishnuFeb 6, 2018 at 12:13
When you try to open a Flutter app, you can use this command:
adb shell am start -n com.package.name/io.flutter.embedding.android.FlutterActivity
Replace com.package.name
with your package name. You find your package in your app/build.gradle
at applicationId
.
To guarantee support for Android TV as well as non-Android TV apps:
adb shell "monkey -p com.package.name -c android.intent.category.LEANBACK_LAUNCHER 1 || monkey -p com.package.name -c android.intent.category.LAUNCHER 1"