Empaqueter une application de bureau ou UWP dans Visual Studio

Avant de distribuer votre application, vous devez l’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)
    Un package unique qui contient votre application et ses ressources, ciblant une architecture d’appareil unique. Par exemple, un package d’application x64 ou x86. Pour cibler plusieurs architectures avec une offre groupée d’applications, vous devez en générer une pour chaque architecture.

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

  • Fichier de chargement du package d’application (. msixupload ou. appxupload)-pour l’envoi au magasin uniquement
    Fichier unique qui peut contenir plusieurs packages d’application ou un lot d’applications pour prendre en charge différentes architectures de processeur. Le fichier de téléchargement de 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 empaquetez votre application avec Visual Studio dans le but de la soumettre à l’espace partenaires pour la publication sur le Microsoft Store.

Voici une vue d’ensemble des étapes de préparation et de création d’un package d’application :

  1. Avant de créer un package pour 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 de 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 de 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 créer un package pour votre application

  1. Testez votre application. Avant d’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 ordinateurs de bureau, des appareils mobiles, des Surface Hub, des Xbox, des appareils IoT, etc. 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 de chronologie pour la réactivité de l’interface utilisateur, l’outil utilisation de la mémoire, l’outil utilisation de l’UC, et bien plus encore. Pour plus d’informations sur ces outils, consultez la rubrique Présentation de la fonctionnalité de profilage .

  3. Vérifiez la compatibilité de .NET Native (pour les applications Visual Basic et C#). Dans le plateforme Windows universelle, il existe un compilateur natif qui améliorera les performances d’exécution de votre application. Avec cette modification, vous devez tester votre application dans cet environnement de compilation. Par défaut, la configuration de la version Release active le .net Native chaîne d’outils. 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 de l’application (package. appxmanifest) est un fichier XML qui contient les propriétés et les paramètres nécessaires à la création de 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 que votre application prend en charge lorsqu’un utilisateur fait pivoter l’appareil.

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

Configurer un package avec le concepteur du manifeste

  1. Dans 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 le mode 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 pour votre application ainsi que des liens vers des informations supplémentaires si nécessaire.

    Concepteur de manifeste dans Visual Studio

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

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

    Notes

    À compter de Visual Studio 2019, un certificat temporaire n’est plus généré dans les projets de bureau du package ou UWP. 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 Microsoft Store, votre application sera 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 à 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 Explorateur de solutions et choisissez publier -> l'application associée avec le Windows Store (avant Visual Studio 2019 version 16,3, le menu publier est nommé magasin). Vous pouvez également effectuer cette opération dans l’Assistant créer des packages d’application , qui est décrit dans la section suivante. Lorsque vous associez votre application, certains champs de l’onglet Packaging 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 magasin en les publiant sur votre site Web, à l’aide d’outils de gestion d’applications tels que Microsoft Intune et Configuration Manager, etc. Vous pouvez également installer directement un package MSIX à des fins de test sur votre ordinateur local ou distant.

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

Notes

Les instructions et captures d’écran suivantes décrivent le processus à compter de Visual Studio 2019 version 16,3. Si vous utilisez une version antérieure, une partie de l’interface utilisateur peut paraître différente. Si vous empaquetez une application de bureau, cliquez avec le bouton droit sur le nœud du projet de packaging des applications Windows.

  1. Dans 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é magasin).

    Menu contextuel avec navigation vers Créer des packages d’application

  3. Sélectionnez chargement dans la première page de l’Assistant, puis cliquez sur suivant.

    Boîte de dialogue créer vos packages affichée avec chargement

  4. Sur la page Sélectionner la méthode de signature , indiquez si vous souhaitez ignorer la signature de l’empaquetage ou sélectionner un certificat pour la signature. Vous pouvez sélectionner un certificat à partir de votre magasin de certificats local, sélectionner un fichier de certificat ou créer un nouveau 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.

    Boîte de dialogue créer vos packages affichée avec signature

  5. Complétez la page Sélectionner et configurer des packages comme décrit dans la section création d’un fichier de chargement de package d’application à l’aide de Visual Studio .

Installer votre package d’application en double-cliquant

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 fichier de package d’application ou de lot 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 installer, la barre de progression de l’installation et tous les messages d’erreur pertinents.

Notes

Le programme d’installation d’application part du principe 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 des éditeurs approuvés sur l’appareil. Si vous ne savez pas comment procéder, consultez Installation de 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.
    Explorateur de fichiers affichant le script PowerShell

    Lorsque le package d’application a été 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 son 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 vous pouvez 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 l’envoi au magasin

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

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

Notes

Si vous souhaitez créer un package d’application (. msix ou. 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

Notes

Les instructions et captures d’écran suivantes décrivent le processus à compter de Visual Studio 2019 version 16,3. Si vous utilisez une version antérieure, une partie de l’interface utilisateur peut paraître 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é magasin). Si cette option est désactivée ou si elle n’apparaît pas, vérifiez que le projet est un projet d’application Windows universelle.

    Menu contextuel avec navigation vers Créer des packages d’application

    L’assistant Créer des 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.

    Boîte de dialogue créer vos packages affichée avec Microsoft Store

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

  4. Sur 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 aide à en créer un.

    Fenêtre Créer des packages d’application avec la sélection de nom d’application affichée

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

  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 large gamme d’appareils. Dans la zone de liste Generate app bundle, sélectionnez Always. Un bundle d’applications (. appxbundle ou. msixbundle) est préférable à 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 l’offre groupée d’applications, l’offre groupée d’applications est incluse dans le fichier de téléchargement de package d’application (. appxupload ou. msixupload) final, ainsi que les informations analytiques de débogage et d’incident. Si vous n’êtes pas sûr de la ou des architectures à choisir, ou si vous souhaitez en savoir plus sur les architectures utilisées par différents appareils, consultez architectures de package d’application.

    Fenêtre Créer des packages d’application avec la configuration de package affichée

  7. Incluez les fichiers de symboles publics pour analyser les performances des applications à partir de l’espace partenaires après la publication de votre application. 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 souhaite créer des packages à télécharger dans les Microsoft Store à l' étape 3 et que vous créez un package pour l’envoi de l’espace partenaires, l’Assistant crée un fichier de téléchargement de package (. appxupload ou. msixupload). Si vous avez choisi de créer des packages pour chargement à l’étape 3, l’Assistant crée soit un package d’application unique, soit un bundle d’applications en fonction de vos sélections à l’étape 6.

  9. Une fois votre application correctement empaquetée, cette boîte de dialogue s’affiche et vous pouvez récupérer le fichier de téléchargement de votre 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 sur un ordinateur distant et automatiser les soumissions du magasin.

    Fenêtre de création de package terminée avec options de validation affichées

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

  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).
    • Un fichier. appxsym. Il s’agit d’un fichier. pdb compressé contenant les 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 ou de débogage sur incident ne sera disponible pour votre application.
  2. Sélectionnez tous les fichiers dans le dossier, cliquez avec le bouton droit sur les fichiers, puis sélectionnez Envoyer vers le -> dossier compressé.

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

Valider votre package d'application

Validez votre application avant de la soumettre à l’espace partenaires pour la certification sur un ordinateur local ou distant. Vous pouvez valider uniquement les versions release pour votre package d’application, pas les versions Debug. Pour plus d’informations sur l’envoi de votre application à l’espace partenaires, consultez la page envoisde l’application.

Valider votre package d’application localement

  1. Dans la page fin de la création du package final de l’Assistant créer des packages d’application , laissez l’option ordinateur local sélectionnée, puis cliquez sur lancer 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, voir Kit de certification des applications Windows.

    Le kit de certification des applications Windows (WACK) effectue différents tests et retourne les résultats. Consultez tests du kit de certification des applications Windows pour obtenir des informations plus spécifiques.

    Si vous disposez d’un appareil Windows 10 distant que vous souhaitez utiliser pour le test, vous devez installer manuellement le kit de certification des applications Windows sur cet appareil. La section suivante vous guidera lors de ces étapes. Une fois cette opération terminée, vous pouvez sélectionner Remote machine, puis cliquer sur Launch Windows App Certification Kit pour vous connecter à l’appareil distant et exécuter les tests de validation.

  2. Une fois que WACK est terminé et que votre application a passé la certification, vous êtes prêt à soumettre votre application à l’espace partenaires. Assurez-vous de 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 se présente sous la forme [AppName]_[AppVersion]_x86_x64_arm_bundle.appxupload ou [AppName]_[AppVersion]_x86_x64_arm_bundle.msixupload si vous avez opté pour un lot d’applications avec l’ensemble de 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 Activer 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 de contrôle à distance de Visual Studio. Ils 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 de leur téléchargement 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 Package Creation Completed de l’Assistant, choisissez la case d’option Remote Machine, puis choisissez le bouton de sélection en regard du bouton Test Connection.

    Notes

    La case d’option ordinateur distant est disponible uniquement si vous avez sélectionné au moins une configuration de solution qui prend en charge la validation. Pour plus d’informations sur le test de votre application avec le Kit de certification des applications Windows, voir Kit de certification des applications Windows.

  5. Spécifiez une forme d’appareil dans votre sous-réseau, ou fournissez le nom de serveur de nom de domaine (DNS, Domain Name System) ou l’adresse IP d’un appareil en dehors de votre sous-réseau.

  6. Dans la liste Authentication Mode, choisissez None si votre appareil ne requiert pas d’authentification avec vos informations d’identification Windows.

  7. Choisissez le bouton Select, puis le bouton Launch Windows App Certification Kit. Si les outils de contrôle à distance s’exécutent sur cet appareil, Visual Studio se connecte à l’appareil, puis effectue les tests de validation. Voir Tests du kit de certification des applications Windows.

Automatiser les soumissions du magasin

À compter de Visual Studio 2019, vous pouvez envoyer le fichier. appxupload généré au Microsoft Store directement à partir de l’IDE en sélectionnant l’option Envoyer automatiquement à l’Microsoft Store après la validation du kit de certification des applications Windows à la fin de l' Assistant créer des packages d’application. Cette fonctionnalité s’appuie sur Azure Active Directory pour accéder aux informations de compte de l’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 espace partenaires

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

  1. Associez votre compte espace partenaires au 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. Dans le cas contraire, 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 Azure AD application représente l’application ou le service que vous allez utiliser pour accéder aux soumissions de votre compte 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 dans la page Ajouter des applications Azure AD.

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

Ensuite, vous pouvez récupérer les informations d’identification de l’espace partenaires requises pour les envois : l' ID de locataire Azure, l' ID client et la clé cliente.

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

  2. Dans le tableau de bord de l’espace partenaires, sélectionnez l’icône d’engrenage (près de l’angle supérieur droit 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 de clé qui correspond à la clé secrète client. Vous ne pourrez plus accéder à ces informations une fois que vous aurez quitté cette page, veillez à ne pas les perdre. Pour plus d’informations, voir Gérer les clés pour une application Azure AD.

Configurer les envois de banque automatique dans Visual Studio

Une fois les étapes précédentes terminées, vous pouvez configurer les envois de banque automatique 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 d’envoi Microsoft Store , entrez l’ID de locataire, l’ID de client et la clé client Azure.

    Configurer les paramètres d’envoi Microsoft Store

    Important

    Vos informations d’identification peuvent être enregistrées dans votre profil pour être utilisées dans de futures soumissions.

  3. Cliquez sur OK.

La soumission démarre une fois le test WACK terminé. Vous pouvez suivre la progression de l’envoi dans la fenêtre vérifier et publier .

Progression de la vérification et de la publication