DeploymentOptions Énumération

Définition

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

S’applique à

Voir aussi