說明
使用 chrome.app.runtime
API 管理應用程式生命週期。應用程式執行階段會管理應用程式安裝作業、控制活動頁面,並可隨時關閉應用程式。
類型
EmbedRequest
屬性
-
資料
任何選填
開發人員指定的選用資料,可供要嵌入的應用程式在做出嵌入決策時使用。
-
embedderId
字串
-
allow
void
允許
embedderId
將這個應用程式嵌入 <appview> 元素中。url
會指定要嵌入的內容。allow
函式如下所示:(url: string) => {...}
-
網址
字串
-
-
deny
void
防止
embedderId
將這個應用程式嵌入 <appview> 元素中。deny
函式如下所示:() => {...}
LaunchData
屬性
-
id
string 選填
應用程式用來叫用檔案或網址處理常式的 ID。處理程序 ID 是資訊清單中
file_handlers
和/或url_handlers
字典中的頂層鍵。 -
isKioskSession
boolean 選填
應用程式是否在 Chrome OS 資訊站工作階段中啟動。
-
isPublicSession
boolean 選填
Chrome 47 以上版本應用程式是否在 ChromeOS 公開工作階段中啟動。
-
項目
LaunchItem[] 選填
file_handlers
資訊清單鍵中,由相符的檔案處理常式觸發的onLaunched
事件檔案項目。 -
referrerUrl
string 選填
url_handlers
資訊清單鍵中,由相符的網址處理常式觸發的onLaunched
事件參照網址。 -
來源
LaunchSource 選填
應用程式啟動來源。
-
網址
string 選填
url_handlers
資訊清單鍵中,由相符的網址處理常式觸發的onLaunched
事件網址。
LaunchItem
屬性
-
項目
項目
項目的項目。
-
類型
string 選填
檔案的 MIME 類型。
LaunchSource
列舉應用程式啟動來源。這項屬性應與 components/services/app_service/public/mojom/types.mojom 中的 AppLaunchSource 保持同步,並與 extensions/browser/api/app_runtime/app_runtime_api.cc 中的 GetLaunchSourceEnum() 保持同步。請注意,此列舉會用於 UMA 直方圖,因此不應重新排序或移除項目。
列舉
"untracked"
"app_launcher"
"new_tab_page"
"reload"
"restart"
"load_and_launch"
"command_line"
"file_handler"
"url_handler"
"system_tray"
"about_page"
"keyboard"
"extensions_page"
"management_api"
"ephemeral_app"
"background"
"kiosk"
"chrome_internal"
"test"
"installed_notification"
"context_menu"
"arc"
"intent_url"
"app_home_page"
"focus_mode"
"sparky"
活動
onEmbedRequested
chrome.app.runtime.onEmbedRequested.addListener(
callback: function,
)
當嵌入應用程式要求嵌入此應用程式時觸發。此事件僅適用於使用 --enable-app-view 標記的開發人員管道。
參數
-
callback
函式
callback
參數如下所示:(request: EmbedRequest) => void
-
申請。
-
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