ApplicationInterface QML Type
The main interface between apps and the application-manager. More...
|Import Statement:||import QtApplicationManager.Application 2.0|
- applicationId : string
- applicationProperties : var
- icon : url
- name : var
- systemProperties : var
- version : string
This item is available for QML applications using the root context property
ApplicationInterface. For other native applications, the same interface - minus the notification functionality - is available on a private peer-to-peer D-Bus interface.
For every application that is started in multi-process mode, the application-manager creates a private P2P D-Bus connection and communicates the connection address to the application's process via the environment variable
AM_DBUS_PEER_ADDRESS. Only the application itself is able to connect to this P2P D-Bus - no further access policies are required on this bus.
Using this connection, you will have access to different interfaces (note that due to this not being a bus, the service name is always an empty string):
|Exactly this interface in D-Bus form. The definition is in the source distribution at |
|The direct interface between the application-manager and the launcher process, used to implement custom launchers: the definition is in the source distribution at |
|Any IPC interface registered via the ApplicationIPCManager (and matching the corresponding filter), will be exported on this P2P connection. The path name is constructed from the interface name by replacing every character that is not alpha-numeric with an underscore (|
If you are re-implementing the client side, note that the remote interfaces are not available immediately after connecting: they are registered on the server side only after the client connects. This is a limitation of the D-Bus design - the default implementation attempts to connect for 100ms before throwing an error.
[read-only] applicationId : string
The application id of your application.
[read-only] applicationProperties : var
Returns an object with properties that have been listed under the
applicationProperties field in the manifest file (info.yaml) of the application.
[read-only] icon : url
The URL of the application's icon as given in the manifest. This can be used as the source property of an Image.
[read-only] name : var
An object containing language (
string) to application name (
string) mapppings. See name in the manifest (info.yaml) definition.
[read-only] systemProperties : var
Returns the project specific system properties that were set via the config file.
[read-only] version : string
The version of the application as specified in the manifest.
This signal will be sent out whenever a system dependent free-memory threshold has been crossed. It is usually sent after a
memoryLowWarninig and should be perceived as a last notice to urgently free as many resources as possible to keep the system stable.
See also memoryLowWarning().
This signal will be sent out whenever a system dependent free-memory threshold has been crossed. Your application is expected to free up as many resources as possible in this case: this will most likely involve clearing internal caches.
See also memoryCriticalWarning().
openDocument(documentUrl, string mimeType)
Whenever an already running application is started again with an argument, the already running instance will just receive this signal, instead of starting a separate application instance. The documentUrl parameter received by this function can either be the
documentUrl argument of ApplicationManager::startApplication, the
documentUrl field of the info.yaml manifest when calling ApplicationManager::startApplication without a
documentUrl argument or the
target argument of Qt::openUrlExternally, when your application matches a MIME-type request. In the latter case mimeType contains the MIME-type detected by the ApplicationManager.
The application-manager will send out this signal to an application to request a controlled shutdown. The application is given a certain amount of time defined in the configuration (
quitTime). If the time elapses before acknowledgeQuit() is called, the application will simply be killed.
See also acknowledgeQuit().
This method should be called in response to the quit() signal, once the application is ready to be terminated (e.g. persistent data has been written).
Note: This method should be called instead of
Qt.quit() to obtain the same behavior in single- and multi-process mode (it does nothing in single process mode).
See also quit().
Calling this function lets you create a Notification object dynamically at runtime.
© 2019 Luxoft Sweden AB. 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.