Descripción
Usa la API de chrome.app.runtime
para administrar el ciclo de vida de la app. El tiempo de ejecución de la app administra la instalación de la app, controla la página del evento y puede cerrar la app en cualquier momento.
Tipos
ActionData
Propiedades
-
actionType
"new_note"
ActionType
Se puede iniciar una app con una acción específica en mente; por ejemplo, para crear una nota nueva. El tipo de acción con la que se inició la app está disponible dentro del campo actionData
de la instancia de LaunchData.
Valor
"new_note"
EmbedRequest
Propiedades
-
datos
cualquier opcional
El desarrollador opcional especificó datos que la app que se debe incorporar puede usar cuando toma una decisión sobre la incorporación.
-
embedderId
cadena
-
allow
void
Permite que
embedderId
incorpore esta app en un elemento <appview>. Laurl
especifica el contenido que se insertará.La función
allow
se ve de la siguiente manera:(url: string)=> {...}
-
url
cadena
-
-
deny
void
Impide que
embedderId
incorpore esta app en un elemento <appview>.La función
deny
se ve de la siguiente manera:()=> {...}
LaunchData
Propiedades
-
actionData
ActionData opcional
Chrome 54 y versiones posterioresContiene datos que especifican el
ActionType
con el que se inició esta app. Este valor es nulo si la app no se inició con un intent de acción específico. -
id
cadena opcional
El ID del archivo o del controlador de URL con el que se invoca la app. Los IDs de controlador son las claves de nivel superior de los diccionarios
file_handlers
ourl_handlers
del manifiesto. -
isKioskSession
booleano opcional
Si la aplicación se inicia en una sesión de kiosco de ChromeOS.
-
isPublicSession
booleano opcional
Chrome 47 y versiones posterioresIndica si la app se inicia en una sesión pública de ChromeOS.
-
items
LaunchItem[] opcional
Las entradas de archivo para el evento
onLaunched
activado por un controlador de archivos coincidente en la clave de manifiestofile_handlers
. -
referrerUrl
cadena opcional
Es la URL de referencia para el evento
onLaunched
activado por un controlador de URL coincidente en la clave de manifiestourl_handlers
. -
source
LaunchSource opcional
Desde dónde se inicia la app
-
url
cadena opcional
La URL del evento
onLaunched
activado por un controlador de URL coincidente en la clave de manifiestourl_handlers
.
LaunchItem
Propiedades
-
entry.
Entrada
Entrada del artículo.
-
Tipo
cadena opcional
Es el tipo de MIME del archivo.
LaunchSource
Enumeración de las fuentes de inicio de la app. Esto debe mantenerse sincronizado con AppLaunchSource en componentes/services/app_service/public/mojom/types.mojom y GetLaunchSourceEnum() en extensions/browser/api/app_runtime/app_runtime_api.cc. Ten en cuenta que la enumeración se usa en el histograma de la UMA, de modo que las entradas no se deben reordenar ni quitar.
Enum
"app_launcher"
"new_tab_page"
"load_and_launch"
"command_line"
"file_handler"
"url_handler"
"system_tray"
"about_page"
"extensions_page"
"management_api"
"chrome_internal"
"installed_notification":
"context_menu"
"intent_url"
"app_home_page"
"focus_mode"
Eventos
onEmbedRequested
chrome.app.runtime.onEmbedRequested.addListener(
callback: function,
)
Se activa cuando una app de incorporación solicita incorporar esta app. Este evento solo está disponible en el canal para desarrolladores con la marca --enable-app-view.
Parámetros
-
callback
la función
El parámetro
callback
se ve de la siguiente manera:(request: EmbedRequest)=>void
-
request
-
onLaunched
chrome.app.runtime.onLaunched.addListener(
callback: function,
)
Se activa cuando se inicia una app desde el selector.
Parámetros
-
callback
la función
El parámetro
callback
se ve de la siguiente manera:(launchData?: LaunchData)=>void
-
launchData
LaunchData opcional
-
onRestarted
chrome.app.runtime.onRestarted.addListener(
callback: function,
)
Se activa al iniciar Chrome para apps que se estaban ejecutando cuando Chrome se cerró por última vez o cuando se solicitó reiniciar las apps desde su estado anterior por otras razones (por ejemplo, cuando el usuario revoca el acceso a los archivos retenidos de una app, el tiempo de ejecución reiniciará la app). En estas situaciones, si las apps no tienen un controlador onRestarted
, recibirán un evento onLaunched
en su lugar.
Parámetros
-
callback
la función
El parámetro
callback
se ve de la siguiente manera:()=>void