应用程序接口 QML 类型

应用程序与应用程序管理器之间主要的接口。更多...

导入声明	import QtApplicationManager.Application 2.0

所有成员列表，包括继承的成员

属性

applicationId : string
applicationProperties : var
icon : url
name : var
systemProperties : var
version : string

信号

memoryCriticalWarning()
memoryLowWarning()
openDocument(string documentUrl, string mimeType)
quit()

方法

acknowledgeQuit()
Notification createNotification()

详细描述

此项目适用于使用根上下文属性 ApplicationInterface 的 QML 应用程序。对于其他原生应用程序，相同的接口（不包括通知功能）可在私有的点对点 D-Bus 接口上使用。

对于在多进程模式下启动的每个应用程序，应用程序管理器都会创建一个私有的点对点 D-Bus 连接，并将连接地址作为环境变量 AM_CONFIG 中的 YAML 碎片的一部分传递给应用程序的进程。只有应用程序自己可以连接到此 P2P D-Bus - 该总线不需要进一步访问策略。

使用此连接，您将能够访问不同的接口（注意，由于这不是一个总线，所以服务名称始终为空字符串）

路径名称	描述
/ApplicationInterface io.qt.ApplicationManager.ApplicationInterface	在 D-Bus 形式下的此接口正好。定义在源分发中的 `src/dbus/io.qt.applicationmanager.applicationinterface.xml`
/RuntimeInterface io.qt.ApplicationManager.RuntimeInterface	应用程序管理器与启动进程之间的直接接口，用于实现自定义启动器：定义在源分发中的 `src/dbus/io.qt.applicationmanager.runtimeinterface.xml`

如果您正在重新实现客户端，请注意，在连接后无法立即访问远程接口：只有在客户端连接之后才在服务器端注册。这是D-Bus设计的局限性 - 默认实现会在抛出错误之前尝试连接100毫秒。

属性文档

applicationId : 字符串 [只读]

您应用程序的应用程序ID。

applicationProperties : var [只读]

返回一个对象，其中包含在应用程序的manifest文件（info.yaml）中applicationProperties字段下已列出的属性。

icon : url [只读]

在manifest中给出的应用程序图标的URL。这可以用作Image的源属性。

name : var [只读]

一个包含语言（字符串）到应用程序名称（字符串）映射的对象。参见manifest（info.yaml）定义中的name。

systemProperties : var [只读]

返回通过配置文件设置的特定于项目的系统属性。

version : 字符串 [只读]

在manifest中指定的应用程序版本。

信号文档

memoryCriticalWarning()

每当系统相关空闲内存阈值被越过时，此信号将被发出。它通常在memoryLowWarninig之后发送，应被视为紧急释放尽可能多的资源以保持系统稳定的最后通知。

注意：相应的处理程序是onMemoryCriticalWarning。

另请参阅：memoryLowWarning。

memoryLowWarning()

每当系统相关空闲内存阈值被越过时，此信号将被发出。在这种情况下，您的应用程序应尽可能多地释放资源：这可能涉及清除内部缓存。

注意：相应的处理程序是onMemoryLowWarning。

另请参阅：memoryCriticalWarning。

openDocument(string documentUrl, string mimeType)

每当一个已经运行的应用程序再次带参数启动时，已运行的实例只会接收到这个信号，而不是启动一个独立的应用程序实例。该函数接收到的documentUrl参数可以是ApplicationManager::startApplication的documentUrl参数，在没有documentUrl参数调用ApplicationManager::startApplication时manifest的documentUrl字段或您的应用程序匹配MIME类型请求时Qt::openUrlExternally的target参数。在后一种情况下，mimeType包含应用程序管理器检测到的MIME类型。

注意：相应的处理程序是onOpenDocument。

quit()

应用程序管理器将发送此信号至应用程序，请求执行可控关闭。应用程序将获得配置中定义的一段时间（quitTime）。如果在调用acknowledgeQuit()之前时间已过，应用程序将直接被终止。

注意：从版本6.6开始，如果不明确连接到此信号，acknowledgeQuit() 将会自动被调用。

注意：相应的处理函数是 onQuit。

另请参阅：acknowledgeQuit()。

方法文档

acknowledgeQuit()

应在应用程序准备终止时（例如已写入持久数据）响应quit() 信号调用此方法。

注意：应调用此方法而不是 Qt.quit() 以在单进程和多进程模式下获得相同的行为（在单进程模式下不起作用）。

另请参阅：quit()。

Notification createNotification()

调用此函数允许您在运行时动态创建Notification 对象。