Descrição
Use a API chrome.app.runtime
para gerenciar o ciclo de vida do app. O tempo de execução do aplicativo gerencia a instalação do aplicativo, controla a página de eventos e pode encerrar o aplicativo a qualquer momento.
Tipos
ActionData
Propriedades
-
actionType
"new_note"
ActionType
Um app pode ser iniciado com uma ação específica em mente, por exemplo, para criar uma nova nota. O tipo de ação com que o app foi iniciado está disponível dentro do campo actionData
da instância LaunchData.
Valor
EmbedRequest
Propriedades
-
dados
opcional
Dados opcionais especificados pelo desenvolvedor que o app a ser incorporado pode usar ao tomar uma decisão de incorporação.
-
embedderId
string
-
allow
void
Permite que
embedderId
incorpore esse app em um elemento <appview>. Ourl
especifica o conteúdo a ser incorporado.A função
allow
tem esta aparência:(url: string) => {...}
-
url
string
-
-
deny
void
Impedindo que
embedderId
incorpore esse app em um elemento <appview>.A função
deny
tem esta aparência:() => {...}
LaunchData
Propriedades
-
actionData
ActionData opcional
Chrome 54 ou mais recenteContém dados que especificam o
ActionType
com que o app foi iniciado. O valor será nulo se o app não tiver sido iniciado com uma intent de ação específica. -
id
string opcional
O ID do gerenciador de arquivos ou URL com que o app está sendo invocado. Os IDs de gerenciador são as chaves de nível superior nos dicionários
file_handlers
e/ouurl_handlers
no manifesto. -
isKioskSession
booleano opcional
Se o aplicativo está sendo iniciado em uma sessão de quiosque do Chrome OS.
-
isPublicSession
booleano opcional
Chrome 47 ou superiorSe o app está sendo iniciado em uma sessão pública do Chrome OS.
-
itens
LaunchItem[] opcional
As entradas de arquivo para o evento
onLaunched
acionadas por um gerenciador de arquivos correspondente na chave de manifestofile_handlers
. -
referrerUrl
string opcional
O URL de referência do evento
onLaunched
acionado por um gerenciador de URL correspondente na chave de manifestourl_handlers
. -
source
LaunchSource opcional
De onde o app é iniciado.
-
url
string opcional
O URL do evento
onLaunched
acionado por um gerenciador de URL correspondente na chave de manifestourl_handlers
.
LaunchItem
Propriedades
-
entry
Entrada
Entrada do item.
-
tipo
string opcional
O tipo MIME do arquivo.
LaunchSource
Enumeração de origens de inicialização do app. Isso precisa ser mantido em sincronia com AppLaunchSource em components/services/app_service/public/mojom/types.mojom e GetLaunchSourceEnum() em extensions/browser/api/app_runtime/app_runtime_api.cc. A enumeração é usada no histograma UMA, então as entradas não podem ser reordenadas ou removidas.
Enumeração
"reload"
"system_tray"
"keyboard"
"extensions_page"
"management_api"
"ephemeral_app"
"background"
"chrome_internal"
"test"
"installed_notification"
"context_menu"
"app_home_page"
(link em inglês)
"sparky"
Eventos
onEmbedRequested
chrome.app.runtime.onEmbedRequested.addListener(
callback: function,
)
É acionado quando um app de incorporação solicita a incorporação desse app. Esse evento só está disponível no canal de desenvolvimento com a flag --enable-app-view.
Parâmetros
-
callback
função
O parâmetro
callback
tem este formato:(request: EmbedRequest) => void
-
solicitação
-
onLaunched
chrome.app.runtime.onLaunched.addListener(
callback: function,
)
Disparado quando um app é iniciado pelo acesso rápido.
Parâmetros
-
callback
função
O parâmetro
callback
tem esta aparência:(launchData?: LaunchData) => void
-
launchData
LaunchData opcional
-
onRestarted
chrome.app.runtime.onRestarted.addListener(
callback: function,
)
É disparado na inicialização do Chrome para apps que estavam em execução quando o Chrome foi encerrado pela última vez ou quando os apps foram solicitados a reiniciar do estado anterior por outros motivos (por exemplo, quando o usuário revoga o acesso aos arquivos retidos de um app, o ambiente de execução reinicia o app). Nessas situações, se os apps não tiverem um gerenciador onRestarted
, um evento onLaunched
será enviado.
Parâmetros
-
callback
função
O parâmetro
callback
tem esta aparência:() => void