Page tree
Skip to end of metadata
Go to start of metadata


The command allows you to launch applications in run time.





BundleId (iOS) / Application Activity (Android)stringThe app to be launched

true - instrumented

false - non-instrumented


true - will stop the app if it was already running
false - will not stop the app but will simply bring it forward

In Appium Grid, If user wants to launch with Instrument=true, he/she has to make sure that the context is set to instrumented first. There are 2 options to do that :- 

  1. Adding driver.context(“NATIVE_APP_INSTRUMENTED") command before launch command

  2. Using driver.setCapability(“appInstrumented”, “true”)

If user doesn't use any of the above mentioned option and launched with Instrument=trueappium grid will throw an error and launch will fail


Following the install command, you would want to launch the app anytime during the test. Note that the launch command complements the install command but does not rely on it. The launch command lets you launch any application given that you know the BundleId (iOS), or App Package and App Main Activity (Android).


Set Experitest Url

Please make sure you replace <EXPERITEST_URL> with appropriate URL in the code snippet below.

Usage of Launch Command
driver = new IOSDriver(new URL("<EXPERITEST_URL>"), dc);
seetest = new SeeTestClient(driver);


//your app sends a verification code to the user's phone. 
//You can launch the Native iOS SMS app to retrieve the code.
seetest.launch("", false, false);

See below for a full list of native iOS and Android apps:


List of iOS Native Bundle IDs
App Name	| Bundle ID
App Store	|
Calculator	|
Calendar	|
Camera		|
Clock		|
Compass		|
Contacts	|
FaceTime	|
Files 	    |
Find Friends|
Find iPhone	|
Health		|
Home		|
iBooks		|
iCloud Drive|
iTunes Store|
Mail		|
Maps		|
Messages	|
Music		|
News		|
Notes		|
Phone		|
Photos		|
Photo Booth |
Podcasts	|
Reminders	|
Safari		|
Settings	|
Stocks		|
Tips		|
TV			|
Videos		|
Voice Memos	|
Wallet		|
Watch		|
Weather		|


For Android it is a bit harder to get the full list and launching the app also requires the app activity. You can use APK Info app for that purpose.

  • No labels