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 architecture d’appareil unique. Par exemple, un package d’application x64 ou x86. Pour cibler plusieurs architectures avec un bundle d’applications, vous devez en générer une pour chaque architecture.

  • App Bundle (.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 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 possible, car elles permettent à votre application d’être disponible sur la plus large gamme possible d’appareils.

  • 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 bundle 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 permettant d’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 avec l’intention de l’envoyer à l’Espace partenaires pour la publication dans 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 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 Création d’un package d’application à l’aide de l’Assistant Création d’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 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 Présentation des fonctionnalités de profilage .

  3. Vérifiez la compatibilité de .NET Native (pour les applications Visual Basic et C#). Dans la plateforme Windows universelle, il existe un compilateur natif qui améliore 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 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 code XML brut du fichier.

Configurer un package avec le concepteur du 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 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.

    Manifest designer in Visual Studio

    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.

    À 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 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 une fois que vous avez 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 Windows Store (avant Visual Studio 2019 version 16.3, le menu Publier est nommé Store). Vous pouvez également effectuer cette opération 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 à 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 à 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 empaquetez une application de bureau, cliquez avec le bouton droit sur le nœud projet de création de packages 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).

    Context menu with navigation to Create App Packages

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

    Create Your Packages dialog window shown with Sideloading

  4. Dans la page Sélectionner la 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 à partir de 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.

    Create Your Packages dialog window shown with Signing

  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.

Notes

Le programme d’installation de l’application suppose que le package a été signé avec un certificat approuvé sur l’appareil. Si ce n’était pas le cas, vous devez installer le certificat de signature sur le magasin des autorités de certification des personnes approuvées ou des serveurs de publication approuvés sur l’appareil. Si vous ne savez pas comment procéder, consultez l’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.
    File explorer navigated to PowerShell script shown

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

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

É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 au 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 bundle d’applications à l’Espace partenaires seul, nous vous recommandons d’envoyer 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 en créer un manuellement à partir de packages d’application existants ou de bundles d’applications.

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 à 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 si elle n’apparaît pas, vérifiez que le projet est un projet d’application Windows universelle.

    Context menu with navigation to Create App Packages

    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.

    Create Your Packages dialog window shown with Microsoft Store

    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 Du Store associée. Si vous choisissez Chargement indépendant, Visual Studio ne génère pas le fichier de chargement de package d’application (.msixupload ou .appxupload) pour les soumissions de l’Espace partenaires. Si vous souhaitez uniquement créer un packge MSIX ou un bundle pour la distribution hors 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.

    Create App Packages window with app name selection shown

  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 si vous n’en avez pas déjà réservé un 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 grande gamme d’appareils. Dans la zone de liste Generate app bundle, sélectionnez Always. 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 d’analyse sur le débogage et les incidents. 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.

    Create App Packages window with package configuration shown

  7. Incluez des fichiers de symboles publics pour analyser les performances de l’application à 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’un des packages à charger dans les options du Microsoft Store à l’étape 3 et que vous créez un package pour la soumission de l’Espace partenaires, l’Assistant crée un fichier de chargement de package (.appxupload ou .msixupload). Si vous avez sélectionné je souhaite 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, cette boîte de dialogue s’affiche 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.

    Package creation completed window with validation options shown

Créer manuellement un fichier de chargement de 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).
    • Fichier .appxsym. Il s’agit d’un fichier .pdb compressé contenant des symboles publics de votre application utilisés pour l’analytique sur incident dans l’Espace partenaires. Vous pouvez omettre ce fichier, mais si vous le faites, aucune information d’analyse ou de débogage sur incident n’est disponible pour votre application.
  2. Sélectionnez tous les fichiers du dossier, cliquez avec le bouton droit sur les fichiers, puis sélectionnez Envoyer au dossier ->Compressed (compressé).

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

Valider votre package d'application

Validez votre application avant de l’envoyer à l’Espace partenaires pour certification sur un ordinateur local ou distant. Vous pouvez uniquement valider les builds de mise en production pour votre package d’application, et non pas les builds de débogage. 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 de package terminée de l’Assistant Création de 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. 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 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 a 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 sera du formulaire [AppName]_[AppVersion]_x86_x64_arm_bundle.appxupload ou [AppName]_[AppVersion]_x86_x64_arm_bundle.msixupload si vous avez choisi un bundle d’applications avec 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 où les télécharger en consultant les applications Run 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

    Le bouton 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 distants 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 Windows Store

À compter de Visual Studio 2019, vous pouvez envoyer le fichier .appxupload généré directement à partir de l’IDE à 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 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 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 à 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 dans 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’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 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 de l’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 après avoir quitté cette page. Veillez donc à ne pas la perdre. Pour plus d’informations, voir Gérer les clés pour une application Azure AD.

Configurer les soumissions automatiques du Windows Store dans Visual Studio

Une fois que vous avez effectué les étapes précédentes, vous pouvez configurer les soumissions de Magasin automatique dans Visual Studio 2019.

  1. À la fin de l’Assistant Création de packages d’applications, 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.

    Configure Microsoft Store Submission settings

    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 WACK terminé. Vous pouvez suivre la progression de la soumission dans la fenêtre Vérifier et publier .

Verify and Publish progress