Microsoft.Windows.Management.Deployment Espace de noms

Spécifie les options de déploiement que vous pouvez configurer lorsque vous utilisez la méthode AddPackageByUriAsync pour ajouter un package, un manifeste de package ou un fichier App Installer.

Cet espace de noms fournit des API de gestion de package MSIX comparables à celles de la Windows. Management.Deployment espace de noms, mais avec des fonctionnalités supplémentaires, une expérience de développement améliorée et des optimisations des performances.

Ces API Windows Runtime (WinRT) vous permettent de déployer et de gérer des logiciels en tant que packages MSIX. Vous pouvez installer, mettre à jour, désinstaller, énumérer et gérer les packages. Voici les scénarios surux :

• Étape d’un package
• Inscrire un package
• Ajouter/mettre à jour un package
• Supprimer un package
• Réparer un package
• Réinitialiser un package
• Provisionner un package
• Déprovisionner un package

Les fonctionnalités supplémentaires incluent :

• IsReadyXxx. Déterminez si un package est prêt à être utilisé.
• EnsureReady. Déterminez si un package est prêt à être utilisé et, si ce n’est pas le cas, faites-le.
• IsPackageRegistrationPending. Déterminez s’il existe une mise à jour en attente d’inscription.
• PackagesSets. Opérations par lots.
• PackageRuntimeManager. Opérations batch à utiliser au moment de l’exécution via des dépendances dynamiques.
• Utilisabilité. Améliorations de la qualité de vie.

Structure d’API

Les méthodes permettant de piloter l’activité de déploiement suivent généralement le modèle :

<verb>Package[Set][By<Type>][Suffix]Async(target, options)

Les verbes suivants sont pris en charge :

• Est... Ready[OrNewerAvailable]
• Assurer... Prêt
• Ajouter
• Stage
• Register
• Supprimer
• Réparation
• Réinitialiser
• Approvisionnement
• Déprovisionner

Ces méthodes acceptent leur ou leurs packages cibles comme premier paramètre. Ce paramètre peut être différents types d’informations, notamment :

• Filename
• Path
• PackageFamilyName
• PackageFullName
• Uri

! [REMARQUE] Les méthodes avec une cible d’URI sont nommées ... ByUri....

! [REMARQUE] Les méthodes avec une cible d’un PackageFamilyName sont nommées ... ByPackageFamilyName....

! [REMARQUE] Les méthodes avec une cible d’un PackageFullName sont nommées ... ByPackageFullName....

! [REMARQUE] Méthodes sans ... Par<type>... qualificateur accepte une chaîne qui peut contenir un ou plusieurs types d’identificateurs. Ceux-ci peuvent varier pour différents verbes. Consultez la documentation de l’API pour connaître les types cibles spécifiques pris en charge par chaque méthode.

Ces méthodes acceptent les options en tant que type correspondant <verb>Package[Set]Options ; par exemple, AddPackageAsync(string packageUri, AddPackageOptions options).

Le tableau suivant présente les permutations prises en charge des verbes et des cibles :

Légende :

• OS = Pris en charge par les API Windows (OS) dans la classe Windows.Management.Deployment.PackageManager .
• WAS = Pris en charge par les API du Kit de développement logiciel (SDK) d’application Windows dans la classe Microsoft.Windows.Management.Deployment.PackageDeploymentManager .
• X = Non pris en charge

Usability

Les API de gestion des packages dans le Kit de développement logiciel (SDK) d’application Windows (Microsoft.Windows.Management.Deployment) offrent plusieurs améliorations de qualité de vie sur les API de gestion de package dans Windows.Management.Deployment (par exemple, PackageManager). Cela comprend :

• PackageManager.AddPackageByUriAsync échoue, retournant ERROR_INSTALL_PACKAGE_DOWNGRADE, si une version plus récente du package est déjà installée. Mais PackageDeploymentManager.AddPackageByUriAsync réussit, car il traite la requête comme « installer ce package ou une version ultérieure », de la façon dont les dépendances et d’autres références de package sont gérées régulièrement.
• PackageManager.AddPackageByUriAsync échoue, retournant ERROR_PACKAGE_ALREADY_EXISTS, si cette version exacte du package est déjà installée. PackageDeploymentManager.AddPackageByUriAsync réussit, car le package demandé est installé.
• De nombreuses opérations PackageManager acceptent un package cible en tant que fichier, mais nécessitent qu’il soit exprimé en tant qu’URI. PackageDeploymentManager fournit des remplacements qui l’acceptent également en tant que chaîne.
• PackageManager.RemovePackageByFullNameAsync échoue si le package spécifié est introuvable. PackageDeploymentManager réussit, car le package demandé n’est pas présent à la fin de l’opération.
  • Cela est dû au principe de déploiement principal qu’il n’a pas d’importance pour l’état précédent du système ; que l’état final souhaité est atteint.
• Les méthodes PackageManager acceptent des permutations incohérentes (et souvent peu fréquentes) d’expression d’un package cible. Par exemple, PackageManager prend en charge la suppression d’un package par nom complet du package, mais pas par nom de famille de package. PackageDeploymentManager fournit une API plus riche qui accepte des identificateurs supplémentaires.

Support de la plateforme

Ces API sont disponibles uniquement sur Windows 10, version 2004 (10.0 ; Build 19041) et versions ultérieures.

Un sous-ensemble de fonctionnalités est disponible sur les versions plus récentes. Par exemple, AddPackageOptions.ExpectedDigests nécessite Windows 11, version 22H2 (10.0 ; Build 22621) ou version ultérieure. Toutes les fonctionnalités nécessitant une version de Windows plus récente que Windows 10, version 2004 (10.0 ; La base de référence de build 19041) présente des affordances pour détecter au moment de l’exécution si la plateforme actuelle prend en charge la fonctionnalité, par exemple :

var options = new AddPackageOptions();
if (options.IsLimitToExistingPackagesSupported)
{
    options.LimitToExistingPackages = true;
}

Cet espace de noms fournit des API de gestion de package MSIX comparables à celles de la Windows. Management.Deployment espace de noms, mais avec des fonctionnalités supplémentaires, une expérience de développement améliorée et des optimisations des performances.

Ces API Windows Runtime (WinRT) vous permettent de déployer et de gérer des logiciels en tant que packages MSIX. Vous pouvez installer, mettre à jour, désinstaller, énumérer et gérer les packages. Voici les scénarios surux :

• Étape d’un package
• Inscrire un package
• Ajouter/mettre à jour un package
• Supprimer un package
• Réparer un package
• Réinitialiser un package
• Provisionner un package
• Déprovisionner un package

Les fonctionnalités supplémentaires incluent :

• IsReadyXxx. Déterminez si un package est prêt à être utilisé.
• EnsureReady. Déterminez si un package est prêt à être utilisé et, si ce n’est pas le cas, faites-le.
• IsPackageRegistrationPending. Déterminez s’il existe une mise à jour en attente d’inscription.
• PackagesSets. Opérations par lots.
• PackageRuntimeManager. Opérations batch à utiliser au moment de l’exécution via des dépendances dynamiques.
• Utilisabilité. Améliorations de la qualité de vie.

Structure d’API

Les méthodes permettant de piloter l’activité de déploiement suivent généralement le modèle :

<verb>Package[Set][By<Type>][Suffix]Async(target, options)

Les verbes suivants sont pris en charge :

• Est... Ready[OrNewerAvailable]
• Assurer... Prêt
• Ajouter
• Stage
• Register
• Supprimer
• Réparation
• Réinitialiser
• Approvisionnement
• Déprovisionner

Ces méthodes acceptent leur ou leurs packages cibles comme premier paramètre. Ce paramètre peut être différents types d’informations, notamment :

• Filename
• Path
• PackageFamilyName
• PackageFullName
• Uri

! [REMARQUE] Les méthodes avec une cible d’URI sont nommées ... ByUri....

! [REMARQUE] Les méthodes avec une cible d’un PackageFamilyName sont nommées ... ByPackageFamilyName....

! [REMARQUE] Les méthodes avec une cible d’un PackageFullName sont nommées ... ByPackageFullName....

! [REMARQUE] Méthodes sans ... Par<type>... qualificateur accepte une chaîne qui peut contenir un ou plusieurs types d’identificateurs. Ceux-ci peuvent varier pour différents verbes. Consultez la documentation de l’API pour connaître les types cibles spécifiques pris en charge par chaque méthode.

Ces méthodes acceptent les options en tant que type correspondant <verb>Package[Set]Options ; par exemple, AddPackageAsync(string packageUri, AddPackageOptions options).

Le tableau suivant présente les permutations prises en charge des verbes et des cibles :

Légende :

• OS = Pris en charge par les API Windows (OS) dans la classe Windows.Management.Deployment.PackageManager .
• WAS = Pris en charge par les API du Kit de développement logiciel (SDK) d’application Windows dans la classe Microsoft.Windows.Management.Deployment.PackageDeploymentManager .
• X = Non pris en charge

Usability

Les API de gestion des packages dans le Kit de développement logiciel (SDK) d’application Windows (Microsoft.Windows.Management.Deployment) offrent plusieurs améliorations de qualité de vie sur les API de gestion de package dans Windows.Management.Deployment (par exemple, PackageManager). Cela comprend :

• PackageManager.AddPackageByUriAsync échoue, retournant ERROR_INSTALL_PACKAGE_DOWNGRADE, si une version plus récente du package est déjà installée. Mais PackageDeploymentManager.AddPackageByUriAsync réussit, car il traite la requête comme « installer ce package ou une version ultérieure », de la façon dont les dépendances et d’autres références de package sont gérées régulièrement.
• PackageManager.AddPackageByUriAsync échoue, retournant ERROR_PACKAGE_ALREADY_EXISTS, si cette version exacte du package est déjà installée. PackageDeploymentManager.AddPackageByUriAsync réussit, car le package demandé est installé.
• De nombreuses opérations PackageManager acceptent un package cible en tant que fichier, mais nécessitent qu’il soit exprimé en tant qu’URI. PackageDeploymentManager fournit des remplacements qui l’acceptent également en tant que chaîne.
• PackageManager.RemovePackageByFullNameAsync échoue si le package spécifié est introuvable. PackageDeploymentManager réussit, car le package demandé n’est pas présent à la fin de l’opération.
  • Cela est dû au principe de déploiement principal qu’il n’a pas d’importance pour l’état précédent du système ; que l’état final souhaité est atteint.
• Les méthodes PackageManager acceptent des permutations incohérentes (et souvent peu fréquentes) d’expression d’un package cible. Par exemple, PackageManager prend en charge la suppression d’un package par nom complet du package, mais pas par nom de famille de package. PackageDeploymentManager fournit une API plus riche qui accepte des identificateurs supplémentaires.

Support de la plateforme

Ces API sont disponibles uniquement sur Windows 10, version 2004 (10.0 ; Build 19041) et versions ultérieures.

Un sous-ensemble de fonctionnalités est disponible sur les versions plus récentes. Par exemple, AddPackageOptions.ExpectedDigests nécessite Windows 11, version 22H2 (10.0 ; Build 22621) ou version ultérieure. Toutes les fonctionnalités nécessitant une version de Windows plus récente que Windows 10, version 2004 (10.0 ; La base de référence de build 19041) présente des affordances pour détecter au moment de l’exécution si la plateforme actuelle prend en charge la fonctionnalité, par exemple :

var options = new AddPackageOptions();
if (options.IsLimitToExistingPackagesSupported)
{
    options.LimitToExistingPackages = true;
}

Gère le logiciel disponible pour un utilisateur.

Fournit le résultat d’une demande de déploiement.

Cet espace de noms fournit des API de gestion de package MSIX comparables à celles de la Windows. Management.Deployment espace de noms, mais avec des fonctionnalités supplémentaires, une expérience de développement améliorée et des optimisations des performances.

Ces API Windows Runtime (WinRT) vous permettent de déployer et de gérer des logiciels en tant que packages MSIX. Vous pouvez installer, mettre à jour, désinstaller, énumérer et gérer les packages. Voici les scénarios surux :

• Étape d’un package
• Inscrire un package
• Ajouter/mettre à jour un package
• Supprimer un package
• Réparer un package
• Réinitialiser un package
• Provisionner un package
• Déprovisionner un package

Les fonctionnalités supplémentaires incluent :

• IsReadyXxx. Déterminez si un package est prêt à être utilisé.
• EnsureReady. Déterminez si un package est prêt à être utilisé et, si ce n’est pas le cas, faites-le.
• IsPackageRegistrationPending. Déterminez s’il existe une mise à jour en attente d’inscription.
• PackagesSets. Opérations par lots.
• PackageRuntimeManager. Opérations batch à utiliser au moment de l’exécution via des dépendances dynamiques.
• Utilisabilité. Améliorations de la qualité de vie.

Structure d’API

Les méthodes permettant de piloter l’activité de déploiement suivent généralement le modèle :

<verb>Package[Set][By<Type>][Suffix]Async(target, options)

Les verbes suivants sont pris en charge :

• Est... Ready[OrNewerAvailable]
• Assurer... Prêt
• Ajouter
• Stage
• Register
• Supprimer
• Réparation
• Réinitialiser
• Approvisionnement
• Déprovisionner

Ces méthodes acceptent leur ou leurs packages cibles comme premier paramètre. Ce paramètre peut être différents types d’informations, notamment :

• Filename
• Path
• PackageFamilyName
• PackageFullName
• Uri

! [REMARQUE] Les méthodes avec une cible d’URI sont nommées ... ByUri....

! [REMARQUE] Les méthodes avec une cible d’un PackageFamilyName sont nommées ... ByPackageFamilyName....

! [REMARQUE] Les méthodes avec une cible d’un PackageFullName sont nommées ... ByPackageFullName....

! [REMARQUE] Méthodes sans ... Par<type>... qualificateur accepte une chaîne qui peut contenir un ou plusieurs types d’identificateurs. Ceux-ci peuvent varier pour différents verbes. Consultez la documentation de l’API pour connaître les types cibles spécifiques pris en charge par chaque méthode.

Ces méthodes acceptent les options en tant que type correspondant <verb>Package[Set]Options ; par exemple, AddPackageAsync(string packageUri, AddPackageOptions options).

Le tableau suivant présente les permutations prises en charge des verbes et des cibles :

Légende :

• OS = Pris en charge par les API Windows (OS) dans la classe Windows.Management.Deployment.PackageManager .
• WAS = Pris en charge par les API du Kit de développement logiciel (SDK) d’application Windows dans la classe Microsoft.Windows.Management.Deployment.PackageDeploymentManager .
• X = Non pris en charge

Usability

Les API de gestion des packages dans le Kit de développement logiciel (SDK) d’application Windows (Microsoft.Windows.Management.Deployment) offrent plusieurs améliorations de qualité de vie sur les API de gestion de package dans Windows.Management.Deployment (par exemple, PackageManager). Cela comprend :

• PackageManager.AddPackageByUriAsync échoue, retournant ERROR_INSTALL_PACKAGE_DOWNGRADE, si une version plus récente du package est déjà installée. Mais PackageDeploymentManager.AddPackageByUriAsync réussit, car il traite la requête comme « installer ce package ou une version ultérieure », de la façon dont les dépendances et d’autres références de package sont gérées régulièrement.
• PackageManager.AddPackageByUriAsync échoue, retournant ERROR_PACKAGE_ALREADY_EXISTS, si cette version exacte du package est déjà installée. PackageDeploymentManager.AddPackageByUriAsync réussit, car le package demandé est installé.
• De nombreuses opérations PackageManager acceptent un package cible en tant que fichier, mais nécessitent qu’il soit exprimé en tant qu’URI. PackageDeploymentManager fournit des remplacements qui l’acceptent également en tant que chaîne.
• PackageManager.RemovePackageByFullNameAsync échoue si le package spécifié est introuvable. PackageDeploymentManager réussit, car le package demandé n’est pas présent à la fin de l’opération.
  • Cela est dû au principe de déploiement principal qu’il n’a pas d’importance pour l’état précédent du système ; que l’état final souhaité est atteint.
• Les méthodes PackageManager acceptent des permutations incohérentes (et souvent peu fréquentes) d’expression d’un package cible. Par exemple, PackageManager prend en charge la suppression d’un package par nom complet du package, mais pas par nom de famille de package. PackageDeploymentManager fournit une API plus riche qui accepte des identificateurs supplémentaires.

Support de la plateforme

Ces API sont disponibles uniquement sur Windows 10, version 2004 (10.0 ; Build 19041) et versions ultérieures.

Un sous-ensemble de fonctionnalités est disponible sur les versions plus récentes. Par exemple, AddPackageOptions.ExpectedDigests nécessite Windows 11, version 22H2 (10.0 ; Build 22621) ou version ultérieure. Toutes les fonctionnalités nécessitant une version de Windows plus récente que Windows 10, version 2004 (10.0 ; La base de référence de build 19041) présente des affordances pour détecter au moment de l’exécution si la plateforme actuelle prend en charge la fonctionnalité, par exemple :

var options = new AddPackageOptions();
if (options.IsLimitToExistingPackagesSupported)
{
    options.LimitToExistingPackages = true;
}

Cet espace de noms fournit des API de gestion de package MSIX comparables à celles de la Windows. Management.Deployment espace de noms, mais avec des fonctionnalités supplémentaires, une expérience de développement améliorée et des optimisations des performances.

Ces API Windows Runtime (WinRT) vous permettent de déployer et de gérer des logiciels en tant que packages MSIX. Vous pouvez installer, mettre à jour, désinstaller, énumérer et gérer les packages. Voici les scénarios surux :

• Étape d’un package
• Inscrire un package
• Ajouter/mettre à jour un package
• Supprimer un package
• Réparer un package
• Réinitialiser un package
• Provisionner un package
• Déprovisionner un package

Les fonctionnalités supplémentaires incluent :

• IsReadyXxx. Déterminez si un package est prêt à être utilisé.
• EnsureReady. Déterminez si un package est prêt à être utilisé et, si ce n’est pas le cas, faites-le.
• IsPackageRegistrationPending. Déterminez s’il existe une mise à jour en attente d’inscription.
• PackagesSets. Opérations par lots.
• PackageRuntimeManager. Opérations batch à utiliser au moment de l’exécution via des dépendances dynamiques.
• Utilisabilité. Améliorations de la qualité de vie.

Structure d’API

Les méthodes permettant de piloter l’activité de déploiement suivent généralement le modèle :

<verb>Package[Set][By<Type>][Suffix]Async(target, options)

Les verbes suivants sont pris en charge :

• Est... Ready[OrNewerAvailable]
• Assurer... Prêt
• Ajouter
• Stage
• Register
• Supprimer
• Réparation
• Réinitialiser
• Approvisionnement
• Déprovisionner

Ces méthodes acceptent leur ou leurs packages cibles comme premier paramètre. Ce paramètre peut être différents types d’informations, notamment :

• Filename
• Path
• PackageFamilyName
• PackageFullName
• Uri

! [REMARQUE] Les méthodes avec une cible d’URI sont nommées ... ByUri....

! [REMARQUE] Les méthodes avec une cible d’un PackageFamilyName sont nommées ... ByPackageFamilyName....

! [REMARQUE] Les méthodes avec une cible d’un PackageFullName sont nommées ... ByPackageFullName....

! [REMARQUE] Méthodes sans ... Par<type>... qualificateur accepte une chaîne qui peut contenir un ou plusieurs types d’identificateurs. Ceux-ci peuvent varier pour différents verbes. Consultez la documentation de l’API pour connaître les types cibles spécifiques pris en charge par chaque méthode.

Ces méthodes acceptent les options en tant que type correspondant <verb>Package[Set]Options ; par exemple, AddPackageAsync(string packageUri, AddPackageOptions options).

Le tableau suivant présente les permutations prises en charge des verbes et des cibles :

Légende :

• OS = Pris en charge par les API Windows (OS) dans la classe Windows.Management.Deployment.PackageManager .
• WAS = Pris en charge par les API du Kit de développement logiciel (SDK) d’application Windows dans la classe Microsoft.Windows.Management.Deployment.PackageDeploymentManager .
• X = Non pris en charge

Usability

Les API de gestion des packages dans le Kit de développement logiciel (SDK) d’application Windows (Microsoft.Windows.Management.Deployment) offrent plusieurs améliorations de qualité de vie sur les API de gestion de package dans Windows.Management.Deployment (par exemple, PackageManager). Cela comprend :

• PackageManager.AddPackageByUriAsync échoue, retournant ERROR_INSTALL_PACKAGE_DOWNGRADE, si une version plus récente du package est déjà installée. Mais PackageDeploymentManager.AddPackageByUriAsync réussit, car il traite la requête comme « installer ce package ou une version ultérieure », de la façon dont les dépendances et d’autres références de package sont gérées régulièrement.
• PackageManager.AddPackageByUriAsync échoue, retournant ERROR_PACKAGE_ALREADY_EXISTS, si cette version exacte du package est déjà installée. PackageDeploymentManager.AddPackageByUriAsync réussit, car le package demandé est installé.
• De nombreuses opérations PackageManager acceptent un package cible en tant que fichier, mais nécessitent qu’il soit exprimé en tant qu’URI. PackageDeploymentManager fournit des remplacements qui l’acceptent également en tant que chaîne.
• PackageManager.RemovePackageByFullNameAsync échoue si le package spécifié est introuvable. PackageDeploymentManager réussit, car le package demandé n’est pas présent à la fin de l’opération.
  • Cela est dû au principe de déploiement principal qu’il n’a pas d’importance pour l’état précédent du système ; que l’état final souhaité est atteint.
• Les méthodes PackageManager acceptent des permutations incohérentes (et souvent peu fréquentes) d’expression d’un package cible. Par exemple, PackageManager prend en charge la suppression d’un package par nom complet du package, mais pas par nom de famille de package. PackageDeploymentManager fournit une API plus riche qui accepte des identificateurs supplémentaires.

Support de la plateforme

Ces API sont disponibles uniquement sur Windows 10, version 2004 (10.0 ; Build 19041) et versions ultérieures.

Un sous-ensemble de fonctionnalités est disponible sur les versions plus récentes. Par exemple, AddPackageOptions.ExpectedDigests nécessite Windows 11, version 22H2 (10.0 ; Build 22621) ou version ultérieure. Toutes les fonctionnalités nécessitant une version de Windows plus récente que Windows 10, version 2004 (10.0 ; La base de référence de build 19041) présente des affordances pour détecter au moment de l’exécution si la plateforme actuelle prend en charge la fonctionnalité, par exemple :

var options = new AddPackageOptions();
if (options.IsLimitToExistingPackagesSupported)
{
    options.LimitToExistingPackages = true;
}

La classe PackageRuntimeManager fournit la prise en charge des dépendances dynamiques pour les opérations PackageSet , en particulier lorsque l’appelant risque de ne pas connaître le ou les packages exacts impliqués, par exemple lors du ciblage de packages via ms-uup:. PackageRuntimeManager détermine les packages impliqués pour un PackageSet et les ajoute dynamiquement au graphique de package de l’appelant.

Classe qui représente un ensemble de packages, qui est un groupe de packages à utiliser avec une requête. Un ensemble de packages fournit un moyen pratique d’effectuer plusieurs opérations.

! [REMARQUE] Il n’existe aucune garantie de classement des éléments traités dans un PackageSet.

Représente un package dans un PackageSet.

Cet espace de noms fournit des API de gestion de package MSIX comparables à celles de la Windows. Management.Deployment espace de noms, mais avec des fonctionnalités supplémentaires, une expérience de développement améliorée et des optimisations des performances.

Ces API Windows Runtime (WinRT) vous permettent de déployer et de gérer des logiciels en tant que packages MSIX. Vous pouvez installer, mettre à jour, désinstaller, énumérer et gérer les packages. Voici les scénarios surux :

• Étape d’un package
• Inscrire un package
• Ajouter/mettre à jour un package
• Supprimer un package
• Réparer un package
• Réinitialiser un package
• Provisionner un package
• Déprovisionner un package

Les fonctionnalités supplémentaires incluent :

• IsReadyXxx. Déterminez si un package est prêt à être utilisé.
• EnsureReady. Déterminez si un package est prêt à être utilisé et, si ce n’est pas le cas, faites-le.
• IsPackageRegistrationPending. Déterminez s’il existe une mise à jour en attente d’inscription.
• PackagesSets. Opérations par lots.
• PackageRuntimeManager. Opérations batch à utiliser au moment de l’exécution via des dépendances dynamiques.
• Utilisabilité. Améliorations de la qualité de vie.

Structure d’API

Les méthodes permettant de piloter l’activité de déploiement suivent généralement le modèle :

<verb>Package[Set][By<Type>][Suffix]Async(target, options)

Les verbes suivants sont pris en charge :

• Est... Ready[OrNewerAvailable]
• Assurer... Prêt
• Ajouter
• Stage
• Register
• Supprimer
• Réparation
• Réinitialiser
• Approvisionnement
• Déprovisionner

Ces méthodes acceptent leur ou leurs packages cibles comme premier paramètre. Ce paramètre peut être différents types d’informations, notamment :

• Filename
• Path
• PackageFamilyName
• PackageFullName
• Uri

! [REMARQUE] Les méthodes avec une cible d’URI sont nommées ... ByUri....

! [REMARQUE] Les méthodes avec une cible d’un PackageFamilyName sont nommées ... ByPackageFamilyName....

! [REMARQUE] Les méthodes avec une cible d’un PackageFullName sont nommées ... ByPackageFullName....

! [REMARQUE] Méthodes sans ... Par<type>... qualificateur accepte une chaîne qui peut contenir un ou plusieurs types d’identificateurs. Ceux-ci peuvent varier pour différents verbes. Consultez la documentation de l’API pour connaître les types cibles spécifiques pris en charge par chaque méthode.

Ces méthodes acceptent les options en tant que type correspondant <verb>Package[Set]Options ; par exemple, AddPackageAsync(string packageUri, AddPackageOptions options).

Le tableau suivant présente les permutations prises en charge des verbes et des cibles :

Légende :

• OS = Pris en charge par les API Windows (OS) dans la classe Windows.Management.Deployment.PackageManager .
• WAS = Pris en charge par les API du Kit de développement logiciel (SDK) d’application Windows dans la classe Microsoft.Windows.Management.Deployment.PackageDeploymentManager .
• X = Non pris en charge

Usability

Les API de gestion des packages dans le Kit de développement logiciel (SDK) d’application Windows (Microsoft.Windows.Management.Deployment) offrent plusieurs améliorations de qualité de vie sur les API de gestion de package dans Windows.Management.Deployment (par exemple, PackageManager). Cela comprend :

• PackageManager.AddPackageByUriAsync échoue, retournant ERROR_INSTALL_PACKAGE_DOWNGRADE, si une version plus récente du package est déjà installée. Mais PackageDeploymentManager.AddPackageByUriAsync réussit, car il traite la requête comme « installer ce package ou une version ultérieure », de la façon dont les dépendances et d’autres références de package sont gérées régulièrement.
• PackageManager.AddPackageByUriAsync échoue, retournant ERROR_PACKAGE_ALREADY_EXISTS, si cette version exacte du package est déjà installée. PackageDeploymentManager.AddPackageByUriAsync réussit, car le package demandé est installé.
• De nombreuses opérations PackageManager acceptent un package cible en tant que fichier, mais nécessitent qu’il soit exprimé en tant qu’URI. PackageDeploymentManager fournit des remplacements qui l’acceptent également en tant que chaîne.
• PackageManager.RemovePackageByFullNameAsync échoue si le package spécifié est introuvable. PackageDeploymentManager réussit, car le package demandé n’est pas présent à la fin de l’opération.
  • Cela est dû au principe de déploiement principal qu’il n’a pas d’importance pour l’état précédent du système ; que l’état final souhaité est atteint.
• Les méthodes PackageManager acceptent des permutations incohérentes (et souvent peu fréquentes) d’expression d’un package cible. Par exemple, PackageManager prend en charge la suppression d’un package par nom complet du package, mais pas par nom de famille de package. PackageDeploymentManager fournit une API plus riche qui accepte des identificateurs supplémentaires.

Support de la plateforme

Ces API sont disponibles uniquement sur Windows 10, version 2004 (10.0 ; Build 19041) et versions ultérieures.

Un sous-ensemble de fonctionnalités est disponible sur les versions plus récentes. Par exemple, AddPackageOptions.ExpectedDigests nécessite Windows 11, version 22H2 (10.0 ; Build 22621) ou version ultérieure. Toutes les fonctionnalités nécessitant une version de Windows plus récente que Windows 10, version 2004 (10.0 ; La base de référence de build 19041) présente des affordances pour détecter au moment de l’exécution si la plateforme actuelle prend en charge la fonctionnalité, par exemple :

var options = new AddPackageOptions();
if (options.IsLimitToExistingPackagesSupported)
{
    options.LimitToExistingPackages = true;
}

Cet espace de noms fournit des API de gestion de package MSIX comparables à celles de la Windows. Management.Deployment espace de noms, mais avec des fonctionnalités supplémentaires, une expérience de développement améliorée et des optimisations des performances.

Ces API Windows Runtime (WinRT) vous permettent de déployer et de gérer des logiciels en tant que packages MSIX. Vous pouvez installer, mettre à jour, désinstaller, énumérer et gérer les packages. Voici les scénarios surux :

• Étape d’un package
• Inscrire un package
• Ajouter/mettre à jour un package
• Supprimer un package
• Réparer un package
• Réinitialiser un package
• Provisionner un package
• Déprovisionner un package

Les fonctionnalités supplémentaires incluent :

• IsReadyXxx. Déterminez si un package est prêt à être utilisé.
• EnsureReady. Déterminez si un package est prêt à être utilisé et, si ce n’est pas le cas, faites-le.
• IsPackageRegistrationPending. Déterminez s’il existe une mise à jour en attente d’inscription.
• PackagesSets. Opérations par lots.
• PackageRuntimeManager. Opérations batch à utiliser au moment de l’exécution via des dépendances dynamiques.
• Utilisabilité. Améliorations de la qualité de vie.

Structure d’API

Les méthodes permettant de piloter l’activité de déploiement suivent généralement le modèle :

<verb>Package[Set][By<Type>][Suffix]Async(target, options)

Les verbes suivants sont pris en charge :

• Est... Ready[OrNewerAvailable]
• Assurer... Prêt
• Ajouter
• Stage
• Register
• Supprimer
• Réparation
• Réinitialiser
• Approvisionnement
• Déprovisionner

Ces méthodes acceptent leur ou leurs packages cibles comme premier paramètre. Ce paramètre peut être différents types d’informations, notamment :

• Filename
• Path
• PackageFamilyName
• PackageFullName
• Uri

! [REMARQUE] Les méthodes avec une cible d’URI sont nommées ... ByUri....

! [REMARQUE] Les méthodes avec une cible d’un PackageFamilyName sont nommées ... ByPackageFamilyName....

! [REMARQUE] Les méthodes avec une cible d’un PackageFullName sont nommées ... ByPackageFullName....

! [REMARQUE] Méthodes sans ... Par<type>... qualificateur accepte une chaîne qui peut contenir un ou plusieurs types d’identificateurs. Ceux-ci peuvent varier pour différents verbes. Consultez la documentation de l’API pour connaître les types cibles spécifiques pris en charge par chaque méthode.

Ces méthodes acceptent les options en tant que type correspondant <verb>Package[Set]Options ; par exemple, AddPackageAsync(string packageUri, AddPackageOptions options).

Le tableau suivant présente les permutations prises en charge des verbes et des cibles :

Légende :

• OS = Pris en charge par les API Windows (OS) dans la classe Windows.Management.Deployment.PackageManager .
• WAS = Pris en charge par les API du Kit de développement logiciel (SDK) d’application Windows dans la classe Microsoft.Windows.Management.Deployment.PackageDeploymentManager .
• X = Non pris en charge

Usability

Les API de gestion des packages dans le Kit de développement logiciel (SDK) d’application Windows (Microsoft.Windows.Management.Deployment) offrent plusieurs améliorations de qualité de vie sur les API de gestion de package dans Windows.Management.Deployment (par exemple, PackageManager). Cela comprend :

• PackageManager.AddPackageByUriAsync échoue, retournant ERROR_INSTALL_PACKAGE_DOWNGRADE, si une version plus récente du package est déjà installée. Mais PackageDeploymentManager.AddPackageByUriAsync réussit, car il traite la requête comme « installer ce package ou une version ultérieure », de la façon dont les dépendances et d’autres références de package sont gérées régulièrement.
• PackageManager.AddPackageByUriAsync échoue, retournant ERROR_PACKAGE_ALREADY_EXISTS, si cette version exacte du package est déjà installée. PackageDeploymentManager.AddPackageByUriAsync réussit, car le package demandé est installé.
• De nombreuses opérations PackageManager acceptent un package cible en tant que fichier, mais nécessitent qu’il soit exprimé en tant qu’URI. PackageDeploymentManager fournit des remplacements qui l’acceptent également en tant que chaîne.
• PackageManager.RemovePackageByFullNameAsync échoue si le package spécifié est introuvable. PackageDeploymentManager réussit, car le package demandé n’est pas présent à la fin de l’opération.
  • Cela est dû au principe de déploiement principal qu’il n’a pas d’importance pour l’état précédent du système ; que l’état final souhaité est atteint.
• Les méthodes PackageManager acceptent des permutations incohérentes (et souvent peu fréquentes) d’expression d’un package cible. Par exemple, PackageManager prend en charge la suppression d’un package par nom complet du package, mais pas par nom de famille de package. PackageDeploymentManager fournit une API plus riche qui accepte des identificateurs supplémentaires.

Support de la plateforme

Ces API sont disponibles uniquement sur Windows 10, version 2004 (10.0 ; Build 19041) et versions ultérieures.

Un sous-ensemble de fonctionnalités est disponible sur les versions plus récentes. Par exemple, AddPackageOptions.ExpectedDigests nécessite Windows 11, version 22H2 (10.0 ; Build 22621) ou version ultérieure. Toutes les fonctionnalités nécessitant une version de Windows plus récente que Windows 10, version 2004 (10.0 ; La base de référence de build 19041) présente des affordances pour détecter au moment de l’exécution si la plateforme actuelle prend en charge la fonctionnalité, par exemple :

var options = new AddPackageOptions();
if (options.IsLimitToExistingPackagesSupported)
{
    options.LimitToExistingPackages = true;
}

Cet espace de noms fournit des API de gestion de package MSIX comparables à celles de la Windows. Management.Deployment espace de noms, mais avec des fonctionnalités supplémentaires, une expérience de développement améliorée et des optimisations des performances.

Ces API Windows Runtime (WinRT) vous permettent de déployer et de gérer des logiciels en tant que packages MSIX. Vous pouvez installer, mettre à jour, désinstaller, énumérer et gérer les packages. Voici les scénarios surux :

• Étape d’un package
• Inscrire un package
• Ajouter/mettre à jour un package
• Supprimer un package
• Réparer un package
• Réinitialiser un package
• Provisionner un package
• Déprovisionner un package

Les fonctionnalités supplémentaires incluent :

• IsReadyXxx. Déterminez si un package est prêt à être utilisé.
• EnsureReady. Déterminez si un package est prêt à être utilisé et, si ce n’est pas le cas, faites-le.
• IsPackageRegistrationPending. Déterminez s’il existe une mise à jour en attente d’inscription.
• PackagesSets. Opérations par lots.
• PackageRuntimeManager. Opérations batch à utiliser au moment de l’exécution via des dépendances dynamiques.
• Utilisabilité. Améliorations de la qualité de vie.

Structure d’API

Les méthodes permettant de piloter l’activité de déploiement suivent généralement le modèle :

<verb>Package[Set][By<Type>][Suffix]Async(target, options)

Les verbes suivants sont pris en charge :

• Est... Ready[OrNewerAvailable]
• Assurer... Prêt
• Ajouter
• Stage
• Register
• Supprimer
• Réparation
• Réinitialiser
• Approvisionnement
• Déprovisionner

Ces méthodes acceptent leur ou leurs packages cibles comme premier paramètre. Ce paramètre peut être différents types d’informations, notamment :

• Filename
• Path
• PackageFamilyName
• PackageFullName
• Uri

! [REMARQUE] Les méthodes avec une cible d’URI sont nommées ... ByUri....

! [REMARQUE] Les méthodes avec une cible d’un PackageFamilyName sont nommées ... ByPackageFamilyName....

! [REMARQUE] Les méthodes avec une cible d’un PackageFullName sont nommées ... ByPackageFullName....

! [REMARQUE] Méthodes sans ... Par<type>... qualificateur accepte une chaîne qui peut contenir un ou plusieurs types d’identificateurs. Ceux-ci peuvent varier pour différents verbes. Consultez la documentation de l’API pour connaître les types cibles spécifiques pris en charge par chaque méthode.

Ces méthodes acceptent les options en tant que type correspondant <verb>Package[Set]Options ; par exemple, AddPackageAsync(string packageUri, AddPackageOptions options).

Le tableau suivant présente les permutations prises en charge des verbes et des cibles :

Légende :

• OS = Pris en charge par les API Windows (OS) dans la classe Windows.Management.Deployment.PackageManager .
• WAS = Pris en charge par les API du Kit de développement logiciel (SDK) d’application Windows dans la classe Microsoft.Windows.Management.Deployment.PackageDeploymentManager .
• X = Non pris en charge

Usability

Les API de gestion des packages dans le Kit de développement logiciel (SDK) d’application Windows (Microsoft.Windows.Management.Deployment) offrent plusieurs améliorations de qualité de vie sur les API de gestion de package dans Windows.Management.Deployment (par exemple, PackageManager). Cela comprend :

• PackageManager.AddPackageByUriAsync échoue, retournant ERROR_INSTALL_PACKAGE_DOWNGRADE, si une version plus récente du package est déjà installée. Mais PackageDeploymentManager.AddPackageByUriAsync réussit, car il traite la requête comme « installer ce package ou une version ultérieure », de la façon dont les dépendances et d’autres références de package sont gérées régulièrement.
• PackageManager.AddPackageByUriAsync échoue, retournant ERROR_PACKAGE_ALREADY_EXISTS, si cette version exacte du package est déjà installée. PackageDeploymentManager.AddPackageByUriAsync réussit, car le package demandé est installé.
• De nombreuses opérations PackageManager acceptent un package cible en tant que fichier, mais nécessitent qu’il soit exprimé en tant qu’URI. PackageDeploymentManager fournit des remplacements qui l’acceptent également en tant que chaîne.
• PackageManager.RemovePackageByFullNameAsync échoue si le package spécifié est introuvable. PackageDeploymentManager réussit, car le package demandé n’est pas présent à la fin de l’opération.
  • Cela est dû au principe de déploiement principal qu’il n’a pas d’importance pour l’état précédent du système ; que l’état final souhaité est atteint.
• Les méthodes PackageManager acceptent des permutations incohérentes (et souvent peu fréquentes) d’expression d’un package cible. Par exemple, PackageManager prend en charge la suppression d’un package par nom complet du package, mais pas par nom de famille de package. PackageDeploymentManager fournit une API plus riche qui accepte des identificateurs supplémentaires.

Support de la plateforme

Ces API sont disponibles uniquement sur Windows 10, version 2004 (10.0 ; Build 19041) et versions ultérieures.

Un sous-ensemble de fonctionnalités est disponible sur les versions plus récentes. Par exemple, AddPackageOptions.ExpectedDigests nécessite Windows 11, version 22H2 (10.0 ; Build 22621) ou version ultérieure. Toutes les fonctionnalités nécessitant une version de Windows plus récente que Windows 10, version 2004 (10.0 ; La base de référence de build 19041) présente des affordances pour détecter au moment de l’exécution si la plateforme actuelle prend en charge la fonctionnalité, par exemple :

var options = new AddPackageOptions();
if (options.IsLimitToExistingPackagesSupported)
{
    options.LimitToExistingPackages = true;
}

Cet espace de noms fournit des API de gestion de package MSIX comparables à celles de la Windows. Management.Deployment espace de noms, mais avec des fonctionnalités supplémentaires, une expérience de développement améliorée et des optimisations des performances.

Ces API Windows Runtime (WinRT) vous permettent de déployer et de gérer des logiciels en tant que packages MSIX. Vous pouvez installer, mettre à jour, désinstaller, énumérer et gérer les packages. Voici les scénarios surux :

• Étape d’un package
• Inscrire un package
• Ajouter/mettre à jour un package
• Supprimer un package
• Réparer un package
• Réinitialiser un package
• Provisionner un package
• Déprovisionner un package

Les fonctionnalités supplémentaires incluent :

• IsReadyXxx. Déterminez si un package est prêt à être utilisé.
• EnsureReady. Déterminez si un package est prêt à être utilisé et, si ce n’est pas le cas, faites-le.
• IsPackageRegistrationPending. Déterminez s’il existe une mise à jour en attente d’inscription.
• PackagesSets. Opérations par lots.
• PackageRuntimeManager. Opérations batch à utiliser au moment de l’exécution via des dépendances dynamiques.
• Utilisabilité. Améliorations de la qualité de vie.

Structure d’API

Les méthodes permettant de piloter l’activité de déploiement suivent généralement le modèle :

<verb>Package[Set][By<Type>][Suffix]Async(target, options)

Les verbes suivants sont pris en charge :

• Est... Ready[OrNewerAvailable]
• Assurer... Prêt
• Ajouter
• Stage
• Register
• Supprimer
• Réparation
• Réinitialiser
• Approvisionnement
• Déprovisionner

Ces méthodes acceptent leur ou leurs packages cibles comme premier paramètre. Ce paramètre peut être différents types d’informations, notamment :

• Filename
• Path
• PackageFamilyName
• PackageFullName
• Uri

! [REMARQUE] Les méthodes avec une cible d’URI sont nommées ... ByUri....

! [REMARQUE] Les méthodes avec une cible d’un PackageFamilyName sont nommées ... ByPackageFamilyName....

! [REMARQUE] Les méthodes avec une cible d’un PackageFullName sont nommées ... ByPackageFullName....

! [REMARQUE] Méthodes sans ... Par<type>... qualificateur accepte une chaîne qui peut contenir un ou plusieurs types d’identificateurs. Ceux-ci peuvent varier pour différents verbes. Consultez la documentation de l’API pour connaître les types cibles spécifiques pris en charge par chaque méthode.

Ces méthodes acceptent les options en tant que type correspondant <verb>Package[Set]Options ; par exemple, AddPackageAsync(string packageUri, AddPackageOptions options).

Le tableau suivant présente les permutations prises en charge des verbes et des cibles :

Légende :

• OS = Pris en charge par les API Windows (OS) dans la classe Windows.Management.Deployment.PackageManager .
• WAS = Pris en charge par les API du Kit de développement logiciel (SDK) d’application Windows dans la classe Microsoft.Windows.Management.Deployment.PackageDeploymentManager .
• X = Non pris en charge

Usability

Les API de gestion des packages dans le Kit de développement logiciel (SDK) d’application Windows (Microsoft.Windows.Management.Deployment) offrent plusieurs améliorations de qualité de vie sur les API de gestion de package dans Windows.Management.Deployment (par exemple, PackageManager). Cela comprend :

• PackageManager.AddPackageByUriAsync échoue, retournant ERROR_INSTALL_PACKAGE_DOWNGRADE, si une version plus récente du package est déjà installée. Mais PackageDeploymentManager.AddPackageByUriAsync réussit, car il traite la requête comme « installer ce package ou une version ultérieure », de la façon dont les dépendances et d’autres références de package sont gérées régulièrement.
• PackageManager.AddPackageByUriAsync échoue, retournant ERROR_PACKAGE_ALREADY_EXISTS, si cette version exacte du package est déjà installée. PackageDeploymentManager.AddPackageByUriAsync réussit, car le package demandé est installé.
• De nombreuses opérations PackageManager acceptent un package cible en tant que fichier, mais nécessitent qu’il soit exprimé en tant qu’URI. PackageDeploymentManager fournit des remplacements qui l’acceptent également en tant que chaîne.
• PackageManager.RemovePackageByFullNameAsync échoue si le package spécifié est introuvable. PackageDeploymentManager réussit, car le package demandé n’est pas présent à la fin de l’opération.
  • Cela est dû au principe de déploiement principal qu’il n’a pas d’importance pour l’état précédent du système ; que l’état final souhaité est atteint.
• Les méthodes PackageManager acceptent des permutations incohérentes (et souvent peu fréquentes) d’expression d’un package cible. Par exemple, PackageManager prend en charge la suppression d’un package par nom complet du package, mais pas par nom de famille de package. PackageDeploymentManager fournit une API plus riche qui accepte des identificateurs supplémentaires.

Support de la plateforme

Ces API sont disponibles uniquement sur Windows 10, version 2004 (10.0 ; Build 19041) et versions ultérieures.

Un sous-ensemble de fonctionnalités est disponible sur les versions plus récentes. Par exemple, AddPackageOptions.ExpectedDigests nécessite Windows 11, version 22H2 (10.0 ; Build 22621) ou version ultérieure. Toutes les fonctionnalités nécessitant une version de Windows plus récente que Windows 10, version 2004 (10.0 ; La base de référence de build 19041) présente des affordances pour détecter au moment de l’exécution si la plateforme actuelle prend en charge la fonctionnalité, par exemple :

var options = new AddPackageOptions();
if (options.IsLimitToExistingPackagesSupported)
{
    options.LimitToExistingPackages = true;
}

Cet espace de noms fournit des API de gestion de package MSIX comparables à celles de la Windows. Management.Deployment espace de noms, mais avec des fonctionnalités supplémentaires, une expérience de développement améliorée et des optimisations des performances.

Ces API Windows Runtime (WinRT) vous permettent de déployer et de gérer des logiciels en tant que packages MSIX. Vous pouvez installer, mettre à jour, désinstaller, énumérer et gérer les packages. Voici les scénarios surux :

• Étape d’un package
• Inscrire un package
• Ajouter/mettre à jour un package
• Supprimer un package
• Réparer un package
• Réinitialiser un package
• Provisionner un package
• Déprovisionner un package

Les fonctionnalités supplémentaires incluent :

• IsReadyXxx. Déterminez si un package est prêt à être utilisé.
• EnsureReady. Déterminez si un package est prêt à être utilisé et, si ce n’est pas le cas, faites-le.
• IsPackageRegistrationPending. Déterminez s’il existe une mise à jour en attente d’inscription.
• PackagesSets. Opérations par lots.
• PackageRuntimeManager. Opérations batch à utiliser au moment de l’exécution via des dépendances dynamiques.
• Utilisabilité. Améliorations de la qualité de vie.

Structure d’API

Les méthodes permettant de piloter l’activité de déploiement suivent généralement le modèle :

<verb>Package[Set][By<Type>][Suffix]Async(target, options)

Les verbes suivants sont pris en charge :

• Est... Ready[OrNewerAvailable]
• Assurer... Prêt
• Ajouter
• Stage
• Register
• Supprimer
• Réparation
• Réinitialiser
• Approvisionnement
• Déprovisionner

Ces méthodes acceptent leur ou leurs packages cibles comme premier paramètre. Ce paramètre peut être différents types d’informations, notamment :

• Filename
• Path
• PackageFamilyName
• PackageFullName
• Uri

! [REMARQUE] Les méthodes avec une cible d’URI sont nommées ... ByUri....

! [REMARQUE] Les méthodes avec une cible d’un PackageFamilyName sont nommées ... ByPackageFamilyName....

! [REMARQUE] Les méthodes avec une cible d’un PackageFullName sont nommées ... ByPackageFullName....

! [REMARQUE] Méthodes sans ... Par<type>... qualificateur accepte une chaîne qui peut contenir un ou plusieurs types d’identificateurs. Ceux-ci peuvent varier pour différents verbes. Consultez la documentation de l’API pour connaître les types cibles spécifiques pris en charge par chaque méthode.

Ces méthodes acceptent les options en tant que type correspondant <verb>Package[Set]Options ; par exemple, AddPackageAsync(string packageUri, AddPackageOptions options).

Le tableau suivant présente les permutations prises en charge des verbes et des cibles :

Légende :

• OS = Pris en charge par les API Windows (OS) dans la classe Windows.Management.Deployment.PackageManager .
• WAS = Pris en charge par les API du Kit de développement logiciel (SDK) d’application Windows dans la classe Microsoft.Windows.Management.Deployment.PackageDeploymentManager .
• X = Non pris en charge

Usability

Les API de gestion des packages dans le Kit de développement logiciel (SDK) d’application Windows (Microsoft.Windows.Management.Deployment) offrent plusieurs améliorations de qualité de vie sur les API de gestion de package dans Windows.Management.Deployment (par exemple, PackageManager). Cela comprend :

• PackageManager.AddPackageByUriAsync échoue, retournant ERROR_INSTALL_PACKAGE_DOWNGRADE, si une version plus récente du package est déjà installée. Mais PackageDeploymentManager.AddPackageByUriAsync réussit, car il traite la requête comme « installer ce package ou une version ultérieure », de la façon dont les dépendances et d’autres références de package sont gérées régulièrement.
• PackageManager.AddPackageByUriAsync échoue, retournant ERROR_PACKAGE_ALREADY_EXISTS, si cette version exacte du package est déjà installée. PackageDeploymentManager.AddPackageByUriAsync réussit, car le package demandé est installé.
• De nombreuses opérations PackageManager acceptent un package cible en tant que fichier, mais nécessitent qu’il soit exprimé en tant qu’URI. PackageDeploymentManager fournit des remplacements qui l’acceptent également en tant que chaîne.
• PackageManager.RemovePackageByFullNameAsync échoue si le package spécifié est introuvable. PackageDeploymentManager réussit, car le package demandé n’est pas présent à la fin de l’opération.
  • Cela est dû au principe de déploiement principal qu’il n’a pas d’importance pour l’état précédent du système ; que l’état final souhaité est atteint.
• Les méthodes PackageManager acceptent des permutations incohérentes (et souvent peu fréquentes) d’expression d’un package cible. Par exemple, PackageManager prend en charge la suppression d’un package par nom complet du package, mais pas par nom de famille de package. PackageDeploymentManager fournit une API plus riche qui accepte des identificateurs supplémentaires.

Support de la plateforme

Ces API sont disponibles uniquement sur Windows 10, version 2004 (10.0 ; Build 19041) et versions ultérieures.

Un sous-ensemble de fonctionnalités est disponible sur les versions plus récentes. Par exemple, AddPackageOptions.ExpectedDigests nécessite Windows 11, version 22H2 (10.0 ; Build 22621) ou version ultérieure. Toutes les fonctionnalités nécessitant une version de Windows plus récente que Windows 10, version 2004 (10.0 ; La base de référence de build 19041) présente des affordances pour détecter au moment de l’exécution si la plateforme actuelle prend en charge la fonctionnalité, par exemple :

var options = new AddPackageOptions();
if (options.IsLimitToExistingPackagesSupported)
{
    options.LimitToExistingPackages = true;
}

Représente un volume de stockage de package .

Cet espace de noms fournit des API de gestion de package MSIX comparables à celles de la Windows. Management.Deployment espace de noms, mais avec des fonctionnalités supplémentaires, une expérience de développement améliorée et des optimisations des performances.

Ces API Windows Runtime (WinRT) vous permettent de déployer et de gérer des logiciels en tant que packages MSIX. Vous pouvez installer, mettre à jour, désinstaller, énumérer et gérer les packages. Voici les scénarios surux :

• Étape d’un package
• Inscrire un package
• Ajouter/mettre à jour un package
• Supprimer un package
• Réparer un package
• Réinitialiser un package
• Provisionner un package
• Déprovisionner un package

Les fonctionnalités supplémentaires incluent :

• IsReadyXxx. Déterminez si un package est prêt à être utilisé.
• EnsureReady. Déterminez si un package est prêt à être utilisé et, si ce n’est pas le cas, faites-le.
• IsPackageRegistrationPending. Déterminez s’il existe une mise à jour en attente d’inscription.
• PackagesSets. Opérations par lots.
• PackageRuntimeManager. Opérations batch à utiliser au moment de l’exécution via des dépendances dynamiques.
• Utilisabilité. Améliorations de la qualité de vie.

Structure d’API

Les méthodes permettant de piloter l’activité de déploiement suivent généralement le modèle :

<verb>Package[Set][By<Type>][Suffix]Async(target, options)

Les verbes suivants sont pris en charge :

• Est... Ready[OrNewerAvailable]
• Assurer... Prêt
• Ajouter
• Stage
• Register
• Supprimer
• Réparation
• Réinitialiser
• Approvisionnement
• Déprovisionner

Ces méthodes acceptent leur ou leurs packages cibles comme premier paramètre. Ce paramètre peut être différents types d’informations, notamment :

• Filename
• Path
• PackageFamilyName
• PackageFullName
• Uri

! [REMARQUE] Les méthodes avec une cible d’URI sont nommées ... ByUri....

! [REMARQUE] Les méthodes avec une cible d’un PackageFamilyName sont nommées ... ByPackageFamilyName....

! [REMARQUE] Les méthodes avec une cible d’un PackageFullName sont nommées ... ByPackageFullName....

! [REMARQUE] Méthodes sans ... Par<type>... qualificateur accepte une chaîne qui peut contenir un ou plusieurs types d’identificateurs. Ceux-ci peuvent varier pour différents verbes. Consultez la documentation de l’API pour connaître les types cibles spécifiques pris en charge par chaque méthode.

Ces méthodes acceptent les options en tant que type correspondant <verb>Package[Set]Options ; par exemple, AddPackageAsync(string packageUri, AddPackageOptions options).

Le tableau suivant présente les permutations prises en charge des verbes et des cibles :

Légende :

• OS = Pris en charge par les API Windows (OS) dans la classe Windows.Management.Deployment.PackageManager .
• WAS = Pris en charge par les API du Kit de développement logiciel (SDK) d’application Windows dans la classe Microsoft.Windows.Management.Deployment.PackageDeploymentManager .
• X = Non pris en charge

Usability

Les API de gestion des packages dans le Kit de développement logiciel (SDK) d’application Windows (Microsoft.Windows.Management.Deployment) offrent plusieurs améliorations de qualité de vie sur les API de gestion de package dans Windows.Management.Deployment (par exemple, PackageManager). Cela comprend :

• PackageManager.AddPackageByUriAsync échoue, retournant ERROR_INSTALL_PACKAGE_DOWNGRADE, si une version plus récente du package est déjà installée. Mais PackageDeploymentManager.AddPackageByUriAsync réussit, car il traite la requête comme « installer ce package ou une version ultérieure », de la façon dont les dépendances et d’autres références de package sont gérées régulièrement.
• PackageManager.AddPackageByUriAsync échoue, retournant ERROR_PACKAGE_ALREADY_EXISTS, si cette version exacte du package est déjà installée. PackageDeploymentManager.AddPackageByUriAsync réussit, car le package demandé est installé.
• De nombreuses opérations PackageManager acceptent un package cible en tant que fichier, mais nécessitent qu’il soit exprimé en tant qu’URI. PackageDeploymentManager fournit des remplacements qui l’acceptent également en tant que chaîne.
• PackageManager.RemovePackageByFullNameAsync échoue si le package spécifié est introuvable. PackageDeploymentManager réussit, car le package demandé n’est pas présent à la fin de l’opération.
  • Cela est dû au principe de déploiement principal qu’il n’a pas d’importance pour l’état précédent du système ; que l’état final souhaité est atteint.
• Les méthodes PackageManager acceptent des permutations incohérentes (et souvent peu fréquentes) d’expression d’un package cible. Par exemple, PackageManager prend en charge la suppression d’un package par nom complet du package, mais pas par nom de famille de package. PackageDeploymentManager fournit une API plus riche qui accepte des identificateurs supplémentaires.

Support de la plateforme

Ces API sont disponibles uniquement sur Windows 10, version 2004 (10.0 ; Build 19041) et versions ultérieures.

Un sous-ensemble de fonctionnalités est disponible sur les versions plus récentes. Par exemple, AddPackageOptions.ExpectedDigests nécessite Windows 11, version 22H2 (10.0 ; Build 22621) ou version ultérieure. Toutes les fonctionnalités nécessitant une version de Windows plus récente que Windows 10, version 2004 (10.0 ; La base de référence de build 19041) présente des affordances pour détecter au moment de l’exécution si la plateforme actuelle prend en charge la fonctionnalité, par exemple :

var options = new AddPackageOptions();
if (options.IsLimitToExistingPackagesSupported)
{
    options.LimitToExistingPackages = true;
}

Spécifie les options de déploiement que vous pouvez configurer lorsque vous utilisez la méthode RegisterPackageByUriAsync pour inscrire un package.

Cet espace de noms fournit des API de gestion de package MSIX comparables à celles de la Windows. Management.Deployment espace de noms, mais avec des fonctionnalités supplémentaires, une expérience de développement améliorée et des optimisations des performances.

Ces API Windows Runtime (WinRT) vous permettent de déployer et de gérer des logiciels en tant que packages MSIX. Vous pouvez installer, mettre à jour, désinstaller, énumérer et gérer les packages. Voici les scénarios surux :

• Étape d’un package
• Inscrire un package
• Ajouter/mettre à jour un package
• Supprimer un package
• Réparer un package
• Réinitialiser un package
• Provisionner un package
• Déprovisionner un package

Les fonctionnalités supplémentaires incluent :

• IsReadyXxx. Déterminez si un package est prêt à être utilisé.
• EnsureReady. Déterminez si un package est prêt à être utilisé et, si ce n’est pas le cas, faites-le.
• IsPackageRegistrationPending. Déterminez s’il existe une mise à jour en attente d’inscription.
• PackagesSets. Opérations par lots.
• PackageRuntimeManager. Opérations batch à utiliser au moment de l’exécution via des dépendances dynamiques.
• Utilisabilité. Améliorations de la qualité de vie.

Structure d’API

Les méthodes permettant de piloter l’activité de déploiement suivent généralement le modèle :

<verb>Package[Set][By<Type>][Suffix]Async(target, options)

Les verbes suivants sont pris en charge :

• Est... Ready[OrNewerAvailable]
• Assurer... Prêt
• Ajouter
• Stage
• Register
• Supprimer
• Réparation
• Réinitialiser
• Approvisionnement
• Déprovisionner

Ces méthodes acceptent leur ou leurs packages cibles comme premier paramètre. Ce paramètre peut être différents types d’informations, notamment :

• Filename
• Path
• PackageFamilyName
• PackageFullName
• Uri

! [REMARQUE] Les méthodes avec une cible d’URI sont nommées ... ByUri....

! [REMARQUE] Les méthodes avec une cible d’un PackageFamilyName sont nommées ... ByPackageFamilyName....

! [REMARQUE] Les méthodes avec une cible d’un PackageFullName sont nommées ... ByPackageFullName....

! [REMARQUE] Méthodes sans ... Par<type>... qualificateur accepte une chaîne qui peut contenir un ou plusieurs types d’identificateurs. Ceux-ci peuvent varier pour différents verbes. Consultez la documentation de l’API pour connaître les types cibles spécifiques pris en charge par chaque méthode.

Ces méthodes acceptent les options en tant que type correspondant <verb>Package[Set]Options ; par exemple, AddPackageAsync(string packageUri, AddPackageOptions options).

Le tableau suivant présente les permutations prises en charge des verbes et des cibles :

Légende :

• OS = Pris en charge par les API Windows (OS) dans la classe Windows.Management.Deployment.PackageManager .
• WAS = Pris en charge par les API du Kit de développement logiciel (SDK) d’application Windows dans la classe Microsoft.Windows.Management.Deployment.PackageDeploymentManager .
• X = Non pris en charge

Usability

Les API de gestion des packages dans le Kit de développement logiciel (SDK) d’application Windows (Microsoft.Windows.Management.Deployment) offrent plusieurs améliorations de qualité de vie sur les API de gestion de package dans Windows.Management.Deployment (par exemple, PackageManager). Cela comprend :

• PackageManager.AddPackageByUriAsync échoue, retournant ERROR_INSTALL_PACKAGE_DOWNGRADE, si une version plus récente du package est déjà installée. Mais PackageDeploymentManager.AddPackageByUriAsync réussit, car il traite la requête comme « installer ce package ou une version ultérieure », de la façon dont les dépendances et d’autres références de package sont gérées régulièrement.
• PackageManager.AddPackageByUriAsync échoue, retournant ERROR_PACKAGE_ALREADY_EXISTS, si cette version exacte du package est déjà installée. PackageDeploymentManager.AddPackageByUriAsync réussit, car le package demandé est installé.
• De nombreuses opérations PackageManager acceptent un package cible en tant que fichier, mais nécessitent qu’il soit exprimé en tant qu’URI. PackageDeploymentManager fournit des remplacements qui l’acceptent également en tant que chaîne.
• PackageManager.RemovePackageByFullNameAsync échoue si le package spécifié est introuvable. PackageDeploymentManager réussit, car le package demandé n’est pas présent à la fin de l’opération.
  • Cela est dû au principe de déploiement principal qu’il n’a pas d’importance pour l’état précédent du système ; que l’état final souhaité est atteint.
• Les méthodes PackageManager acceptent des permutations incohérentes (et souvent peu fréquentes) d’expression d’un package cible. Par exemple, PackageManager prend en charge la suppression d’un package par nom complet du package, mais pas par nom de famille de package. PackageDeploymentManager fournit une API plus riche qui accepte des identificateurs supplémentaires.

Support de la plateforme

Ces API sont disponibles uniquement sur Windows 10, version 2004 (10.0 ; Build 19041) et versions ultérieures.

Un sous-ensemble de fonctionnalités est disponible sur les versions plus récentes. Par exemple, AddPackageOptions.ExpectedDigests nécessite Windows 11, version 22H2 (10.0 ; Build 22621) ou version ultérieure. Toutes les fonctionnalités nécessitant une version de Windows plus récente que Windows 10, version 2004 (10.0 ; La base de référence de build 19041) présente des affordances pour détecter au moment de l’exécution si la plateforme actuelle prend en charge la fonctionnalité, par exemple :

var options = new AddPackageOptions();
if (options.IsLimitToExistingPackagesSupported)
{
    options.LimitToExistingPackages = true;
}

Spécifie les options de déploiement que vous pouvez configurer lorsque vous utilisez la méthode StagePackageByUriAsync pour mettre en scène un package.

Contient des informations de progression pour la demande de déploiement.

Cet espace de noms fournit des API de gestion de package MSIX comparables à celles de la Windows. Management.Deployment espace de noms, mais avec des fonctionnalités supplémentaires, une expérience de développement améliorée et des optimisations des performances.

Ces API Windows Runtime (WinRT) vous permettent de déployer et de gérer des logiciels en tant que packages MSIX. Vous pouvez installer, mettre à jour, désinstaller, énumérer et gérer les packages. Voici les scénarios surux :

• Étape d’un package
• Inscrire un package
• Ajouter/mettre à jour un package
• Supprimer un package
• Réparer un package
• Réinitialiser un package
• Provisionner un package
• Déprovisionner un package

Les fonctionnalités supplémentaires incluent :

• IsReadyXxx. Déterminez si un package est prêt à être utilisé.
• EnsureReady. Déterminez si un package est prêt à être utilisé et, si ce n’est pas le cas, faites-le.
• IsPackageRegistrationPending. Déterminez s’il existe une mise à jour en attente d’inscription.
• PackagesSets. Opérations par lots.
• PackageRuntimeManager. Opérations batch à utiliser au moment de l’exécution via des dépendances dynamiques.
• Utilisabilité. Améliorations de la qualité de vie.

Structure d’API

Les méthodes permettant de piloter l’activité de déploiement suivent généralement le modèle :

<verb>Package[Set][By<Type>][Suffix]Async(target, options)

Les verbes suivants sont pris en charge :

• Est... Ready[OrNewerAvailable]
• Assurer... Prêt
• Ajouter
• Stage
• Register
• Supprimer
• Réparation
• Réinitialiser
• Approvisionnement
• Déprovisionner

Ces méthodes acceptent leur ou leurs packages cibles comme premier paramètre. Ce paramètre peut être différents types d’informations, notamment :

• Filename
• Path
• PackageFamilyName
• PackageFullName
• Uri

! [REMARQUE] Les méthodes avec une cible d’URI sont nommées ... ByUri....

! [REMARQUE] Les méthodes avec une cible d’un PackageFamilyName sont nommées ... ByPackageFamilyName....

! [REMARQUE] Les méthodes avec une cible d’un PackageFullName sont nommées ... ByPackageFullName....

! [REMARQUE] Méthodes sans ... Par<type>... qualificateur accepte une chaîne qui peut contenir un ou plusieurs types d’identificateurs. Ceux-ci peuvent varier pour différents verbes. Consultez la documentation de l’API pour connaître les types cibles spécifiques pris en charge par chaque méthode.

Ces méthodes acceptent les options en tant que type correspondant <verb>Package[Set]Options ; par exemple, AddPackageAsync(string packageUri, AddPackageOptions options).

Le tableau suivant présente les permutations prises en charge des verbes et des cibles :

Légende :

• OS = Pris en charge par les API Windows (OS) dans la classe Windows.Management.Deployment.PackageManager .
• WAS = Pris en charge par les API du Kit de développement logiciel (SDK) d’application Windows dans la classe Microsoft.Windows.Management.Deployment.PackageDeploymentManager .
• X = Non pris en charge

Usability

Les API de gestion des packages dans le Kit de développement logiciel (SDK) d’application Windows (Microsoft.Windows.Management.Deployment) offrent plusieurs améliorations de qualité de vie sur les API de gestion de package dans Windows.Management.Deployment (par exemple, PackageManager). Cela comprend :

• PackageManager.AddPackageByUriAsync échoue, retournant ERROR_INSTALL_PACKAGE_DOWNGRADE, si une version plus récente du package est déjà installée. Mais PackageDeploymentManager.AddPackageByUriAsync réussit, car il traite la requête comme « installer ce package ou une version ultérieure », de la façon dont les dépendances et d’autres références de package sont gérées régulièrement.
• PackageManager.AddPackageByUriAsync échoue, retournant ERROR_PACKAGE_ALREADY_EXISTS, si cette version exacte du package est déjà installée. PackageDeploymentManager.AddPackageByUriAsync réussit, car le package demandé est installé.
• De nombreuses opérations PackageManager acceptent un package cible en tant que fichier, mais nécessitent qu’il soit exprimé en tant qu’URI. PackageDeploymentManager fournit des remplacements qui l’acceptent également en tant que chaîne.
• PackageManager.RemovePackageByFullNameAsync échoue si le package spécifié est introuvable. PackageDeploymentManager réussit, car le package demandé n’est pas présent à la fin de l’opération.
  • Cela est dû au principe de déploiement principal qu’il n’a pas d’importance pour l’état précédent du système ; que l’état final souhaité est atteint.
• Les méthodes PackageManager acceptent des permutations incohérentes (et souvent peu fréquentes) d’expression d’un package cible. Par exemple, PackageManager prend en charge la suppression d’un package par nom complet du package, mais pas par nom de famille de package. PackageDeploymentManager fournit une API plus riche qui accepte des identificateurs supplémentaires.

Support de la plateforme

Ces API sont disponibles uniquement sur Windows 10, version 2004 (10.0 ; Build 19041) et versions ultérieures.

Un sous-ensemble de fonctionnalités est disponible sur les versions plus récentes. Par exemple, AddPackageOptions.ExpectedDigests nécessite Windows 11, version 22H2 (10.0 ; Build 22621) ou version ultérieure. Toutes les fonctionnalités nécessitant une version de Windows plus récente que Windows 10, version 2004 (10.0 ; La base de référence de build 19041) présente des affordances pour détecter au moment de l’exécution si la plateforme actuelle prend en charge la fonctionnalité, par exemple :

var options = new AddPackageOptions();
if (options.IsLimitToExistingPackagesSupported)
{
    options.LimitToExistingPackages = true;
}

Cet espace de noms fournit des API de gestion de package MSIX comparables à celles de la Windows. Management.Deployment espace de noms, mais avec des fonctionnalités supplémentaires, une expérience de développement améliorée et des optimisations des performances.

Ces API Windows Runtime (WinRT) vous permettent de déployer et de gérer des logiciels en tant que packages MSIX. Vous pouvez installer, mettre à jour, désinstaller, énumérer et gérer les packages. Voici les scénarios surux :

• Étape d’un package
• Inscrire un package
• Ajouter/mettre à jour un package
• Supprimer un package
• Réparer un package
• Réinitialiser un package
• Provisionner un package
• Déprovisionner un package

Les fonctionnalités supplémentaires incluent :

• IsReadyXxx. Déterminez si un package est prêt à être utilisé.
• EnsureReady. Déterminez si un package est prêt à être utilisé et, si ce n’est pas le cas, faites-le.
• IsPackageRegistrationPending. Déterminez s’il existe une mise à jour en attente d’inscription.
• PackagesSets. Opérations par lots.
• PackageRuntimeManager. Opérations batch à utiliser au moment de l’exécution via des dépendances dynamiques.
• Utilisabilité. Améliorations de la qualité de vie.

Structure d’API

Les méthodes permettant de piloter l’activité de déploiement suivent généralement le modèle :

<verb>Package[Set][By<Type>][Suffix]Async(target, options)

Les verbes suivants sont pris en charge :

• Est... Ready[OrNewerAvailable]
• Assurer... Prêt
• Ajouter
• Stage
• Register
• Supprimer
• Réparation
• Réinitialiser
• Approvisionnement
• Déprovisionner

Ces méthodes acceptent leur ou leurs packages cibles comme premier paramètre. Ce paramètre peut être différents types d’informations, notamment :

• Filename
• Path
• PackageFamilyName
• PackageFullName
• Uri

! [REMARQUE] Les méthodes avec une cible d’URI sont nommées ... ByUri....

! [REMARQUE] Les méthodes avec une cible d’un PackageFamilyName sont nommées ... ByPackageFamilyName....

! [REMARQUE] Les méthodes avec une cible d’un PackageFullName sont nommées ... ByPackageFullName....

! [REMARQUE] Méthodes sans ... Par<type>... qualificateur accepte une chaîne qui peut contenir un ou plusieurs types d’identificateurs. Ceux-ci peuvent varier pour différents verbes. Consultez la documentation de l’API pour connaître les types cibles spécifiques pris en charge par chaque méthode.

Ces méthodes acceptent les options en tant que type correspondant <verb>Package[Set]Options ; par exemple, AddPackageAsync(string packageUri, AddPackageOptions options).

Le tableau suivant présente les permutations prises en charge des verbes et des cibles :

Légende :

• OS = Pris en charge par les API Windows (OS) dans la classe Windows.Management.Deployment.PackageManager .
• WAS = Pris en charge par les API du Kit de développement logiciel (SDK) d’application Windows dans la classe Microsoft.Windows.Management.Deployment.PackageDeploymentManager .
• X = Non pris en charge

Usability

Les API de gestion des packages dans le Kit de développement logiciel (SDK) d’application Windows (Microsoft.Windows.Management.Deployment) offrent plusieurs améliorations de qualité de vie sur les API de gestion de package dans Windows.Management.Deployment (par exemple, PackageManager). Cela comprend :

• PackageManager.AddPackageByUriAsync échoue, retournant ERROR_INSTALL_PACKAGE_DOWNGRADE, si une version plus récente du package est déjà installée. Mais PackageDeploymentManager.AddPackageByUriAsync réussit, car il traite la requête comme « installer ce package ou une version ultérieure », de la façon dont les dépendances et d’autres références de package sont gérées régulièrement.
• PackageManager.AddPackageByUriAsync échoue, retournant ERROR_PACKAGE_ALREADY_EXISTS, si cette version exacte du package est déjà installée. PackageDeploymentManager.AddPackageByUriAsync réussit, car le package demandé est installé.
• De nombreuses opérations PackageManager acceptent un package cible en tant que fichier, mais nécessitent qu’il soit exprimé en tant qu’URI. PackageDeploymentManager fournit des remplacements qui l’acceptent également en tant que chaîne.
• PackageManager.RemovePackageByFullNameAsync échoue si le package spécifié est introuvable. PackageDeploymentManager réussit, car le package demandé n’est pas présent à la fin de l’opération.
  • Cela est dû au principe de déploiement principal qu’il n’a pas d’importance pour l’état précédent du système ; que l’état final souhaité est atteint.
• Les méthodes PackageManager acceptent des permutations incohérentes (et souvent peu fréquentes) d’expression d’un package cible. Par exemple, PackageManager prend en charge la suppression d’un package par nom complet du package, mais pas par nom de famille de package. PackageDeploymentManager fournit une API plus riche qui accepte des identificateurs supplémentaires.

Support de la plateforme

Ces API sont disponibles uniquement sur Windows 10, version 2004 (10.0 ; Build 19041) et versions ultérieures.

Un sous-ensemble de fonctionnalités est disponible sur les versions plus récentes. Par exemple, AddPackageOptions.ExpectedDigests nécessite Windows 11, version 22H2 (10.0 ; Build 22621) ou version ultérieure. Toutes les fonctionnalités nécessitant une version de Windows plus récente que Windows 10, version 2004 (10.0 ; La base de référence de build 19041) présente des affordances pour détecter au moment de l’exécution si la plateforme actuelle prend en charge la fonctionnalité, par exemple :

var options = new AddPackageOptions();
if (options.IsLimitToExistingPackagesSupported)
{
    options.LimitToExistingPackages = true;
}

Définit des constantes qui spécifient l’état de progression de la demande de déploiement.

État de la demande de déploiement.

Définit le comportement stub d’un package d’application en cours d’ajout ou intermédiaire.

Cet espace de noms fournit des API de gestion de package MSIX comparables à celles de la Windows. Management.Deployment espace de noms, mais avec des fonctionnalités supplémentaires, une expérience de développement améliorée et des optimisations des performances.

Ces API Windows Runtime (WinRT) vous permettent de déployer et de gérer des logiciels en tant que packages MSIX. Vous pouvez installer, mettre à jour, désinstaller, énumérer et gérer les packages. Voici les scénarios surux :

• Étape d’un package
• Inscrire un package
• Ajouter/mettre à jour un package
• Supprimer un package
• Réparer un package
• Réinitialiser un package
• Provisionner un package
• Déprovisionner un package

Les fonctionnalités supplémentaires incluent :

• IsReadyXxx. Déterminez si un package est prêt à être utilisé.
• EnsureReady. Déterminez si un package est prêt à être utilisé et, si ce n’est pas le cas, faites-le.
• IsPackageRegistrationPending. Déterminez s’il existe une mise à jour en attente d’inscription.
• PackagesSets. Opérations par lots.
• PackageRuntimeManager. Opérations batch à utiliser au moment de l’exécution via des dépendances dynamiques.
• Utilisabilité. Améliorations de la qualité de vie.

Structure d’API

Les méthodes permettant de piloter l’activité de déploiement suivent généralement le modèle :

<verb>Package[Set][By<Type>][Suffix]Async(target, options)

Les verbes suivants sont pris en charge :

• Est... Ready[OrNewerAvailable]
• Assurer... Prêt
• Ajouter
• Stage
• Register
• Supprimer
• Réparation
• Réinitialiser
• Approvisionnement
• Déprovisionner

Ces méthodes acceptent leur ou leurs packages cibles comme premier paramètre. Ce paramètre peut être différents types d’informations, notamment :

• Filename
• Path
• PackageFamilyName
• PackageFullName
• Uri

! [REMARQUE] Les méthodes avec une cible d’URI sont nommées ... ByUri....

! [REMARQUE] Les méthodes avec une cible d’un PackageFamilyName sont nommées ... ByPackageFamilyName....

! [REMARQUE] Les méthodes avec une cible d’un PackageFullName sont nommées ... ByPackageFullName....

! [REMARQUE] Méthodes sans ... Par<type>... qualificateur accepte une chaîne qui peut contenir un ou plusieurs types d’identificateurs. Ceux-ci peuvent varier pour différents verbes. Consultez la documentation de l’API pour connaître les types cibles spécifiques pris en charge par chaque méthode.

Ces méthodes acceptent les options en tant que type correspondant <verb>Package[Set]Options ; par exemple, AddPackageAsync(string packageUri, AddPackageOptions options).

Le tableau suivant présente les permutations prises en charge des verbes et des cibles :

Légende :

• OS = Pris en charge par les API Windows (OS) dans la classe Windows.Management.Deployment.PackageManager .
• WAS = Pris en charge par les API du Kit de développement logiciel (SDK) d’application Windows dans la classe Microsoft.Windows.Management.Deployment.PackageDeploymentManager .
• X = Non pris en charge

Usability

Les API de gestion des packages dans le Kit de développement logiciel (SDK) d’application Windows (Microsoft.Windows.Management.Deployment) offrent plusieurs améliorations de qualité de vie sur les API de gestion de package dans Windows.Management.Deployment (par exemple, PackageManager). Cela comprend :

• PackageManager.AddPackageByUriAsync échoue, retournant ERROR_INSTALL_PACKAGE_DOWNGRADE, si une version plus récente du package est déjà installée. Mais PackageDeploymentManager.AddPackageByUriAsync réussit, car il traite la requête comme « installer ce package ou une version ultérieure », de la façon dont les dépendances et d’autres références de package sont gérées régulièrement.
• PackageManager.AddPackageByUriAsync échoue, retournant ERROR_PACKAGE_ALREADY_EXISTS, si cette version exacte du package est déjà installée. PackageDeploymentManager.AddPackageByUriAsync réussit, car le package demandé est installé.
• De nombreuses opérations PackageManager acceptent un package cible en tant que fichier, mais nécessitent qu’il soit exprimé en tant qu’URI. PackageDeploymentManager fournit des remplacements qui l’acceptent également en tant que chaîne.
• PackageManager.RemovePackageByFullNameAsync échoue si le package spécifié est introuvable. PackageDeploymentManager réussit, car le package demandé n’est pas présent à la fin de l’opération.
  • Cela est dû au principe de déploiement principal qu’il n’a pas d’importance pour l’état précédent du système ; que l’état final souhaité est atteint.
• Les méthodes PackageManager acceptent des permutations incohérentes (et souvent peu fréquentes) d’expression d’un package cible. Par exemple, PackageManager prend en charge la suppression d’un package par nom complet du package, mais pas par nom de famille de package. PackageDeploymentManager fournit une API plus riche qui accepte des identificateurs supplémentaires.

Support de la plateforme

Ces API sont disponibles uniquement sur Windows 10, version 2004 (10.0 ; Build 19041) et versions ultérieures.

Un sous-ensemble de fonctionnalités est disponible sur les versions plus récentes. Par exemple, AddPackageOptions.ExpectedDigests nécessite Windows 11, version 22H2 (10.0 ; Build 22621) ou version ultérieure. Toutes les fonctionnalités nécessitant une version de Windows plus récente que Windows 10, version 2004 (10.0 ; La base de référence de build 19041) présente des affordances pour détecter au moment de l’exécution si la plateforme actuelle prend en charge la fonctionnalité, par exemple :

var options = new AddPackageOptions();
if (options.IsLimitToExistingPackagesSupported)
{
    options.LimitToExistingPackages = true;
}

Définit des constantes qui spécifient le comportement stub d’un package d’application en cours d’ajout ou intermédiaire.