ApplicationInterface 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()
通知 createNotification()

详细说明

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

对于以多进程模式启动的每个应用程序，应用程序管理器创建一个私有 P2P 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`
/ExtensionInterfaces/<ext_name> <ext.name>	通过ApplicationIPCManager（并匹配相应的过滤器）注册的任何 IPC 接口都将在此 P2P 连接上导出。路径名称是通过将接口名称中的每个非字母数字字符替换为下划线（`_`）来构造的。

如果您正在重实现客户端，请注意，在连接后不久远程接口不可用：它们只在客户端连接到服务器后才注册。这是 D-Bus 设计的限制 - 默认实现尝试连接 100 毫秒后抛出错误。

属性文档

[只读] applicationId : string

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

[只读] applicationProperties : var

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

[只读] icon : url

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

[只读] name : var

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

[只读] systemProperties : var

返回在配置文件中设置的项目特定系统属性。

[只读] version : string

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

信号文档

memoryCriticalWarning()

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

注意： 相应的处理器是onMemoryCriticalWarning。

另请参阅 memoryLowWarning()。

memoryLowWarning()

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

注意： 相应的处理器是onMemoryLowWarning。

另请参阅 memoryCriticalWarning()。

openDocument(string documentUrl, string mimeType)

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

注意： 相应的处理器是onOpenDocument。

quit()

应用程序管理器将发送此信号到应用程序以请求受控关闭。应用程序将根据配置（quitTime）中定义的一定时间。如果在调用acknowledgeQuit()之前时间已过，应用程序将被直接杀死。

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

另请参阅acknowledgeQuit()。

方法文档

acknowledgeQuit()

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

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

另请参阅quit()。

Notification createNotification()

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