The Control Apps app tool is used to control and obtain info about apps installed on the target device.

Usage

app start <appName> [<options>] app stop <appName> app restart <appName> app remove <appName> app list app status [<appName>] app version <appName> app info [<appName>] app runProc <appName> <procName> [options] app runProc <appName> [<procName>] --exe=<exePath> [options] app --help

app start <appName> [<options>]

Runs an app in a modified manner by one or more of the following options:

--norun=<procName1>[,<procName2>,...]
Don't start the specified configured processes. Names are separated by commas without spaces.

app stop <appName>

Stops the specified app.

app restart <appName>

Restarts the specified app.

app remove <appName>

Removes the specified app.
Warning
Be careful not to accidentally remove system services apps that you might need (e.g., modemService app).

app list

List all installed apps.

app status [<appName>]

If an appName is specified, provides status on that app. If no app is specified, provides status on all installed apps. Status can be stopped, running, paused or not installed.

app version <appName>

Provides the version of the specified app.

app info <appName>

If an appName is specified, provides info on that app. If no app is specified, provides info on all installed apps.

app runProc <appName> <procName> [options]

Runs a configured process inside an app using the process settings from the configuration database. If an exePath is provided as an option, the specified executable is used instead of the configured executable.

app runProc <appName> [<procName>] --exe=<exePath> [options]

Runs an executable inside an app. The exePath must be provided, and the optional process name must not match any configured processes for the app.

Unless specified through the options below, the executable will be run with default settings:

--exe=<exePath>
Use the executable at <exePath>. <exePath> is from the perspective of the app (e.g., /exe would be at the sandbox root if the app is sandboxed).

--priority=<priorityStr>
Sets the priority of the process. <priorityStr> can be either idle, low, medium, high, rt1, rt2, ... rt32.

--faultAction=<action>
Sets the fault action for the process. <action> can be either 'ignore', 'restartProc', 'restartApp', 'stopApp'.

--[<args> ...]
Specifies command line arguments to the process. Everything following the -- option is taken as arguments for process to be started. The -- option must be the last option to app runProc. If the -- option is not used, then the configured arguments are used (if available).

app --help

Prints help text to standard out and exits.