Click or drag to resize
Ranorex

HostRunMobileApp Method (String, String, Boolean)

Starts an app on a mobile device. This operation only works for devices that were configured trough the Ranorex user interface. This operation also works when the app is running on the device already. In that case the running app will either be closed and started again to reset it into the initial state or only brought to the foreground depending on the 'resetInitialState' parameter. Only apps that were instrumented by the Ranorex system can be started by Ranorex.

Namespace:  Ranorex
Assembly:  Ranorex.Core (in Ranorex.Core.dll) Version: 12.7.4-git.38314c06
Syntax
Copy
public void RunMobileApp(
	string deviceDisplayName,
	string appName,
	bool resetInitialState
)

Parameters

deviceDisplayName
Type: SystemString
The name you configured for your device. If no device with that name exists or is not connected (that means Ranorex isn't able to communicate with the corresponding device) the operation will fail.
appName
Type: SystemString
The app that shall be started. This has to be the unique application identifier. E.g. for android devices such an app identifier looks like 'ranorex.android.DemoGui'.
resetInitialState
Type: SystemBoolean
Indicates if the app should be restarted on launch or just brought to the foreground in case the app is already running.
Exceptions
ExceptionCondition
ArgumentException If deviceDisplayName or appName is null or empty.
See Also