Android launch App
android_launch_appLaunch an installed Android app by exact package name or partial name fragment. Resolves the launcher activity automatically, eliminating the need for shell commands.
Instructions
Launch an already-installed app by resolving its LAUNCHER activity (monkey -p <pkg> -c android.intent.category.LAUNCHER 1) — no shell needed. Pass EITHER packageName OR name (exactly one): name is a case-insensitive fragment of the package name, resolved against the same listing android_list_apps returns, so several matches come back as a candidate list rather than a guess. Package names of third-party apps CANNOT be guessed; run android_list_apps first when unsure. Use this to OPEN an app; android_build_run is for building and installing one from source. Stable AOSP/GMS packages: Settings com.android.settings, Chrome com.android.chrome, Clock com.google.android.deskclock, Calendar com.google.android.calendar, Camera com.android.camera2, Files com.google.android.documentsui, Play Store com.android.vending.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "android_launch_app"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | No | Package-name fragment of an installed app, e.g. "settings" or "chrome" (case-insensitive). Resolves to exactly one package — several matches come back as a candidate list to choose from. | |
| device | No | Target adb serial. Defaults to the streamed device, else the only online one. | |
| relaunch | No | Force-stop a running instance first so the app starts from its launch screen (default false: a running app is simply brought to the foreground). | |
| packageName | No | Exact package of the installed app, e.g. "com.android.settings". Required unless name is given; passing both is an error. |