chrome.app.runtime

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

Typen

EmbedRequest

Attribute

  • Daten

    beliebig optional

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

  • embedderId

    String

  • allow

    void

    Ermöglicht es embedderId, diese App in ein <appview>-Element einzubetten. Mit der url wird der einzubettende Inhalt angegeben.

    Die allow-Funktion sieht so aus: 

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

    • URL

      String

  • deny

    void

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

    Die deny-Funktion sieht so aus: 

    () => {...}

LaunchData

Attribute

  • id

    String optional

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

    Gibt an, ob die App in einer öffentlichen ChromeOS-Sitzung gestartet wird.

  • Elemente

    LaunchItem[] optional

    Die Dateieinträge für das onLaunched-Ereignis, das durch einen übereinstimmenden Datei-Handler im Manifest-Schlüssel file_handlers ausgelöst wurde.

  • referrerUrl

    String optional

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

  • source

    LaunchSource optional

    Woher 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

Aufzählung 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

„untracked“

"app_launcher"

"new_tab_page"

„reload“

„neu starten“

"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“

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 Starten von Chrome für Apps ausgelöst, die beim letzten Herunterfahren von Chrome aktiv waren, oder wenn Apps aus anderen Gründen aus ihrem vorherigen Status neu gestartet werden sollen (z.B. wenn der Nutzer den Zugriff auf die gespeicherten Dateien einer App widerruft, wird die App von der Laufzeit neu gestartet). Wenn Apps in diesen Fällen keinen onRestarted-Handler haben, wird stattdessen ein onLaunched-Ereignis gesendet.

Parameter

  • callback

    Funktion

    Der Parameter callback sieht so aus: 

    () => void