chrome.app.runtime

Beschreibung

Verwende 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 herunterfahren.

Typen

ActionData

Chrome (ab Version 54)

Attribute

  • actionType

    "new_note"

ActionType

Chrome 54 und höher

Eine App kann für eine bestimmte Aktion gestartet werden, z. B. um eine neue Notiz zu erstellen. Die Art der Aktion, mit der die App gestartet wurde, ist im Feld actionData der LaunchData-Instanz verfügbar.

Wert

EmbedRequest

Attribute

  • Daten

    Alle optional

    Optionale vom Entwickler angegebene Daten, die die einzubettende App bei der Entscheidung zum Einbetten verwenden kann.

  • embedderId

    String

  • allow

    void

    Erlaubt embedderId, diese App in <appview> einzubetten -Elements. Mit der url wird der einzubettende Inhalt angegeben.

    Die Funktion allow sieht so aus: 

    (url: string) => {...}

    • URL

      String

  • deny

    voidm

    Verhindert, dass embedderId diese App in ein <appview>-Element einbettet.

    Die Funktion deny sieht so aus: 

    () => {...}

LaunchData

Attribute

  • actionData

    ActionData optional

    Chrome (ab Version 54)

    Enthält Daten, die die ActionType angeben, mit der diese App gestartet wurde. Dieser Wert ist null, wenn die App nicht mit einem bestimmten Aktions-Intent gestartet wurde.

  • id

    String optional

    Die ID der Datei oder des URL-Handlers, mit dem die App aufgerufen wird. Handler-IDs sind die Schlüssel der obersten Ebene in den Wörterbüchern file_handlers und/oder url_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öher

    Ob die App in einer öffentlichen Chrome OS-Sitzung gestartet wird.

  • Elemente

    LaunchItem[] optional

    Die Dateieinträge für das onLaunched-Ereignis, das von einem übereinstimmenden Datei-Handler im file_handlers-Manifestschlüssel ausgelöst wurde.

  • referrerUrl

    String optional

    Die Verweis-URL für das onLaunched-Ereignis, das von einem übereinstimmenden URL-Handler im url_handlers-Manifestschlüssel ausgelöst wird.

  • source

    LaunchSource optional

    Wo die App gestartet wird.

  • URL

    String optional

    Die URL für das onLaunched-Ereignis, das durch einen übereinstimmenden URL-Handler im Manifest-Schlüssel url_handlers ausgelöst wird.

LaunchItem

Attribute

  • Eintrag

    Eintrag

    Eintrag für den Artikel.

  • Typ

    String optional

    Der MIME-Typ der Datei.

LaunchSource

Liste der Quellen für App-Starts Dieser Wert muss mit „AppLaunchSource“ in „components/services/app_service/public/mojom/types.mojom“ und „GetLaunchSourceEnum()“ in „extensions/browser/api/app_runtime/app_runtime_api.cc“ synchronisiert werden. Die Aufzählung wird im UMA-Histogramm verwendet. Daher sollten Einträge nicht neu angeordnet oder entfernt werden.

Enum

"app_launcher"

"new_tab_page"

„reload“ 
 

"command_line"

"file_handler"

"system_tray"

"about_page"

"extensions_page"

"ephemeral_app"

„background“

„test“

"installed_notification"

"context_menu"

„sparky“

Ereignisse

onEmbedRequested

chrome.app.runtime.onEmbedRequested.addListener(
  callback: function,
)

Wird ausgelöst, wenn eine App, die eingebettet werden soll, eine Einbettung anfordert. Dieses Ereignis ist nur im Entwicklerkanal mit dem Flag „–enable-app-view“ verfügbar.

Parameter

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

onRestarted

chrome.app.runtime.onRestarted.addListener(
  callback: function,
)

Wird beim Start von Chrome für Apps ausgelöst, die beim letzten Herunterfahren von Chrome ausgeführt wurden, oder wenn Apps aus anderen Gründen zum Neustart aus ihrem vorherigen Status aufgefordert wurden. Beispiel: Wenn der Nutzer den Zugriff auf aufbewahrte Dateien einer App widerruft, startet die Laufzeit die App neu. Wenn Apps keinen onRestarted-Handler haben, wird in diesen Fällen ein onLaunched-Ereignis gesendet.

Parameter

  • callback

    Funktion

    Der Parameter callback sieht so aus: 

    () => void