Numérotation des versions de packages

Chaque package que vous fournissez doit avoir un numéro de version (fourni comme une valeur dans l’attribut Version de l’élément Package/Identité dans le manifeste de l’application). Microsoft Store applique certaines règles relatives aux numéros de version, qui fonctionnent un peu différemment selon les versions du système d’exploitation.

Remarque

Ce sujet fait référence aux « packages », mais sauf mention contraire, les mêmes règles s’appliquent aux numéros de version pour les fichiers .msix/.appx et .msixbundle/.appxbundle.

Numérotation des versions pour les packages Windows 10 et 11

Important

Pour les packages Windows 10 ou Windows 11 (UWP), la dernière section (quatrième) du numéro de version est réservée à l’utilisation dans Microsoft Store et doit rester 0 lorsque vous construisez votre package (bien que Microsoft Store puisse changer la valeur dans cette section). Les paramètres des autres sections doivent être un nombre entier entre 0 et 65535 (sauf pour la première section, qui ne peut pas être 0).

Lorsque vous choisissez un package UWP à partir de votre soumission publiée, Microsoft Store utilisera toujours le package de la version la plus élevée applicable au dispositif Windows 10 ou Windows 11 du client. Cela vous donne une plus grande flexibilité et vous permet de contrôler quels packages seront fournis aux clients sur des types d’appareils spécifiques. Il est important de noter que vous pouvez soumettre ces packages dans n’importe quel ordre ; vous n’êtes pas limité à fournir des packages de version plus élevée à chaque soumission subséquente.

Vous pouvez fournir plusieurs packages UWP avec le même numéro de version. Cependant, les packages qui partagent un numéro de version ne peuvent pas également avoir la même architecture, car l’identité complète que Microsoft Store utilise pour chacun de vos packages doit être unique. Pour plus d’informations, veuillez consulter la section Identité.

Lorsque vous fournissez plusieurs packages UWP qui utilisent le même numéro de version, l’architecture (dans l’ordre x64, x86, Arm, neutre) sera utilisée pour décider lequel est de rang supérieur (lorsque Microsoft Store détermine quel package fournir à l’appareil d’un client). Lors du classement des lots d’applications qui utilisent le même numéro de version, le rang d’architecture le plus élevé dans le lot est choisi : un lot d’applications contenant un package x64 aura un rang supérieur à un qui contient uniquement un package x86.

Cela vous donne beaucoup de flexibilité pour faire évoluer votre application au fil du temps. Vous pouvez télécharger et soumettre de nouveaux packages utilisant des numéros de version inférieurs pour prendre en charge des dispositifs Windows 10 ou Windows 11 que vous n’avez pas précédemment pris en charge, vous pouvez ajouter des packages de version supérieure qui ont des dépendances plus strictes pour tirer parti des caractéristiques matérielles ou du système d’exploitation, ou vous pouvez ajouter des packages de version supérieure qui servent de mises à jour à une partie ou à la totalité de votre base de clients existante.

L’exemple suivant illustre comment la numérotation des versions peut être gérée pour livrer les packages destinés à vos clients sur plusieurs soumissions.

Exemple : Passer à un seul package sur plusieurs soumissions

Windows 10 vous permet d’écrire une base de code unique qui fonctionne partout. Cela rend le démarrage d’un nouveau projet multi plate-forme beaucoup plus simple. Cependant, pour un certain nombre de raisons, il est possible que vous ne souhaitiez pas fusionner les bases de code existantes pour créer un seul projet dans l’immédiat.

Vous pouvez utiliser les règles de contrôle de version des packages pour migrer progressivement vos clients vers un seul package pour la famille universelle d’appareils, tout en expédiant un certain nombre de mises à jour intermédiaires pour des familles d’appareils spécifiques (y compris celles qui tirent parti des API Windows 10). L’exemple ci-dessous illustre comment les mêmes règles sont appliquées de manière cohérente sur une série de soumissions pour la même application.

Soumission Contenu Expérience du client
1 - Version du package : 1.1.10.0
- Famille d’appareils : Windows.Desktop, minVersion 10.0.10240.0
- Les appareils sur Windows 10 et 11 Desktop build 10.0.10240.0 et les versions ultérieures auront la version 1.1.10.0
- Les autres familles d’appareils ne pourront ni acheter ni installer l’application
2 - Version du package : 1.1.10.0
- Famille d’appareils : Windows.Desktop, minVersion 10.0.10240.0

- Version du package : 1.0.0.0
- Famille d’appareils : Windows.Universal, minVersion 10.0.10240.0
- Les appareils sur Windows 10 et 11 Desktop build 10.0.10240.0 et les versions ultérieures auront la version 1.1.10.0
- Les autres familles d’appareils (autres que Desktop), lorsqu’elles sont introduites, auront la version 1.0.0.0.0
- Les appareils Desktop sur lesquels l’application a déjà été installée ne verront aucune mise à jour (car ils ont déjà la meilleure version disponible : 1.1.10.0 et sont supérieurs à 1.0.0.0)
3 - Version du package : 1.1.10.0
- Famille d’appareils : Windows.Desktop, minVersion 10.0.10240.0

- Version du package : 1.1.5.0
- Famille d’appareils : Windows.Universal, minVersion 10.0.10250.0

- Version du package : 1.0.0.0
- Famille d’appareils : Windows.Universal, minVersion 10.0.10240.0
- Les appareils sur Windows 10 et 11 Desktop build 10.0.10240.0 et les versions ultérieures auront la version 1.1.10.0
- Les autres familles d’appareils (autres que Desktop) introduites avec la build 10.0.10250.0 et versions ultérieures obtiendront 1.1.5.0
- Les autres appareils (autres que Desktop) lorsqu’ils sont introduits avec la build >=10.0.10240.0 et < 10.010250.0 obtiendront 1.1.0.0
- Les appareils Desktop sur lesquels l’application a déjà été installée ne verront aucune mise à jour (car ils ont déjà la meilleure version disponible : 1.1.10.0 qui est supérieure à 1.1.5.0 et 1.0.0.0)
4 - Version du package : 2.0.0.0
- Famille d’appareils : Windows.Universal, minVersion 10.0.10240.0
- Tous les clients sur toutes les familles d’appareils sur Windows 10 et 11 build v10.0.10240.0 et les versions ultérieures auront le package 2.0.0.0

Remarque

 Dans tous les cas, les appareils des clients recevront le package ayant le numéro de version le plus élevé pour lequel ils sont éligibles. Par exemple, lors de la troisième soumission ci-dessus, tous les appareils de bureau recevront la version 1.1.10.0, même s’ils ont la version du système d’exploitation 10.0.10250.0 ou ultérieure et pourraient donc également accepter la version 1.1.5.0. Puisque 1.1.10.0 est le numéro de version le plus élevé disponible pour eux, c’est ce package qu’ils recevront.

Utiliser la numérotation des versions pour revenir à un package précédemment expédié pour de nouvelles acquisitions

Si vous conservez des copies de vos packages, vous aurez l’option de revenir à un package plus ancien de votre application dans Microsoft Store pour Windows 10 si vous découvrez des problèmes avec une version. C’est une façon temporaire de limiter les perturbations pour vos clients pendant que vous prenez le temps de résoudre le problème.

Pour cela, créez une nouvelle soumission. Retirez le package problématique et téléchargez l’ancien package que vous souhaitez proposer dans Microsoft Store. Les clients ayant déjà reçu le package auquel vous revenez auront toujours le package problématique (puisque votre package plus ancien aura un numéro de version antérieur). Mais cela empêchera personne d’autre d’acquérir le package problématique, tout en permettant à l’application d’être toujours disponible dans Microsoft Store.

Pour résoudre le problème pour les clients ayant déjà reçu le package problématique, vous pouvez soumettre un nouveau package Windows 10 ayant un numéro de version supérieur à celui du mauvais package dès que possible. Après que cette soumission ait passé le processus de certification, tous les clients seront mis à jour vers le nouveau package, puisqu’il aura un numéro de version supérieur.

Vous pouvez gérer le numéro de version du package via votre programme d’installation. La numérotation des versions du package pour Win32 n’est pas supportée via Microsoft Store.

Important

La numérotation des versions de paquets n’est pas prise en charge pour les compléments d’application.