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 directly talking to its D-Bus interface.

The following commands are available:

CommandArgumentsDescription
start-application<application-id>

[document-url]

Starts the application identified by application-id within the application-manager. The document-url parameter is optional.
debug-application<debug-wrapper-specification>

<application-id>

[document-url]

Starts the application identified by application-id within the application-manager using a debug-wrapper: see the debugging documentation for more information on this specification string. The document-url parameter is optional.
stop-application<application-id>Stops the application identified by 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 meta-data of the given application in YAML format. The following options are supported:

--json: Output in JSON format instead of YAML.

install-package<package>Installs the package given on the command-line. If the package file is specified as -, the tool will try to read the package from stdin. The following options are supported:

-l, --location: Install to a specific installation location (see show-installation-location).

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

remove-package<application-id>Removes the package that previously installed the application specified with application-id. The following options are supported:

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

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

list-installation-locations(none)Lists all installaton locations.
show-installation-location<installation-location>Shows details for installation location specified with installation-location in YAML format. The following options are supported:

--json: Output in JSON format instead of YAML.

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

© 2018 Pelagicore AG. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.