chrome.app.runtime

Opis

Aby zarządzać cyklem życia aplikacji, użyj interfejsu API chrome.app.runtime. Czas wykonywania aplikacji zarządza instalacją aplikacji, kontroluje stronę wydarzenia i może ją w każdej chwili zamknąć.

Typy

ActionData

Chrome 54 lub nowszy

Właściwości

  • actionType

    "new_note"

ActionType

Chrome 54 lub nowszy

Aplikację można uruchomić w celu wykonania określonej czynności, np. utworzenia nowej notatki. Typ działania, za pomocą którego aplikacja została uruchomiona, jest dostępny w polu actionData instancji LaunchData.

Wartość

"new_note"

EmbedRequest

Właściwości

  • dane

    dowolne opcjonalne

    Opcjonalne dane określone przez dewelopera, których może używać aplikacja, aby podjąć decyzję o osadzeniu.

  • embedderId

    ciąg znaków

  • allow

    nieważne

    Umożliwia aplikacji embedderId umieszczenie jej w elemencie <appview>. url określa zawartość do osadzenia.

    Funkcja allow ma postać:

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

    • URL

      ciąg znaków

  • odmowa

    nieważne

    Uniemożliwia aplikacji embedderId umieszczanie jej w elemencie <appview>.

    Funkcja deny ma postać:

    () => {...}

LaunchData

Właściwości

  • actionData

    ActionData opcjonalnie

    Chrome 54 lub nowszy

    Zawiera dane określające ActionType, z którego uruchomiono aplikację. Wartość null, jeśli aplikacja nie została uruchomiona z określonym zamiarem działania.

  • id

    ciąg znaków opcjonalny

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

  • isKioskSession

    wartość logiczna opcjonalna

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

  • isPublicSession

    wartość logiczna opcjonalna

    Chrome 47 lub nowszy

    Czy aplikacja jest uruchamiana w sesji publicznej ChromeOS.

  • items

    LaunchItem[] opcjonalnie

    Wpisy w pliku dotyczące zdarzenia onLaunched wywołanego przez odpowiedni moduł obsługi pliku w kluczu manifestu file_handlers.

  • referrerUrl

    ciąg znaków opcjonalny

    Adres URL witryny odsyłającej zdarzenia onLaunched wywołanego przez moduł obsługi adresu URL dopasowany w kluczu manifestu url_handlers.

  • źródło

    LaunchSource opcjonalny

    Miejsce, z którego uruchamiana jest aplikacja.

  • URL

    ciąg znaków opcjonalny

    Adres URL zdarzenia onLaunched wywołanego przez pasujący do niego w manifeście klucz 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. Wartość ta powinna być synchronizowana z wartością AppLaunchSource w components/services/app_service/public/mojom/types.mojom oraz z wynikiem funkcji GetLaunchSourceEnum() w extensions/browser/api/app_runtime/app_runtime_api.cc. Zwróć uwagę, że w histogramie UMA jest używana enumeracja, więc wpisów nie należy zmieniać ani 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,
)

Wyzwalane, gdy aplikacja do umieszczania wstawia tę aplikację. To zdarzenie jest dostępne tylko na kanale deweloperskim z flagą --enable-app-view.

Parametry

onLaunched

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

Uruchamiane, gdy aplikacja jest uruchamiana z menu z aplikacjami.

Parametry

  • wywołanie zwrotne

    funkcja

    Parametr callback ma postać:

    (launchData?: LaunchData) => void

onRestarted

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

Wywoływany przy uruchomieniu Chrome w przypadku aplikacji, 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 uruchomieniowe ponownie uruchomi aplikację). W takich sytuacjach, jeśli aplikacje nie mają obsługi onRestarted, zamiast tego zostanie wysłane zdarzenie onLaunched.

Parametry

  • wywołanie zwrotne

    funkcja

    Parametr callback ma postać:

    () => void