Empaqueter une application de bureau ou UWP dans Visual Studio

Avant de distribuer votre application, vous devez la empaqueter. Cet article décrit le processus de configuration, de création et de test d’un package MSIX à l’aide de Visual Studio.

Types de packages d’application

• Package d’application (.msix ou .appx)
  Package unique qui contient votre application et ses ressources, ciblant une seule architecture d’appareil. Par exemple, un package d’application x64 ou x86. Pour cibler plusieurs architectures avec un ensemble d’applications, vous devez en générer une pour chaque architecture.

• App Bundle (.msixbundle ou .appxbundle)
  Un ensemble d’applications est un type de package qui peut contenir plusieurs packages d’application, chacun d’entre eux étant conçu pour prendre en charge une architecture d’appareil spécifique. Par exemple, un bundle d’applications peut contenir trois packages d’application distincts pour les configurations x86, x64 et ARM. Les offres groupées d’applications doivent être générées chaque fois que cela est possible, car elles permettent à votre application d’être disponible sur la plus large gamme d’appareils possible.

• Fichier de chargement de package d’application (.msixupload ou .appxupload) : pour la soumission au Windows Store uniquement
  Fichier unique qui peut contenir plusieurs packages d’application ou un ensemble d’applications pour prendre en charge différentes architectures de processeur. Le fichier de chargement du package d’application contient également un fichier de symboles pour analyser les performances de l’application une fois que votre application a été publiée dans le Microsoft Store. Ce fichier sera automatiquement créé pour vous si vous empaquetagez votre application avec Visual Studio avec l’intention de l’envoyer à l’Espace partenaires pour la publication dans le Microsoft Store.

Voici une vue d’ensemble des étapes à suivre pour préparer et créer un package d’application :

1. Avant de empaqueter votre application. Suivez ces étapes pour vous assurer que votre application est prête à être empaquetée.

2. Configurez votre projet. Utilisez le concepteur de manifeste Visual Studio pour configurer le package. Par exemple, ajoutez des images de vignette et choisissez les orientations prises en charge par votre application.

3. Générez un package d’application. Utilisez l’Assistant Empaquetage Visual Studio pour créer un package d’application.

4. Exécutez, déboguez et testez une application empaquetée. Exécutez et déboguez votre package d’application à partir de Visual Studio ou en installant le package directement.

Avant de empaqueter votre application

1. Testez votre application. Avant de empaqueter votre application, assurez-vous qu’elle fonctionne comme prévu sur toutes les familles d’appareils que vous envisagez de prendre en charge. Ces familles d’appareils peuvent inclure des appareils de bureau, mobiles, Surface Hub, Xbox, IoT ou d’autres appareils. Pour plus d’informations sur le déploiement et le test de votre application à l’aide de Visual Studio, consultez Déploiement et débogage d’applications UWP (s’applique également aux applications de bureau empaquetées).

2. Optimisez votre application. Vous pouvez utiliser les outils de profilage et de débogage de Visual Studio pour optimiser les performances de votre application empaquetée. Par exemple, l’outil Chronologie pour la réactivité de l’interface utilisateur, l’outil Utilisation de la mémoire, l’outil Utilisation du processeur, etc. Pour plus d’informations sur ces outils, consultez la rubrique visite guidée des fonctionnalités de profilage.

3. Vérifiez la compatibilité .NET Native (pour les applications VB et C#). Dans la plateforme Windows universelle, un compilateur natif améliore les performances du runtime de votre application. Avec cette modification, vous devez tester votre application dans cet environnement de compilation. Par défaut, la configuration de build Release active la chaîne d’outils native .NET . Il est donc important de tester votre application avec cette configuration Release et de vérifier que votre application se comporte comme prévu.

Configurer votre projet

Le fichier manifeste d’application (Package.appxmanifest) est un fichier XML qui contient les propriétés et les paramètres requis pour créer votre package d’application. Par exemple, les propriétés du fichier manifeste de l’application décrivent l’image à utiliser comme vignette de votre application et les orientations prises en charge par votre application lorsqu’un utilisateur fait pivoter l’appareil.

Le concepteur de manifeste Visual Studio vous permet de mettre à jour le fichier manifeste sans modifier le xml brut du fichier.

Configurer un package avec le concepteur de manifeste

1. Dans l’Explorateur de solutions, développez le nœud de projet de votre projet d’application.

2. Double-cliquez sur le fichier Package.appxmanifest . Si le fichier manifeste est déjà ouvert dans la vue code XML, Visual Studio vous invite à fermer le fichier.

3. Vous pouvez maintenant décider comment configurer votre application. Chaque onglet contient des informations que vous pouvez configurer sur votre application et des liens vers plus d’informations si nécessaire.

   

   Vérifiez que vous disposez de toutes les images requises pour une application sous l’onglet Ressources visuelles . C’est là que vous fourniriez des icônes d’application et des logos.

   Sous l’onglet Empaquetage , vous pouvez entrer des données de publication. C’est là que vous pouvez choisir le certificat à utiliser pour signer votre application. Toutes les applications MSIX doivent être signées avec un certificat.

   Remarque

   À compter de Visual Studio 2019, un certificat temporaire n’est plus généré dans les projets de bureau ou UWP empaquetés. Pour créer ou exporter des certificats, utilisez les applets de commande PowerShell décrites dans cet article. Dans les versions récentes de Visual Studio, vous pouvez également signer votre application avec un certificat stocké dans Azure Key Vault pour les scénarios de développement et de test.

   Important

   Si vous publiez votre application dans le Microsoft Store, votre application est signée avec un certificat approuvé pour vous. Cela permet à l’utilisateur d’installer et d’exécuter votre application sans installer le certificat de signature d’application associé.

   Si vous installez le package d’application sur votre appareil, vous devez d’abord approuver le package. Pour approuver le package, le certificat doit être installé sur l’appareil de l’utilisateur.

4. Enregistrez votre fichier Package.appxmanifest après avoir apporté les modifications nécessaires pour votre application.

Si vous distribuez votre application via le Microsoft Store, Visual Studio peut associer votre package au Windows Store. Pour ce faire, cliquez avec le bouton droit sur le nom de votre projet dans l’Explorateur de solutions et choisissez Publier-Associer>une application au Store (avant Visual Studio 2019 version 16.3, le menu Publier est nommé Store). Vous pouvez également le faire dans l’Assistant Création de packages d’application , qui est décrit dans la section suivante. Lorsque vous associez votre application, certains des champs de l’onglet Empaquetage du concepteur de manifeste sont automatiquement mis à jour.

Générer un package d’application

Les applications peuvent être installées sans être publiées dans le Windows Store en les publiant sur votre site web, à l’aide d’outils de gestion des applications tels que Microsoft Intune et Configuration Manager, etc. Vous pouvez également installer directement un package MSIX pour les tests sur votre ordinateur local ou distant.

Créer un package d’application à l’aide de l’Assistant Empaquetage

Remarque

Les instructions et captures d’écran suivantes décrivent le processus à partir de Visual Studio 2019 version 16.3. Si vous utilisez une version antérieure, une partie de l’interface utilisateur peut sembler différente. Si vous empaquetagez une application de bureau, cliquez avec le bouton droit sur le nœud Projet d’empaquetage d’applications Windows.

1. Dans l’Explorateur de solutions, ouvrez la solution pour votre projet d’application.

2. Cliquez avec le bouton droit sur le projet et choisissez Publier-créer>des packages d’application (avant Visual Studio 2019 version 16.3, le menu Publier est nommé Store).

   

3. Sélectionnez Chargement indépendant dans la première page de l’Assistant, puis cliquez sur Suivant.

   

4. Dans la page Sélectionner une méthode de signature , indiquez s’il faut ignorer la signature d’empaquetage ou sélectionner un certificat pour la signature. Vous pouvez sélectionner un certificat dans votre magasin de certificats local, sélectionner un fichier de certificat ou créer un certificat. Pour qu’un package MSIX soit installé sur l’ordinateur d’un utilisateur final, il doit être signé avec un certificat approuvé sur l’ordinateur.

   

5. Terminez la page Sélectionner et configurer des packages , comme décrit dans la section Créer un fichier de chargement de package d’application à l’aide de la section Visual Studio .

Installer votre package d’application en double-cliquant sur

Les packages d’application peuvent être installés simplement en double-cliquant sur le fichier de package d’application. Pour ce faire, accédez à votre package d’application ou fichier de bundle d’applications, puis double-cliquez dessus. Le programme d’installation de l’application démarre et fournit les informations de base de l’application, ainsi qu’un bouton d’installation, une barre de progression de l’installation et tous les messages d’erreur pertinents.

Remarque

Le programme d’installation de l’application suppose que le package a été signé avec un certificat approuvé sur l’appareil. Si ce n’est pas le cas,vous devez installer le certificat de signature dans le magasin Personnes autorisées ou Autorités de certification racines de confiance. Si vous ne savez pas comment procéder, consultez l’installation des certificats de test.

Installer votre package d’application à l’aide d’un script d’installation

1. Ouvrez le dossier *_Test.

2. Cliquez avec le bouton droit sur le fichier Add-AppDevPackage.ps1 . Choisissez Exécuter avec PowerShell et suivez les invites.
   

   Une fois le package d’application installé, la fenêtre PowerShell affiche ce message : votre application a été correctement installée.

3. Cliquez sur le bouton Démarrer pour rechercher l’application par nom, puis lancez-la.

Étapes suivantes : Déboguer et tester votre package d’application

Consultez Exécuter, déboguer et tester un package d’application pour savoir comment déboguer votre application dans Visual Studio ou à l’aide des outils de débogage Windows.

Générer un fichier de chargement de package d’application pour la soumission du Windows Store

Pour distribuer votre application au Microsoft Store, nous vous recommandons de générer un fichier de chargement de package d’application (.msixupload ou .appxupload) et d’envoyer ce fichier à l’Espace partenaires. Bien qu’il soit possible de soumettre un package d’application ou un ensemble d’applications à l’Espace partenaires seul, nous vous recommandons de soumettre un fichier de chargement de package d’application à la place.

Vous pouvez créer un fichier de chargement de package d’application à l’aide de l’Assistant Création de packages d’application dans Visual Studio, ou vous pouvez en créer un manuellement à partir de packages d’application existants ou de bundles d’applications.

Remarque

Si vous souhaitez créer un package d’application (.msix or.appx) ou un bundle d’applications (.msixbundle ou .appxbundle) manuellement, consultez Créer un package d’application avec l’outil MakeAppx.exe.

Créer un fichier de chargement de package d’application à l’aide de Visual Studio

Remarque

Les instructions et captures d’écran suivantes décrivent le processus à partir de Visual Studio 2019 version 16.3. Si vous utilisez une version antérieure, une partie de l’interface utilisateur peut sembler différente.

1. Dans l’Explorateur de solutions, ouvrez la solution pour votre projet d’application UWP.

2. Cliquez avec le bouton droit sur le projet et choisissez Publier-créer>des packages d’application (avant Visual Studio 2019 version 16.3, le menu Publier est nommé Store). Si cette option est désactivée ou n’apparaît pas du tout, vérifiez que le projet est un projet Windows universel.

   

   L’Assistant Création de packages d’application s’affiche.

3. Sélectionnez Microsoft Store à l’aide d’un nouveau nom d’application dans la première boîte de dialogue, puis cliquez sur Suivant.

   

   Si vous avez déjà associé votre projet à une application dans le Windows Store, vous avez également la possibilité de créer des packages pour l’application Store associée. Si vous choisissez Sideloading, Visual Studio ne génère pas le fichier de téléchargement du package d'application (.msixupload ou .appxupload) pour les soumissions au Partner Center. Si vous souhaitez uniquement créer un packge MSIX ou un bundle pour la distribution non-Store, vous pouvez sélectionner cette option.

4. Dans la page suivante, connectez-vous avec votre compte de développeur à l’Espace partenaires. Si vous n’avez pas encore de compte de développeur, l’Assistant vous aidera à en créer un.

   

5. Sélectionnez le nom de l’application pour votre package dans la liste des applications actuellement inscrites sur votre compte, ou réservez-en un nouveau si vous n’en avez pas déjà réservé un dans l’Espace partenaires.

   Remarque

   Si vous utilisez Visual Studio 2017, vous ne pourrez pas répertorier les applications actuellement inscrites sur votre compte ou réserver de nouveaux noms d’applications lors de l’utilisation d’un compte Microsoft (MSA), seuls les comptes Azure Active Directory (AAD) fonctionneront. Les comptes MSA sont pris en charge à partir de Visual Studio 2019.

6. Veillez à sélectionner les trois configurations d’architecture (x86, x64 et ARM) dans la boîte de dialogue Sélectionner et configurer des packages pour vous assurer que votre application peut être déployée sur la plus grande gamme d’appareils. Dans la zone de liste Générer un bundle d’applications , sélectionnez Toujours. Un bundle d’applications (.appxbundle ou .msixbundle) est préféré à un seul fichier de package d’application, car il contient une collection de packages d’application configurés pour chaque type d’architecture de processeur. Lorsque vous choisissez de générer le bundle d’applications, le bundle d’applications est inclus dans le fichier de chargement final du package d’application (.appxupload ou .msixupload) ainsi que des informations de débogage et d’analyse sur incident. Si vous ne savez pas quelles architectures choisir ou si vous souhaitez en savoir plus sur les architectures utilisées par différents appareils, consultez les architectures de package d’application.

   

7. Incluez des fichiers de symboles publics pour analyser les performances de l’application à partir de l’Espace partenaires une fois votre application publiée. Configurez des détails supplémentaires tels que la numérotation de version ou l’emplacement de sortie du package.

8. Cliquez sur Créer pour générer le package d’application. Si vous avez sélectionné l’une des options Je veux créer des packages à charger sur le Microsoft Store à l'étape 3 et que vous créez un package pour la soumission au Centre de Partenaires, l'assistant créera un fichier de chargement de package (.appxupload ou .msixupload). Si vous avez sélectionné Je veux créer des packages pour le chargement indépendant à l’étape 3, l’Assistant crée un package d’application unique ou un bundle d’applications en fonction de vos sélections à l’étape 6.

9. Une fois votre application empaquetée, vous verrez cette boîte de dialogue et vous pouvez récupérer le fichier de chargement du package d’application à partir de l’emplacement de sortie spécifié. À ce stade, vous pouvez valider votre package d’application sur l’ordinateur local ou un ordinateur distant et automatiser les soumissions de magasin.

   

Créer votre fichier de chargement de package d’application manuellement

1. Placez les fichiers suivants dans un dossier :

   • Un ou plusieurs packages d’application (.msix ou .appx) ou un bundle d’applications (.msixbundle ou .appxbundle).
   • Fichier .appxsym. Il s’agit d’un fichier .pdb compressé contenant des symboles publics de votre application utilisés pour l’analyse des incidents dans l’Espace partenaires. Vous pouvez omettre ce fichier, mais si vous le faites, aucune information d'analyse d'incidents ou de débogage ne sera disponible pour votre application.

2. Sélectionnez tous les fichiers du dossier, cliquez avec le bouton droit sur les fichiers, puis sélectionnez Envoyer vers>

3. Remplacez le nom d’extension du nouveau fichier zip de .zip par .msixupload ou .appxupload.

Valider votre package d’applications

Validez votre application avant de l’envoyer à l’Espace partenaires pour la certification sur un ordinateur local ou distant. Vous pouvez uniquement valider les builds Release pour votre package d’application, pas les builds Debug. Pour plus d’informations sur l’envoi de votre application à l’Espace partenaires, consultez soumissions d’applications.

Valider votre package d’application localement

1. Dans la page finale Création du package terminée de l’assistant Créer des packages d'application, laissez l'option Ordinateur local sélectionnée et cliquez sur Exécuter le Kit de certification des applications Windows. Pour plus d’informations sur le test de votre application avec le Kit de certification des applications Windows, consultez le Kit de certification des applications Windows.

   Le Kit de certification des applications Windows (WACK) effectue différents tests et retourne les résultats. Pour plus d’informations, consultez les tests du Kit de certification des applications Windows.

   Si vous disposez d’un appareil Windows 10 distant que vous souhaitez utiliser pour les tests, vous devez installer manuellement le Kit de certification des applications Windows sur cet appareil. La section suivante vous guide tout au long de ces étapes. Une fois que vous avez terminé, vous pouvez sélectionner l’ordinateur distant , puis cliquer sur Lancer le Kit de certification des applications Windows pour vous connecter à l’appareil distant et exécuter les tests de validation.

2. Une fois que WACK a terminé et que votre application a passé la certification, vous êtes prêt à soumettre votre application à l’Espace partenaires. Veillez à charger le fichier approprié. L’emplacement par défaut du fichier se trouve dans le dossier racine de votre solution \[AppName]\AppPackages et se termine par l’extension de fichier .appxupload ou .msixupload. Le nom sera de la forme [AppName]_[AppVersion]_x86_x64_arm_bundle.appxupload ou [AppName]_[AppVersion]_x86_x64_arm_bundle.msixupload si vous avez choisi un ensemble d'applications avec toute l'architecture de package sélectionnée.

Valider votre package d’application sur un appareil Windows 10 distant

1. Activez votre appareil Windows 10 pour le développement en suivant les instructions d’activation de votre appareil pour le développement .

   Important

   Vous ne pouvez pas valider votre package d’application sur un appareil ARM distant pour Windows 10.

2. Téléchargez et installez les outils à distance pour Visual Studio. Ces outils sont utilisés pour exécuter le Kit de certification des applications Windows à distance. Vous pouvez obtenir plus d’informations sur ces outils, notamment sur l’emplacement où les télécharger en visitant Exécuter des applications MSIX sur un ordinateur distant.

3. Téléchargez le Kit de certification des applications Windows requis, puis installez-le sur votre appareil Windows 10 distant.

4. Sur la page Création du package complet de l’Assistant, choisissez la case d’option Ordinateur distant, puis choisissez le bouton de sélection en regard du bouton Tester la connection.

   Remarque

   Le bouton d’option Ordinateur distant est disponible uniquement si vous avez sélectionné au moins une configuration de solution prenant en charge la validation. Pour plus d’informations sur le test de votre application avec le WACK, consultez le Kit de certification des applications Windows.

5. Spécifiez un formulaire d’appareil à l’intérieur de votre sous-réseau, ou indiquez le nom ou l’adresse IP du serveur de noms de domaine d’un appareil situé en dehors de votre sous-réseau.

6. Dans la liste mode d’authentification , choisissez Aucun si votre appareil ne vous oblige pas à vous y connecter à l’aide de vos informations d’identification Windows.

7. Choisissez le bouton Sélectionner , puis cliquez sur le bouton Lancer le Kit de certification des applications Windows . Si les outils distants s’exécutent sur cet appareil, Visual Studio se connecte à l’appareil, puis effectue les tests de validation. Consultez les tests du Kit de certification des applications Windows.

Automatiser les soumissions du Windows Store

À compter de Visual Studio 2019, vous pouvez envoyer le fichier .appxupload généré directement dans le Microsoft Store à partir de l’IDE en sélectionnant l’envoi automatiquement au Microsoft Store après l’option de validation du Kit de certification des applications Windows à la fin de l’Assistant Création de packages d’application. Cette fonctionnalité tire parti d’Azure Active Directory pour accéder aux informations du compte espace partenaires nécessaires à la publication de votre application. Pour utiliser cette fonctionnalité, vous devez associer Azure Active Directory à votre compte Espace partenaires et récupérer plusieurs informations d’identification requises pour les soumissions.

Associer Azure Active Directory à votre compte Centre de partenaires

Avant de pouvoir récupérer les informations d’identification requises pour les soumissions automatiques du Windows Store, vous devez d’abord suivre ces étapes dans le tableau de bord de l’Espace partenaires si vous ne l’avez pas déjà fait.

1. Associez votre compte Espace partenaires au service Azure Active Directory de votre organisation. Si votre organisation utilise déjà Office 365 ou d’autres services professionnels de Microsoft, vous disposez déjà d’Azure AD. Sinon, vous pouvez créer un locataire Azure AD à partir de l’Espace partenaires sans frais supplémentaires.

2. Ajoutez une application Azure AD à votre compte espace partenaires. Cette application Azure AD représente l’application ou le service que vous utiliserez pour accéder aux soumissions de votre compte du Centre de développement. Vous devez affecter cette application au rôle Gestionnaire . Si cette application existe déjà dans votre annuaire Azure AD, vous pouvez la sélectionner dans la page Ajouter des applications Azure AD pour l’ajouter à votre compte du Centre de développement. Sinon, vous pouvez créer une application Azure AD sur la page Ajouter des applications Azure AD .

Récupérer les informations d’identification requises pour les soumissions

Ensuite, vous pouvez récupérer les informations d’identification de l’Espace partenaires requises pour les soumissions : l’ID de locataire Azure, l’IDclient et la clé cliente.

1. Accédez au tableau de bord de l’Espace partenaires et connectez-vous avec vos informations d’identification Azure AD.

2. Dans le tableau de bord de l’Espace partenaires, sélectionnez l’icône d’engrenage (en haut à droite du tableau de bord), puis sélectionnez Paramètres du développeur.

3. Dans le menu Paramètres du volet gauche, cliquez sur Utilisateurs.

4. Cliquez sur le nom de votre application Azure AD pour accéder aux paramètres de l’application. Dans cette page, copiez l’ID de locataire et les valeurs d’ID client .

5. Dans la section Clés , cliquez sur Ajouter une nouvelle clé. Dans l'écran suivant, copiez la valeur clé, qui correspond au secret client. Vous ne pourrez plus accéder à ces informations après avoir quitté cette page. Veillez donc à ne pas la perdre. Pour plus d’informations, consultez Gérer les clés pour une application Azure AD.

Configurer les soumissions automatiques du Windows Store dans Visual Studio

Une fois les étapes précédentes terminées, vous pouvez configurer les soumissions automatiques du Windows Store dans Visual Studio 2019.

1. À la fin de l’Assistant Création de packages d’application, sélectionnez Envoyer automatiquement au Microsoft Store après la validation du Kit de certification des applications Windows , puis cliquez sur Reconfigurer.

2. Dans la boîte de dialogue Configurer les paramètres de soumission du Microsoft Store , entrez l’ID de locataire Azure, l’ID client et la clé client.

   

   Important

   Vos informations d’identification peuvent être enregistrées dans votre profil pour être utilisées dans les soumissions ultérieures

3. Cliquez sur OK.

La soumission démarre une fois le test du Kit de certification des applications Windows terminé. Vous pouvez suivre la progression de la soumission dans la fenêtre Vérifier et publier .