Controller

The appman-controller is a command-line utility that can be used by the developer, or indirectly by other tools, on the target device to control the application manager without communicating directly with its D-Bus interface.

Note: In order to use this tool, the application manager has to be connected to either a session- or system-bus; don't run it with --dbus none.

The following commands are available:

CommandArgumentsDescription
start-application<application-id>

[document-url] [optional]

Starts the application with application-id within the application manager.
debug-application<debug-wrapper-specification>

<application-id>

[document-url] [optional]

Starts the application with application-id within the application manager using a debug-wrapper. For more information, see DebugWrappers.
stop-application<application-id>Stops the application with application-id.
stop-all-applications(none)Stops all applications that are running within the application manager.
list-applications(none)Outputs all available application IDs on the console, one per line.
show-application<application-id>Shows the current metadata for the given application in YAML format. Alternatively, use --json to get the metadata in JSON format instead.
list-packages(none)Outputs all available package IDs on the console, one per line.
show-package<package-id>Shows the current metadata for the given package in YAML format. Alternatively, use --json to get the metadata in JSON format instead.
install-package<package>Installs the package given on the command-line. If the package file is specified as -, the tool tries to read the package from stdin. The following options are supported:

-a, --acknowledge: Automatically acknowledge the installation, instead of relying on the System UI's logic.

remove-package<package-id>Removes the package, specified with package-id. The following options are supported:

-f, --force: Force removal of package.

-k, --keep-documents: Keep the document folder of the package.

list-installation-locations(none)Lists all installaton locations.
show-installation-location<installation-location>Shows details for the specified installation-location in YAML format. Alternatively, use --json to get the location details in JSON format instead.

The appman-controller naturally supports the standard Unix --help command-line option.