chrome.app.runtime

Opis

Używaj interfejsu chrome.app.runtime API do zarządzania cyklem życia aplikacji. Środowisko wykonawcze aplikacji zarządza instalacją aplikacji, kontroluje stronę zdarzenia i może wyłączyć aplikację w dowolnym momencie.

Typy

ActionData

Chrome w wersji 54 i nowszych

Właściwości

  • actionType

    "new_note"

ActionType

Chrome w wersji 54 i nowszych

Aplikację można uruchomić w związku z konkretnym działaniem, na przykład aby utworzyć nową notatkę. Typ działania, za pomocą którego uruchomiono aplikację, jest podany w polu actionData w instancji LaunchData.

Wartość

"new_note"

EmbedRequest

Właściwości

  • dane

    dowolne opcjonalne

    Opcjonalny deweloper określił dane, na podstawie których aplikacja ma zostać umieszczona podczas podejmowania decyzji o umieszczeniu.

  • embedderId

    string,

  • allow

    void

    Zezwala na umieszczanie przez embedderId tej aplikacji w elemencie <appview>. Pole url określa treść do umieszczenia.

    Funkcja allow wygląda tak: 

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

    • URL

      string,

  • odmów

    void

    Uniemożliwia usłudze embedderId umieszczanie tej aplikacji w elemencie <appview>.

    Funkcja deny wygląda tak: 

    ()=> {...}

LaunchData

Właściwości

  • actionData

    ActionData (opcjonalnie)

    Chrome w wersji 54 i nowszych

    Zawiera dane wskazujące, za pomocą którego ActionType uruchomiono tę aplikację. Ta wartość ma wartość null, jeśli aplikacja nie została uruchomiona z konkretną intencją działania.

  • id

    ciąg znaków opcjonalny

    Identyfikator pliku lub modułu obsługi adresu URL, za pomocą którego wywołujesz aplikację. Identyfikatory modułów obsługi to klucze najwyższego poziomu w słownikach file_handlers lub url_handlers w pliku manifestu.

  • isKioskSession

    wartość logiczna opcjonalna

    Wskazuje, czy aplikacja jest uruchamiana w sesji kiosku Chrome OS.

  • isPublicSession

    wartość logiczna opcjonalna

    Chrome 47 i nowsze wersje

    Wskazuje, czy aplikacja jest uruchamiana w sesji publicznej Chrome OS.

  • items

    LaunchItem[] opcjonalnie

    Wpisy w pliku zdarzenia onLaunched aktywowane przez pasujący moduł obsługi pliku w kluczu manifestu file_handlers.

  • referrerUrl

    ciąg znaków opcjonalny

    Adres URL strony odsyłającej w przypadku zdarzenia onLaunched wywołanego przez pasujący moduł obsługi adresu URL w kluczu manifestu url_handlers.

  • source

    LaunchSource opcjonalnie

    miejsce uruchamiania aplikacji;

  • URL

    ciąg znaków opcjonalny

    Adres URL zdarzenia onLaunched wywołany przez pasujący element obsługi adresu URL w kluczu manifestu url_handlers.

LaunchItem

Właściwości

  • wpis

    Wpis

    Wpis związany z elementem.

  • Niestandardowy typ treści

    ciąg znaków opcjonalny

    Typ MIME pliku.

LaunchSource

Wyliczenie źródeł uruchomień aplikacji. Ta wartość powinna być synchronizowana z AppLaunchSource w komponentach/services/app_service/public/mojom/types.mojom i w GetLaunchSourceEnum() w interfejsie extensions/browser/api/app_runtime/app_runtime_api.cc. Pamiętaj, że wyliczenie jest używane w histogramie UMA, więc nie należy zmieniać kolejności wpisów ani ich usuwać.

Typ wyliczeniowy

"untracked"

"app_launcher"

"new_tab_page"

"restart"

"load_and_launch"

"command_line"

"file_handler"

"url_handler"

"system_tray"

"about_page"

"extensions_page"

"management_api"

"ephemeral_app"

"background"

"kiosk"

"chrome_internal"

"installed_notification"

"context_menu"

"arc"

"intent_url"

"app_home_page"

"focus_mode"

Wydarzenia

onEmbedRequested

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

Uruchamiane, gdy aplikacja umieszczająca prosi o umieszczenie tej aplikacji. To zdarzenie jest dostępne tylko w kanale deweloperskim z flagą --enable-app-view.

Parametry

onLaunched

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

Uruchamiane, gdy aplikacja jest uruchamiana z programu uruchamiającego.

Parametry

  • wywołanie zwrotne

    funkcja

    Parametr callback wygląda tak: 

    (launchData?: LaunchData)=>void

onRestarted

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

Uruchamiane podczas uruchamiania Chrome w przypadku aplikacji, które były uruchomione w momencie ostatniego wyłączenia Chrome lub w przypadku prośby o ponowne uruchomienie aplikacji z innego powodu (np. gdy użytkownik anuluje dostęp do zachowanych plików aplikacji, środowisko wykonawcze uruchomi aplikację ponownie). W takich sytuacjach aplikacje, które nie mają modułu obsługi onRestarted, otrzymają zamiast tego zdarzenie onLaunched.

Parametry

  • wywołanie zwrotne

    funkcja

    Parametr callback wygląda tak: 

    ()=>void