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 54 und höher

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. Der Aktionstyp, mit dem die App gestartet wurde, ist im Feld actionData der LaunchData-Instanz verfügbar.

Wert

"new_note"

EmbedRequest

Attribute

  • data

    Beliebige optionale

    Optionale vom Entwickler angegebene Daten, die die einzubettende App verwenden kann, um eine Entscheidung über die Einbettung zu treffen.

  • embedderId

    String

  • allow

    void

    Erlaubt 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

  • actionData

    ActionData optional

    Chrome 54 und höher

    Enthält Daten, die die ActionType angeben, mit denen 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

    Ob die App in einer Chrome OS-Kiosksitzung gestartet wird.

  • isPublicSession

    Boolescher Wert optional

    Chrome 47 oder höher

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

  • items

    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 Manifestschlüssel url_handlers ausgelöst wird.

  • source

    LaunchSource optional

    Wo die App gestartet wird.

  • url

    String optional

    Die URL für das onLaunched-Ereignis, das von einem übereinstimmenden URL-Handler im Manifestschlü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 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 werden. Beachten Sie, dass die Aufzählung im UMA-Histogramm verwendet wird, sodass Einträge nicht neu angeordnet oder entfernt werden sollten.

Enum

"untracked"

"reload"

"load_and_launch"

"command_line"

"file_handler"

"url_handler"

"management_api"

"chrome_internal"

"installed_notification"

"context_menu"

"intent_url"

"focus_mode"

Veranstaltungen

onEmbedRequested

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

Wird ausgelöst, wenn eine eingebettete App das Einbetten dieser App 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