chrome.app.runtime

Opis

Użyj interfejsu API chrome.app.runtime, aby zarządzać cyklem życia aplikacji. Środowisko wykonawcze aplikacji zarządza instalacją aplikacji, kontroluje stronę zdarzeń i może w każdej chwili zamknąć aplikację.

Typy

EmbedRequest

Właściwości

  • dane

    any optional

    Opcjonalne dane określone przez dewelopera, których aplikacja do umieszczenia może używać podczas podejmowania decyzji o umieszczeniu.

  • embedderId

    tekst

  • allow

    unieważnienie,

    Zezwala aplikacji embedderId na umieszczenie tej aplikacji w elemencie <appview>. Atrybut url określa treść do umieszczenia.

    Funkcja allow wygląda tak:

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

    • URL

      tekst

  • deny

    unieważnienie,

    Uniemożliwia aplikacji embedderId osadzanie tej aplikacji w elemencie <appview>.

    Funkcja deny wygląda tak:

    () => {...}

LaunchData

Właściwości

  • id

    ciąg znaków opcjonalny

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

  • isKioskSession

    boolean opcjonalne

    Określa, czy aplikacja jest uruchamiana w sesji kiosku w ChromeOS.

  • isPublicSession

    boolean opcjonalne

    Chrome 47 lub nowsza wersja

    Określa, czy aplikacja jest uruchamiana w sesji publicznej ChromeOS.

  • elementy

    LaunchItem[] opcjonalny

    Wpisy plików dla zdarzenia onLaunched wywołanego przez pasujący moduł obsługi plików w kluczu manifestu file_handlers.

  • referrerUrl

    ciąg znaków opcjonalny

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

  • źródło

    LaunchSource opcjonalny

    Miejsce, z którego uruchomiono aplikację.

  • URL

    ciąg znaków opcjonalny

    Adres URL zdarzenia onLaunched wywołanego przez pasujący moduł obsługi adresów URL w kluczu manifestu url_handlers.

LaunchItem

Właściwości

  • entry

    Wpis

    Wpis dotyczący elementu.

  • typ

    ciąg znaków opcjonalny

    Typ MIME pliku.

LaunchSource

Wyliczenie źródeł uruchamiania aplikacji. Ta wartość powinna być zsynchronizowana z AppLaunchSource w components/services/app_service/public/mojom/types.mojom i GetLaunchSourceEnum() w 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"

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

Wydarzenia

onEmbedRequested

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

Uruchamiane, gdy aplikacja osadzająca żąda osadzenia tej aplikacji. To zdarzenie jest dostępne tylko w wersji deweloperskiej z flagą --enable-app-view.

Parametry

onLaunched

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

Uruchamiane, gdy aplikacja jest uruchamiana z menu z aplikacjami.

Parametry

  • callback

    funkcja

    Parametr callback wygląda tak:

    (launchData?: LaunchData) => void

onRestarted

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

Uruchamiane podczas uruchamiania Chrome w aplikacjach, które były uruchomione podczas ostatniego zamknięcia Chrome, lub gdy aplikacje zostały poproszone o ponowne uruchomienie z poprzedniego stanu z innych powodów (np. gdy użytkownik cofnie dostęp do zachowanych plików aplikacji, środowisko wykonawcze uruchomi aplikację ponownie). W takich sytuacjach, jeśli aplikacje nie mają modułu obsługi onRestarted, zostanie do nich wysłane zdarzenie onLaunched.

Parametry

  • callback

    funkcja

    Parametr callback wygląda tak:

    () => void