WinUI

Générer une application créée avec WinUI 3 afin qu’elle puisse s’exécuter dans un format EXE autonome

Page mise à jour :
Date de création de la page :

Environnement d’exploitation

Windows
  • Windows 11
Studio visuel
  • Visual Studio 2022 version 17.12.3
.FILET
  • .NET 8
WinUI
  • WinUI 3
Kit de développement logiciel (SDK) d’application Windows
  • 1.6.3 (1.6.241114003)

Conditions préalables

Dans certains cas, des versions inférieures peuvent également fonctionner.

Windows
  • Windows 10
  • Windows 11
Studio visuel
  • Visual Studio 2022 version 17.12 ou ultérieure
.FILET
  • .NET 8 ou version ultérieure
Kit de développement logiciel (SDK) d’application Windows
  • 1.6.0 ou version ultérieure

Au début

Les applications créées avec WinUI 3 sont généralement des applications packagées qui ne peuvent s’exécuter que dans des circonstances particulières. Pour l’exécuter, vous devez le télécharger et l’installer à partir du Microsoft Store. Il existe également une méthode de distribution directe de fichiers, mais elle nécessite des procédures et des paramètres quelque peu compliqués, et ne convient pas à la distribution à un nombre indéterminé de personnes. Au lieu de cela, vous pouvez exécuter votre application dans un environnement hautement sécurisé.

La méthode introduite cette fois vous permet de créer un fichier EXE par une méthode non empaquetée, afin que vous puissiez distribuer le fichier EXE à l’utilisateur tel quel et l’exécuter. Si vous souhaitez qu’une application écrite avec WindowsForm ou WPF ressemble à celle que vous souhaitez qu’elle soit distribuée, cette approche est la solution.

Attention

Les produits liés à WinUI 3 sont constamment mis à jour, ils peuvent donc ne pas bien fonctionner en raison de versions différentes. Je pense que cette procédure fonctionnera si vous correspondez aux versions de l’IDE et du SDK, mais si elle ne fonctionne pas bien, faites attention aux différentes versions.

De plus, les programmes écrits avec unpackaged ont des fonctionnalités limitées par rapport aux programmes packagés. Il est difficile d’expliquer les détails, alors veuillez vérifier si cela fonctionne selon le programme que vous avez créé.

condition préalable

Mettre à jour Visual Studio 2022

En principe, il n’y a pas de problème tant que vous disposez de la dernière version. Du moins la version au début de cet article. Exécutez-le à partir du menu Visual Studio ou lancez le « Visual Studio Installer » à partir du menu Démarrer pour le mettre à jour.

Installer le SDK d’application Windows (SDK d’application Windows)

Le SDK d’application Windows inclus dans l’installation de Visual Studio est obsolète et doit être à jour. Veuillez le télécharger et l’installer à partir du site suivant.

Une fois exécuté, le lot sera lancé et mis à jour sans poser de questions.

Créer un projet

Après cela, créez le programme que vous souhaitez créer. Cette section décrit l’état du nouveau projet.

Mettre à jour la version du package avec NuGet

Assurez-vous que la version de « Microsoft.WindowsAppSDK » est au moins la version au début de cet article. Il n’y a aucun problème à ce que le « Microsoft.Windows.SDK.BuildTools » inclus soit à jour.

Si vous souhaitez effectuer la mise à jour, vous pouvez le faire à partir du package géré NuGet.

Désactiver le package

Ouvrez les propriétés du projet.

Dans la catégorie « Application > Packaging », il y a un élément appelé « Enabled MSIX Packaging for this Project », alors décochez-le.

Essayez-le

Si vous regardez l’exécution de débogage de la barre d’outils, je pense qu’il s’agit de « XXXX (Package) ». Vous pouvez le changer en « XXXX (Unpackaged) » à partir du choix, alors changez-le en Unpackaged.

Une fois que vous l’avez modifié, essayez de l’exécuter. Si vous pouvez l’exécuter sans erreur, il n’y a aucun problème.

Génération d’un fichier EXE

Vous pouvez distribuer le fichier EXE généré après la construction, mais cette fois-ci, je vais sortir le fichier exécutable à partir du menu « Publier ».

D’ailleurs, pour que le processus de « publication » soit effectué avec succès avec unpackaged, vous devez utiliser la commande « . Développement de bureau NET.

Cliquez avec le bouton droit sur le projet et choisissez Publier.

Si vous démarrez avec un nouveau projet, vous aurez trois profils créés dès le début, ce qui vous permet de sélectionner l’environnement dans lequel vous souhaitez déployer. Si vous mettez à jour un projet, etc., il se peut qu’il n’y ait pas de profil, alors dans ce cas, créez un nouveau profil.

Dans Plus d’actions, sélectionnez Modifier.

Pour une raison quelconque, les paramètres sont différents du profil, tels que les paramètres initiaux, et correspondent donc au profil comme suit.

Nom du paramètre, valeur de réglage, remarques
configuration Sortie xXX Veuillez le modifier en fonction de votre profil. S’il s’agit de win-x64, il s’agit de Release x64.
Cadre cible Alignez-vous sur votre projet actuel
Modes de déploiement Indépendant Dans la spécification actuelle, seul le terme « autonome » fonctionne.
Durée d’exécution cible win-xXX Veuillez le modifier en fonction de votre profil. S’il s’agit de win-x64, faites-le win-x64.
Emplacement cible Conservez la valeur par défaut
Création d’un seul fichier de Selon la spécification actuelle, il ne peut pas être exécuté même s’il est créé dans un seul fichier.
Prêt à courir arbitraire Jetez-y un coup d’œil si vous souhaitez améliorer vos performances.
Tronquage du code inutilisé arbitraire Cochez-le si vous souhaitez réduire la taille du fichier. Notez que cela ne fonctionnera pas en fonction de la création du programme.

Lorsque vous avez terminé, cliquez sur le bouton « Soumettre ».

Vérifiez que la publication a réussi sans erreur.

Vous pouvez ouvrir le fichier publié en cliquant sur le lien Emplacement cible.

Si vous pouvez exécuter le fichier EXE et le démarrer, vous êtes prêt à partir. Si vous souhaitez distribuer, vous devez prendre l’ensemble des fichiers dans ce dossier. 「. Vous pouvez supprimer les fichiers qui ne sont pas nécessaires à l’exécution, tels que les fichiers « .pdb ».

Préparez-vous à développer avec WinUI 3