Beschreibung
Verwenden Sie die chrome.app.runtime
API, um den App-Lebenszyklus zu verwalten. Die App-Laufzeit verwaltet die App-Installation, steuert die Ereignisseite und kann die App jederzeit beenden.
Typen
ActionData
Attribute
-
actionType
"new_note"
ActionType
Eine App kann mit einer bestimmten Aktion gestartet werden, z. B. um eine neue Notiz zu erstellen. Der Aktionstyp, mit dem die App gestartet wurde, ist im Feld actionData
der LaunchData-Instanz verfügbar.
Wert
"new_note"
EmbedRequest
Attribute
-
daten
Beliebig optional
Optionale, vom Entwickler angegebene Daten, die die einzubettende App für eine Entscheidung über die Einbettung verwenden kann.
-
embedderId
String
-
allow
void
Ermöglicht
embedderId
, diese App in ein <appview>-Element einzubetten. Derurl
gibt den einzubettenden Inhalt an.Die Funktion
allow
sieht so aus:(url: string)=> {...}
-
url
String
-
-
deny
void
Verhindert, dass
embedderId
diese App in ein <appview>-Element einbettet.Die Funktion
deny
sieht so aus:()=> {...}
LaunchData
Attribute
-
actionData
ActionData optional
Chrome 54 und höherEnthält Daten zur Angabe der
ActionType
, mit der diese App gestartet wurde. Dieser Wert ist null, wenn die App nicht mit einem bestimmten Aktionsabsicht gestartet wurde. -
id
String optional
Die ID der Datei oder des URL-Handlers, mit der bzw. dem die App aufgerufen wird. Handler-IDs sind die Schlüssel der obersten Ebene in den Wörterbüchern
file_handlers
und/oderurl_handlers
im Manifest. -
isKioskSession
Boolescher Wert optional
Gibt an, ob die App in einer ChromeOS-Kiosksitzung gestartet wird.
-
isPublicSession
Boolescher Wert optional
Chrome 47 und höherGibt an, ob die App in einer öffentlichen Chrome OS-Sitzung gestartet wird.
-
items
LaunchItem[] optional
Die Dateieinträge für das Ereignis
onLaunched
, die von einem übereinstimmenden Datei-Handler im Manifestschlüsselfile_handlers
ausgelöst wurden. -
referrerUrl
String optional
Die Verweis-URL für das Ereignis
onLaunched
, die von einem übereinstimmenden URL-Handler im Manifestschlüsselurl_handlers
ausgelöst wurde. -
source
LaunchSource optional
Der Ort, von dem aus die App gestartet wird.
-
url
String optional
Die URL für das
onLaunched
-Ereignis, die von einem übereinstimmenden URL-Handler im Manifestschlüsselurl_handlers
ausgelöst wurde.
LaunchItem
Attribute
-
Eintrag
Eintrag
Eintrag für das Element.
-
Typ
String optional
Der MIME-Typ der Datei.
LaunchSource
Aufzählung der Quellen für App-Starts. Dies sollte mit AppLaunchSource in Components/services/app_service/public/mojom/types.mojom und GetLaunchSourceEnum() in extensions/browser/api/app_runtime/app_runtime_api.cc synchronisiert bleiben. Beachten Sie, dass die Aufzählung im UMA-Histogramm verwendet wird, sodass Einträge nicht neu angeordnet oder entfernt werden sollten.
Enum
"new_tab_page"
"load_and_launch"
"command_line"
"file_handler"
"url_handler"
"system_tray"
"about_page"
"extensions_page"
"management_api"
"chrome_internal"
"installed_notification"
"context_menu"
"arc"
"intent_url"
"app_home_page"
"focus_mode"
Veranstaltungen
onEmbedRequested
chrome.app.runtime.onEmbedRequested.addListener(
callback: function,
)
Wird ausgelöst, wenn eine einbettende App das Einbetten dieser App anfordert. Dieses Ereignis ist nur im Entwicklerkanal mit der Markierung „--enable-app-view“ verfügbar.
Parameter
-
callback
Funktion
Der Parameter
callback
sieht so aus:(request: EmbedRequest)=>void
-
Request
-
onLaunched
chrome.app.runtime.onLaunched.addListener(
callback: function,
)
Wird ausgelöst, wenn eine App über den Launcher gestartet wird
Parameter
-
callback
Funktion
Der Parameter
callback
sieht so aus:(launchData?: LaunchData)=>void
-
launchData
LaunchData optional
-
onRestarted
chrome.app.runtime.onRestarted.addListener(
callback: function,
)
Wird beim Chrome-Start für Apps ausgelöst, die beim letzten Herunterfahren von Chrome ausgeführt wurden, oder wenn Apps aus anderen Gründen aus ihrem vorherigen Status neu gestartet wurden, z.B. wenn der Nutzer den Zugriff auf die beibehaltenen Dateien einer App widerruft und die Laufzeit die App neu startet. Wenn Apps keinen onRestarted
-Handler haben, wird in diesen Situationen stattdessen ein onLaunched
-Ereignis gesendet.
Parameter
-
callback
Funktion
Der Parameter
callback
sieht so aus:()=>void