An interface that allows to implement custom startup activities. More...
|virtual void||afterQmlEngineLoad(QQmlEngine *engine) = 0|
|virtual void||afterRuntimeRegistration() = 0|
|virtual void||afterWindowShow(QWindow *window) = 0|
|virtual void||beforeQmlEngineLoad(QQmlEngine *engine) = 0|
|virtual void||beforeWindowShow(QWindow *window) = 0|
|virtual void||initialize(const QVariantMap &systemProperties) = 0|
This interface provides hooks that are called during the startup of application manager processes. Hence, implementers of the interface can run their custom code at certain points during the startup phase.
A plugin has to implemet the pure virtual functions of the StartupInterface. The interface is the same for the System UI (appman), as well as for QML applications (appman-launcher-qml). The plugins that should be loaded have to be specified in the (am-config.yaml) configuration file. The following snippet shows how the application manager can be configured to load and execute the
libappmanplugin.so in both the System UI and applications and additionally the
libextplugin.so in the System UI only:
# System UI plugins: startup: [ "path/to/libappmanplugin.so", "path/to/libextplugin.so" ] # Applications runtimes: qml: plugins: startup: "path/to/libappmanplugin.so"
The functions are called in the following order:
Member Function Documentation
Destroys the instance of StartupInterface. The destructor is virtual.
[pure virtual] void StartupInterface::afterQmlEngineLoad(QQmlEngine *engine)
This method is called, after the QML engine has been loaded.
This method is called, right after the runtime has been registered.
Note: It will only be called in the System UI process.
This method is called, right after the main window is shown. The window parameter holds a pointer to the just shown main window.
[pure virtual] void StartupInterface::beforeQmlEngineLoad(QQmlEngine *engine)
This method is called, before the QML engine is loaded.
QtApplicationManager* QML namespaces are locked for new registrations via qmlProtectModule() after this call.
This method is called, after the main window has been instantiated, but before it is shown. The window parameter holds a pointer to the main window.
This method is called right after the systemProperties have been parsed.
© 2022 The Qt Company Ltd. 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.