Skip to main content

launch

This tool on every surface: CLI · MCP · Python · JavaScript · Go · Java · .NET

Bring an app to the foreground, starting it if it is not running. These call app_launch.

launch​

launch(app: string, options?: { hitTest?: boolean; grayBox?: boolean }): Promise<void>

Examples​

Bring an app to the front​

await device.launch('com.android.settings')

The same call from the command line, mobium launch com.android.settings, printed on an Android 15 emulator:

launched com.android.settings

mobium launch com.android.settings on an Android 15 emulator

mobium launch com.android.settings on an Android 15 emulator

Launch an app with the gray box on, so every action waits for it to be idle​

await device.launch('dev.mobium.mobiumapp', { grayBox: true })

The same call from the command line, mobium launch --gray-box dev.mobium.mobiumapp, printed on an Android 15 emulator:

launched dev.mobium.mobiumapp, with the gray box: every action waits for the app to say it is idle