Description
Utilisez l'API chrome.app.runtime
pour gérer le cycle de vie de l'application. L'environnement d'exécution de l'application gère l'installation des applications, contrôle la page d'événement et peut arrêter l'application à tout moment.
Types
ActionData
Propriétés
-
actionType
"new_note"
ActionType
Vous pouvez lancer une application en pensant à une action spécifique (par exemple, pour créer une note). Le type d'action avec lequel l'application a été lancée est disponible dans le champ actionData
de l'instance LaunchData.
Valeur
"new_note"
EmbedRequest
Propriétés
-
données
Toute valeur facultatif
Données facultatives spécifiées par le développeur que l'application à intégrer peut utiliser lorsqu'elle prend une décision d'intégration.
-
embedderId
chaîne
-
allow
void
Permet à
embedderId
d'intégrer cette appli dans un élément <appview>.url
spécifie le contenu à intégrer.La fonction
allow
se présente comme suit :(url: string)=> {...}
-
url
chaîne
-
-
deny
void
Empêche
embedderId
d'intégrer cette application dans un élément <appview>.La fonction
deny
se présente comme suit :()=> {...}
LaunchData
Propriétés
-
actionData
ActionData facultatif
Chrome 54 et versions ultérieuresContient des données qui spécifient la
ActionType
avec laquelle cette application a été lancée. La valeur est nulle si l'application n'a pas été lancée avec un intent d'action spécifique. -
id
string facultatif
ID du fichier ou du gestionnaire d'URL avec lequel l'application est appelée. Les ID de gestionnaire correspondent aux clés de premier niveau dans les dictionnaires
file_handlers
et/ouurl_handlers
du fichier manifeste. -
isKioskSession
Booléen facultatif
Indique si l'application est lancée dans une session kiosque Chrome OS.
-
isPublicSession
Booléen facultatif
Chrome 47 ou version ultérieureIndique si l'application est lancée dans une session publique Chrome OS.
-
items
LaunchItem[] facultatif
Entrées de fichier pour l'événement
onLaunched
déclenché par un gestionnaire de fichiers correspondant dans la clé du fichier manifestefile_handlers
. -
referrerUrl
string facultatif
URL de provenance de l'événement
onLaunched
déclenché par un gestionnaire d'URL correspondant dans la clé du fichier manifesteurl_handlers
. -
source
LaunchSource facultatif
Provenance du lancement de l'application.
-
url
string facultatif
URL de l'événement
onLaunched
déclenché par un gestionnaire d'URL correspondant dans la clé du fichier manifesteurl_handlers
.
LaunchItem
Propriétés
-
entry
Entrée
Entrée de l'élément.
-
Type
string facultatif
Type MIME du fichier.
LaunchSource
Énumération des sources de lancement d'applications. Il doit être synchronisé avec AppLaunchSource dans composants/services/app_service/public/mojom/types.mojom et avec GetLaunchSourceEnum() dans extensions/browser/api/app_runtime/app_runtime_api.cc. Notez que l'énumération est utilisée dans l'histogramme UMA. Les entrées ne doivent donc pas être réorganisées ni supprimées.
Enum
"untracked"
"app_launcher"
"new_tab_page"
"reload"
"load_and_launch"
"command_line"
"file_handler"
"url_handler"
"system_tray"
"about_page"
"extensions_page"
"management_api"
"ephemeral_app"
"background"
"chrome_internal"
"test"
"installed_notification"
"context_menu"
"arc"
"intent_url"
"app_home_page"
"focus_mode"
Événements
onEmbedRequested
chrome.app.runtime.onEmbedRequested.addListener(
callback: function,
)
Déclenché lorsqu'une application d'intégration demande l'intégration de cette application. Cet événement n'est disponible que sur la version en développement avec l'indicateur --enable-app-view.
Paramètres
-
rappel
function
Le paramètre
callback
se présente comme suit :(request: EmbedRequest)=>void
-
request
-
onLaunched
chrome.app.runtime.onLaunched.addListener(
callback: function,
)
Déclenché lorsqu'une application est lancée depuis le lanceur d'applications
Paramètres
-
rappel
function
Le paramètre
callback
se présente comme suit :(launchData?: LaunchData)=>void
-
launchData
LaunchData facultatif
-
onRestarted
chrome.app.runtime.onRestarted.addListener(
callback: function,
)
Déclenché au démarrage de Chrome pour les applications qui étaient en cours d'exécution lorsque Chrome s'est arrêté pour la dernière fois, ou lorsque le redémarrage de l'application à partir de son état précédent a été demandé pour d'autres raisons (par exemple, lorsque l'utilisateur révoque l'accès aux fichiers conservés d'une application, l'exécution redémarre l'application). Dans ce cas, si les applications n'ont pas de gestionnaire onRestarted
, elles reçoivent un événement onLaunched
à la place.
Paramètres
-
rappel
function
Le paramètre
callback
se présente comme suit :()=>void