说明
使用 chrome.app.runtime
API 管理应用生命周期。应用运行时可管理应用安装、控制事件页面,并可以随时关闭应用。
类型
ActionData
属性
-
actionType
"new_note"
ActionType
应用在启动时可以执行特定的操作,例如创建新记事。LaunchData 实例的 actionData
字段内提供了用于启动应用的操作类型。
值
"new_note"
EmbedRequest
属性
-
data
任意(可选)
(可选)开发者在决定嵌入时指定了要嵌入的应用可以使用的数据。
-
embedderId
string
-
allow
void
允许
embedderId
在 <appview> 元素中嵌入此应用。url
指定要嵌入的内容。allow
函数如下所示:(url: string)=> {...}
-
网址
string
-
-
deny
void
阻止
embedderId
将此应用嵌入到 <appview> 元素中。deny
函数如下所示:()=> {...}
LaunchData
属性
-
actionData
ActionData(可选)
Chrome 54 及更高版本包含的数据用于指定启动此应用时所用的
ActionType
。如果应用不是通过特定操作 intent 启动的,则此值为 null。 -
id
字符串(可选)
调用应用程序时所用的文件或网址处理程序的 ID。处理程序 ID 是清单的
file_handlers
和/或url_handlers
字典中的顶级键。 -
isKioskSession
布尔值 选填
应用是否在 Chrome 操作系统自助服务终端会话中启动。
-
isPublicSession
布尔值 选填
Chrome 47 及更高版本应用是否在 Chrome 操作系统公用自助终端中启动。
-
items
LaunchItem[] 可选
由
file_handlers
清单键中的匹配文件处理程序触发的onLaunched
事件的文件条目。 -
referrerUrl
字符串(可选)
由
url_handlers
清单键中的匹配网址处理程序触发的onLaunched
事件的引荐来源网址。 -
source
LaunchSource 可选
应用的启动位置。
-
网址
字符串(可选)
由
url_handlers
清单键中的匹配网址处理程序触发的onLaunched
事件的网址。
LaunchItem
属性
-
入口
条目
条目的条目。
-
类型
字符串(可选)
文件的 MIME 类型。
LaunchSource
枚举应用启动来源。这些信息应与 components/services/app_service/public/mojom/types.mojom 中的 AppLaunchSource 以及 extensions/browser/api/app_runtime/app_runtime_api.cc 中的 GetLaunchSourceEnum() 保持同步。请注意,枚举用于 UMA 直方图,因此不应对条目进行重新排序或移除。
枚举
"app_launcher"
"new_tab_page"
"load_and_launch"
"command_line"
"file_handler"
"url_handler"
"system_tray"
"about_page"
"extensions_page"
"management_api"
"background"
"chrome_internal"
"test"
"installed_notification"
"context_menu"
"arc"
"intent_url"
"app_home_page"
活动
onEmbedRequested
chrome.app.runtime.onEmbedRequested.addListener(
callback: function,
)
嵌入应用请求嵌入此应用时触发。此事件仅在开发者渠道上具有 --enable-app-view 标记可用。
参数
-
callback
功能
callback
参数如下所示:(request: EmbedRequest)=>void
-
request
-
onLaunched
chrome.app.runtime.onLaunched.addListener(
callback: function,
)
当应用从启动器启动时触发。
参数
-
callback
功能
callback
参数如下所示:(launchData?: LaunchData)=>void
-
launchData
LaunchData 可选
-
onRestarted
chrome.app.runtime.onRestarted.addListener(
callback: function,
)
对于在 Chrome 上次关闭时正在运行的应用,或由于其他原因(例如,当用户撤消了对应用所保留文件的访问权限,运行时将会重启应用)时,在 Chrome 启动时将触发该事件。在这些情况下,如果应用没有 onRestarted
处理程序,则系统会改为向它们发送 onLaunched
事件。
参数
-
callback
功能
callback
参数如下所示:()=>void