chrome.app.runtime

Açıklama

Uygulama yaşam döngüsünü yönetmek için chrome.app.runtime API'yi kullanın. Uygulama çalışma zamanı, uygulama yüklemeyi yönetir, etkinlik sayfasını kontrol eder ve uygulamayı herhangi bir zamanda kapatabilir.

Türler

ActionData

Chrome 54 ve sonraki sürümler

Özellikler

  • actionType

    "new_note"

ActionType

Chrome 54 ve sonraki sürümler

Bir uygulama, belirli bir işlem (ör. yeni bir not oluşturmak için) düşünülerek başlatılabilir. Uygulamanın birlikte başlatıldığı işlem türü, LaunchData örneğindeki actionData alanının içinde bulunabilir.

Değer

"new_note"

EmbedRequest

Özellikler

  • veri

    isteğe bağlı herhangi bir

    İsteğe bağlı geliştirici, yerleştirilecek uygulamanın yerleştirme kararı alırken kullanabileceği verileri belirtti.

  • embedderId

    dize

  • izin ver

    void

    embedderId uygulamasının bu uygulamayı bir <appview> öğesine yerleştirmesine izin verir. url, yerleştirilecek içeriği belirtir.

    allow işlevi şu şekilde görünür: 

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

    • url

      dize

  • deny

    void

    embedderId ürününün bu uygulamayı bir <appview> öğesine yerleştirmesini engeller.

    deny işlevi şu şekilde görünür: 

    () => {...}

LaunchData

Özellikler

  • actionData

    ActionData isteğe bağlı

    Chrome 54 ve sonraki sürümler

    Bu uygulamanın birlikte kullanıma sunulduğu ActionType öğesini belirten veriler içerir. Uygulama belirli bir işlem amacıyla başlatılmamışsa bu değer boştur.

  • id

    dize isteğe bağlı

    Uygulamanın çağrıldığı dosyanın veya URL işleyicinin kimliği. İşleyici kimlikleri, manifest'teki file_handlers ve/veya url_handlers sözlüklerinde yer alan en üst düzey anahtarlardır.

  • isKioskSession

    boole isteğe bağlı

    Uygulamanın bir Chrome OS kiosk oturumunda başlatılıp başlatılmadığı.

  • isPublicSession

    boole isteğe bağlı

    Chrome 47 ve sonraki sürümler

    Uygulamanın Chrome OS herkese açık oturumda kullanıma sunulup sunulmadığı.

  • items

    LaunchItem[] isteğe bağlı

    file_handlers manifest anahtarında eşleşen bir dosya işleyici tarafından tetiklenen onLaunched etkinliği için dosya girişleri.

  • referrerUrl

    dize isteğe bağlı

    url_handlers manifest anahtarında eşleşen bir URL işleyici tarafından tetiklenen onLaunched etkinliği için yönlendiren URL.

  • source

    LaunchSource isteğe bağlı

    Uygulamanın kullanıma sunulduğu yer.

  • url

    dize isteğe bağlı

    url_handlers manifest anahtarında eşleşen bir URL işleyici tarafından tetiklenen onLaunched etkinliğinin URL'si.

LaunchItem

Özellikler

  • giriş

    Giriş

    Öğe girişi.

  • tür

    dize isteğe bağlı

    Dosyanın MIME türü.

LaunchSource

Uygulama başlatma kaynaklarının listesi. Bu, bileşenler/hizmetler/app_service/public/mojom/types.mojom içinde AppLaunchSource ve extensions/browser/api/app_runtime/app_runtime_api.cc içinde GetLaunchSourceEnum() ile senkronize olmalıdır. Numaralandırmanın UMA histogramında kullanıldığını, dolayısıyla girişlerin yeniden sıralanmaması veya kaldırılmaması gerektiğini unutmayın.

Enum

"untracked"

"new_tab_page"

"load_and_launch"

"command_line"

"file_handler"

"url_handler"

"system_tray"

"about_page"

"extensions_page"

"management_api"

"ephemeral_app"

"background"

"kiosk"

"chrome_internal"

"test"

"installed_notification"

"context_menu"

"arc"

"intent_url"

"app_home_page"

"focus_mode"

"sparky"

Etkinlikler

onEmbedRequested

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

Yerleştirme uygulaması bu uygulamanın yerleştirilmesini istediğinde tetiklenir. Bu etkinlik yalnızca --enable-app-view işaretine sahip geliştirici kanalında kullanılabilir.

Parametreler

  • geri çağırma

    işlev

    callback parametresi şu şekilde görünür: 

    (request: EmbedRequest) => void

onLaunched

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

Başlatıcıdan bir uygulama başlatıldığında tetiklenir.

Parametreler

  • geri çağırma

    işlev

    callback parametresi şu şekilde görünür: 

    (launchData?: LaunchData) => void

onRestarted

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

Chrome başlatılırken Chrome son kapatıldığında çalışan uygulamalar için tetiklenir veya uygulamaların başka nedenlerle (ör. kullanıcı bir uygulamanın saklanan dosyalarına erişimi iptal ettiğinde) önceki durumundan yeniden başlatılması istendiğinde çalışma zamanı uygulamayı yeniden başlatır. Bu durumlarda, uygulamalarda onRestarted işleyici yoksa bunun yerine onLaunched etkinliği gönderilir.

Parametreler

  • geri çağırma

    işlev

    callback parametresi şu şekilde görünür: 

    () => void