chrome.app.runtime

Opis

Do zarządzania cyklem życia aplikacji używaj interfejsu API chrome.app.runtime. Środowisko wykonawcze aplikacji zarządza instalacją aplikacji, kontroluje stronę zdarzenia i może w każdej chwili wyłączyć aplikację.

Typy

ActionData

Chrome w wersji 54 lub nowszej .

Właściwości

  • actionType

    "new_note"

ActionType

Chrome w wersji 54 lub nowszej .

Aplikację można uruchomić pod kątem konkretnego działania, np. w celu utworzenia nowej notatki. Typ działania, za pomocą którego aplikacja została uruchomiona, jest dostępny w polu actionData w instancji LaunchData.

Wartość

"new_note"

EmbedRequest

Właściwości

  • dane

    dowolne opcjonalne

    Opcjonalny deweloper określił dane, których aplikacja może użyć podczas podejmowania decyzji o umieszczeniu.

  • embedderId

    ciąg znaków

  • allow

    nieważne

    Pozwala aplikacji embedderId na umieszczenie tej aplikacji w <widoku aplikacji> . Pole url określa treść do umieszczenia.

    Funkcja allow wygląda tak: 

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

    • URL

      ciąg znaków

  • odmów

    nieważne

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

    Funkcja deny wygląda tak: 

    () => {...}

LaunchData

Właściwości

  • actionData

    Opcjonalne ActionData

    Chrome w wersji 54 lub nowszej .

    Zawiera dane określające ActionType, za pomocą którego aplikacja została uruchomiona. Jeśli aplikacja nie została uruchomiona z określonym zamiarem działania, ta wartość ma wartość null.

  • id

    ciąg znaków opcjonalny

    Identyfikator pliku lub modułu obsługi adresu URL, za pomocą którego aplikacja jest wywoływana. 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

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

  • isPublicSession

    Wartość logiczna opcjonalna

    Chrome w wersji 47 lub nowszej .

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

  • items

    LaunchItem[] opcjonalny

    Wpisy w plikach dotyczące zdarzenia onLaunched aktywowanego 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 adresu URL w kluczu manifestu url_handlers.

  • źródło

    Opcjonalne LaunchSource

    Skąd aplikacja została uruchomiona.

  • URL

    ciąg znaków opcjonalny

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

LaunchItem

Właściwości

  • wpis

    Wpis

    Wpis dotyczący produktu.

  • typ

    ciąg znaków opcjonalny

    Typ MIME pliku.

LaunchSource

Wyliczenie źródeł uruchamiania aplikacji. Należy je synchronizować z AppLaunchSource w komponentach/services/app_service/public/mojom/types.mojom i w GetLaunchSourceEnum() w rozszerzeniach/browser/api/app_runtime/app_runtime_api.cc. Pamiętaj, że na histogramie UMA używane jest wyliczenie, więc wpisów nie należy usuwać ani zmieniać ich kolejności.

Typ wyliczeniowy

"untracked"

&quot;app_launcher&quot;

"new_tab_page"

"reload"

"restart"

&quot;load_and_launch&quot;

"command_line"

&quot;file_handler&quot;

"url_handler"

"tray_systemowe"

"about_page"

"keyboard"

&quot;extensions_page&quot;

"management_api"

&quot;ephemeral_app&quot;

"background"

"kiosk"

"chrome_internal"

"test"

&quot;installed_notification&quot;

&quot;context_menu&quot;

"arc"

&quot;intent_url&quot;

&quot;app_home_page&quot;

&quot;focus_mode&quot;

"sparky"

Wydarzenia

onEmbedRequested

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

Uruchamiane, gdy umieszczona aplikacja poprosi o umieszczenie 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 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 gdy z innych powodów (np. gdy użytkownik anuluje dostęp do przechowywanych plików aplikacji, środowisko wykonawcze ponownie uruchomi aplikację) W takich sytuacjach aplikacje, które nie mają modułu obsługi onRestarted, otrzymają zdarzenie onLaunched.

Parametry

  • wywołanie zwrotne

    funkcja

    Parametr callback wygląda tak: 

    () => void