Skip to main content

Launch · LaunchWithHitTest · LaunchWithGrayBox

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​

public void Launch(string app)

Brings an app to the foreground by package name or bundle id, and waits for it to actually be in front. Discards every ref from the previous screen.

LaunchWithHitTest​

public void LaunchWithHitTest(string app)

Launches an app on an iOS simulator with the hit probe loaded in it: every action on an element in it then asks UIKit where the touch goes first, and is refused when it would land elsewhere — an overlay hidden from accessibility included. A real iPhone and Android refuse.

LaunchWithGrayBox​

public void LaunchWithGrayBox(string app)

Launches an app with Mobium's gray-box library turned on: the app says when it is busy, and every action waits for it to be idle before finding its target. It needs an app built with the library.

Examples​

Bring an app to the front​

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​

device.LaunchWithGrayBox("dev.mobium.mobiumapp");

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