OnLaunch

Article
02/07/2025

Cet élément signifie que le service de déploiement recherche une mise à jour du fichier Du programme d’installation d’application lors du lancement de l’application.

Hiérarchie d’éléments

< > AppInstaller

<updateSettings>: < > OnLaunch

Syntaxe

<OnLaunch s4:HoursBetweenUpdateChecks? = String with numeric values between 0 and 255 inclusive.
    s4:ShowPrompt? = Boolean
    s4:UpdateBlocksActivation? = Boolean />

Clé

? facultatif (zéro ou un)

Attributs et éléments

Attributs

Attribut	Description	Type de données	Obligatoire
s4 :HoursBetweenUpdateChecks	HoursBetweenUpdateChecks spécifie la fréquence à laquelle le service de déploiement vérifie une mise à jour du fichier Du programme d’installation d’application. Lorsque HoursBetweenUpdateChecks est défini sur 0, le service de déploiement vérifie les mises à jour chaque fois que l’application est lancée. Pour d’autres valeurs, le service de déploiement vérifie les mises à jour lorsque l’application est lancée uniquement si elle n’a pas déjà été vérifiée au cours des dernières heures spécifiées par HoursBetweenUpdateChecks. Par exemple, si HoursBetweenUpdateChecks a la valeur 12, le service de déploiements vérifie les mises à jour lorsque l’application est lancée uniquement si elle n’a pas déjà vérifié les mises à jour au cours des 12 heures précédentes.	Valeurs numériques comprises entre 0 et 255 inclus. La valeur par défaut est 24.	Non
s4 :ShowPrompt	Indique si le déploiement affiche une invite, en informant l’utilisateur de la mise à jour. Pour plus d’informations sur le comportement de cet attribut, consultez les remarques. Disponible dans Windows 10, version 1903 et ultérieure.	Booléen	Non
s4 :UpdateBlocksActivation	Doit être utilisé uniquement si ShowPrompt="true ». Indique si le déploiement empêche l’utilisateur de lancer l’application jusqu’à ce que la mise à jour ait été appliquée. « UpdateBlocksActivation » = true signifie que l’interface utilisateur que l’utilisateur verra permet à l’utilisateur de prendre la mise à jour ou de fermer l’application. « UpdateBlocksActivation » = false signifie que l’interface utilisateur que l’utilisateur verra permet à l’utilisateur de prendre la mise à jour ou de démarrer l’application sans mise à jour. Dans ce dernier cas, la mise à jour sera appliquée en mode silencieux à un moment opportun. Pour plus d’informations sur le comportement de cet attribut, consultez les remarques. Disponible dans Windows 10, version 1903 et ultérieure.	Booléen	Non

Éléments parents

Éléments parents	Description
UpdateSettings	Élément facultatif du fichier appinstaller. UpdateSettings indique s’il faut vérifier ou non une mise à jour pendant le lancement de l’application.

Remarques

La définition de l’attribut ShowPrompt="true" affiche actuellement une invite pour les applications UWP, mais pas pour les applications de bureau qui ont été empaquetées dans un package d’application Windows (c’est-à-dire, les applications de bureau qui utilisent desktop Bridge). Pour les applications de bureau, cette fonctionnalité fournit une mise à jour silencieuse ; la même fonctionnalité par défaut fournie par l’élément OnLaunch.

Les attributs ShowPrompt et UpdateBlocksActivation n’ont effet que lorsque l’utilisateur démarre l’application à partir d’un élément de menu, d’une vignette dans le menu Démarrer, d’un alias d’application ou d’un gestionnaire de protocole. Ces attributs n’ont aucun effet si l’utilisateur démarre l’application à partir d’un raccourci de bureau ou de la barre des tâches.

Exemples

Dans cet exemple, le déploiement recherche les mises à jour chaque fois que l’application est lancée. Si des mises à jour sont trouvées, le déploiement affiche une invite indiquant à l’utilisateur qu’il doit effectuer la mise à jour avant de lancer l’application. La version de l’application peut également être incrémentée ou décrémentée.

<UpdateSettings> 
    <OnLaunch s4:HoursBetweenUpdateChecks="0" s4:ShowPrompt="true" s4:UpdateBlocksActivation="true"/>
    <s4:ForceUpdateFromAnyVersion>true</s4:ForceUpdateFromAnyVersion>
</UpdateSettings>

Exigences

Exigence	Description
`xmlns=http://schemas.microsoft.com/appx/appinstaller/2017`	Cet espace de noms est requis pour les fonctionnalités introduites dans Windows 10, version 1709.
`xmlns:s4=http://schemas.microsoft.com/appx/appinstaller/2021`	Cet espace de noms est requis pour les fonctionnalités introduites dans Windows version 21H2 build 22000
Version minimale du système d’exploitation	Windows 10, version 1709

Partager via