DeploymentOptions Énumération
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Spécifie les options de déploiement de package.
Cette énumération prend en charge une combinaison au niveau du bit de ses valeurs membres.
public enum class DeploymentOptions
/// [System.Flags]
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
enum class DeploymentOptions
[System.Flags]
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
public enum DeploymentOptions
var value = Windows.Management.Deployment.DeploymentOptions.none
Public Enum DeploymentOptions
- Héritage
-
DeploymentOptions
- Attributs
Configuration requise pour Windows
Famille d’appareils |
Windows 10 (introduit dans 10.0.10240.0)
|
API contract |
Windows.Foundation.UniversalApiContract (introduit dans v1.0)
|
Champs
DevelopmentMode | 2 | Lorsque vous définissez cette option, l’application est installée en mode développement. Pour plus d’informations sur le mode de développement, consultez Remarques. Utilisez cette option pour activer les scénarios de développement d’applications clés. Vous ne pouvez pas utiliser cette option conjointement avec un package groupé. Si vous utilisez cette option avec un package groupé, votre appel retourne ERROR_INSTALL_FAILED. |
ForceApplicationShutdown | 1 | Si ce package, ou tout package qui dépend de ce package, est actuellement en cours d’utilisation, les processus associés au package sont arrêtés de force afin que l’inscription puisse se poursuivre. |
ForceTargetApplicationShutdown | 64 | Si ce package est actuellement en cours d’utilisation, les processus associés au package sont arrêtés de force afin que l’inscription puisse se poursuivre. |
ForceUpdateFromAnyVersion | 262144 | Forcez une version spécifique d’un package à être intermédiaire/inscrite, qu’une version supérieure soit déjà intermédiaire/inscrite. |
InstallAllResources | 32 | Lorsque vous définissez cette option, l’application est chargée d’ignorer les vérifications d’applicabilité des ressources. Cela permet de mettre en place ou d’inscrire tous les packages de ressources qu’un utilisateur transmet à la commande, ce qui force l’applicabilité pour tous les packages contenus dans un bundle. Si un utilisateur transmet un bundle, tous les packages de ressources contenus sont inscrits. Windows uniquement. |
None | 0 | Le comportement par défaut est utilisé. |
RequiredContentGroupOnly | 256 | Lorsque vous définissez cette option, seul le groupe de contenu requis est mis en phase. Une application peut être installée en tant que package avec le groupe de contenu requis uniquement. |
RetainFilesOnFailure | 2097152 | En cas d’échec du déploiement, ne supprimez pas les fichiers qui ont été créés sur l’ordinateur cible pendant le processus d’installation. |
StageInPlace | 4194304 | Lorsque vous définissez cette option, le package est mis en place. Ce champ est utile pour informer le système de se préparer à l’inscription d’applications dans des scénarios de bureau virtuel. |
Remarques
Vous pouvez utiliser l’option DevelopmentMode pour installer des applications sans nécessiter de package d’application. Au lieu de cela, le moteur de déploiement traite directement le fichier AppxManifest.xml, ce qui permet un cycle de développement plus rapide. Les fichiers BlockMap.xml, [Content_Types].xml et signature numérique ne sont pas requis pour l’installation de l’application dans DevelopmentMode.
Pour installer correctement une application dans DevelopmentMode, elle doit remplir ces conditions supplémentaires au-delà de ce qui est généralement requis pour les applications UWP :
- L’application doit être unique au compte d’utilisateur actuel. Aucun autre utilisateur ne peut avoir une application avec le même nom de famille de package installé sur l’ordinateur.
- Si une version précédente de l’application a été installée, la version précédente doit également être installée dans DevelopmentMode. Les applications UWP ne peuvent pas être mises à jour avec une application DevelopmentMode et vice versa.
- L’application doit se trouver sur une partition NTFS (Microsoft Windows NT File System). Les partitions avec d’autres formats ne sont pas prises en charge.
- L’application doit se trouver sur un lecteur local. L’installation à partir d’emplacements réseau n’est pas prise en charge.
- L’application doit se trouver dans un emplacement non chiffré. L’installation à partir de répertoires chiffrés n’est pas prise en charge.
- L’application ne peut pas être installée à partir du répertoire WindowsApps. Si l’une des conditions précédentes n’est pas remplie, l’installation échoue.
En outre, pour simplifier et améliorer l’expérience de développement d’applications, ces comportements clés du système d’exploitation sont modifiés lorsqu’une application est installée dans DevelopmentMode :
- Les fichiers de charge utile d’application peuvent être modifiés. Si vous modifiez un fichier de charge utile d’application, les modifications sont répercutées la prochaine fois que l’application est lancée. Vous n’avez pas besoin de réinstaller l’application, sauf si vous modifiez le fichier AppxManifest.xml.
- La génération de bytecode et NGEN sont désactivées. La génération de bytecode JS et le NGEN binaire .NET sont désactivés sur les packages DevelopmentMode pour vous permettre de modifier les fichiers de charge utile sans réinstaller votre application.
- Les fichiers de charge utile de l’application ne sont pas supprimés lorsque l’application est désinstallée. Étant donné que ces fichiers sont potentiellement votre code source, Windows ne supprime pas ces fichiers lorsqu’une application est désinstallée.
- Le bouclage réseau est autorisé. Vous devez accepter le bouclage réseau comme décrit dans Comment activer le bouclage et résoudre les problèmes d’isolation réseau.
- L’application peut être lancée dans DesignMode. Pour plus d’informations sur la classe DesignMode, consultez Classe DesignMode.
Historique des versions
Version de Windows | Version du SDK | Valeur ajoutée |
---|---|---|
1703 | 15063 | RequiredContentGroupOnly |
1809 | 17763 | ForceUpdateFromAnyVersion |
1903 | 18362 | RetainFilesOnFailure |
2004 | 19041 | StageInPlace |