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 cerrarla 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 en el campo actionData
de la instancia LaunchData.
Valor
“new_note”
EmbedRequest
Propiedades
-
datos
Cualquier opcional
El desarrollador opcional especificó los datos que la app que se incorporará puede usar cuando tome una decisión sobre la incorporación.
-
embedderId
string
-
allow
void
Permite que
embedderId
incorpore esta app en una <appview> .url
especifica el contenido que se incorporará.La función
allow
se ve de la siguiente manera:(url: string) => {...}
-
url
string
-
-
deny
void
Impide que
embedderId
incorpore esta app en una <appview> .La función
deny
se ve de la siguiente manera:() => {...}
LaunchData
Propiedades
-
actionData
ActionData opcional
Chrome 54 y versiones posterioresContiene datos que especifican los
ActionType
con los que se inició esta app. Este valor es nulo si la app no se inició con un intent de acción específico. -
id
string opcional
El ID del archivo o del controlador de URL con el que se invoca la app. Los IDs del controlador son las claves de nivel superior de los diccionarios
file_handlers
ourl_handlers
del manifiesto. -
isKioskSession
booleano opcional
Indica si la app se inicia en una sesión de kiosco del Sistema operativo Chrome.
-
isPublicSession
booleano opcional
Chrome 47 y versiones posterioresIndica si la app se inicia en una sesión pública de ChromeOS.
-
elementos
LaunchItem[] opcional
Las entradas de archivo del evento
onLaunched
activadas por un controlador de archivos coincidente en la clave de manifiestofile_handlers
. -
referrerUrl
string opcional
Es la URL de referencia del evento
onLaunched
activada por un controlador de URL coincidente en la clave de manifiestourl_handlers
. -
source
LaunchSource opcional
El lugar desde el que se inicia la app
-
url
string opcional
Es la URL del evento
onLaunched
activado por un controlador de URL coincidente en la clave de manifiestourl_handlers
.
LaunchItem
Propiedades
-
entry.
Entrada
Entrada del elemento.
-
tipo
string opcional
Es el tipo de MIME del archivo.
LaunchSource
Enumeración de las fuentes de inicio de la app. Se debe mantener sincronizado con AppLaunchSource en components/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 UMA, por lo que las entradas no se deben reordenar ni quitar.
Enum
“sin seguimiento”
"app_launcher"
"new_tab_page"
“reload”
“reiniciar”
"load_and_launch"
"command_line"
"file_handler"
"url_handler"
"system_tray"
"about_page"
“teclado”
"extensions_page"
"management_api"
"ephemeral_app"
“segundo plano”
“kiosk”
"chrome_internal"
“prueba”
"installed_notification"
"context_menu"
“arco”
"intent_url"
"app_home_page"
"focus_mode"
“sparky”
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
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
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 en las aplicaciones que se estaban ejecutando la última vez que se cerró Chrome o cuando se solicita que las aplicaciones se reinicien desde su estado anterior por otros motivos (p.ej., cuando el usuario revoca el acceso a los archivos retenidos de una aplicación, el tiempo de ejecución reiniciará la aplicación). En estas situaciones, si las apps no tienen un controlador onRestarted
, se les enviará un evento onLaunched
en su lugar.
Parámetros
-
callback
función
El parámetro
callback
se ve de la siguiente manera:() => void