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

Typen

EmbedRequest

Attribute

  • Daten

    any optional

    Optionale vom Entwickler angegebene Daten, die die einzubettende App verwenden kann, wenn sie eine Einbettungsentscheidung trifft.

  • embedderId

    String

  • allow

    void

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

    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

  • 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-Dictionaries im Manifest.

  • isKioskSession

    Boolesch optional

    Ob die App in einer ChromeOS-Kiosksitzung gestartet wird.

  • isPublicSession

    Boolesch optional

    Chrome 47 oder höher

    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 Dateihandler im Manifestschlüssel file_handlers ausgelöst wurde.

  • referrerUrl

    String optional

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

  • Quelle

    LaunchSource optional

    Wo die App gestartet wird.

  • URL

    String optional

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

LaunchItem

Attribute

  • Eintrag

    Eintrag

    Eintrag für das Element.

  • Typ

    String optional

    Der MIME-Typ der Datei.

LaunchSource

Aufzählung der App-Startquellen. 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 synchron gehalten werden. Die Aufzählung wird im UMA-Histogramm verwendet. Einträge dürfen daher nicht neu angeordnet oder entfernt werden.

Enum

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

Ereignisse

onEmbedRequested

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

Wird ausgelöst, wenn eine einbettende App die Einbettung dieser App anfordert. Dieses Ereignis ist nur in der Entwicklerversion 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 aufgefordert wurden, im vorherigen Status neu zu starten (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 Situationen keinen onRestarted-Handler haben, wird stattdessen ein onLaunched-Ereignis gesendet.

Parameter

  • callback

    Funktion

    Der Parameter callback sieht so aus: 

    () => void