Je me souviens du temps où fabriquer une application Windows native voulait dire une seule chose : ouvrir Visual Studio, patienter le temps que les workloads s'installent, puis naviguer dans une dizaine de menus avant de voir la moindre fenêtre s'afficher à l'écran. Microsoft a changé la donne avec winapp, un outil en ligne de commande qui fait à peu près tout ce que fait l'IDE côté empaquetage Windows, mais depuis un simple terminal : création du projet, compilation, lancement avec une vraie identité de paquet, et sortie finale sous la forme d'un fichier d'installation MSIX. L'outil reste officiellement en Public Preview, mais il a déjà connu plusieurs mises à jour depuis son lancement et fonctionne très bien pour un cas d'usage simple. Je vous propose donc un tutoriel pas à pas pour afficher un Hello World dans une vraie fenêtre Windows, sans jamais ouvrir Visual Studio.
Qu'est-ce que winapp, le CLI Windows de Microsoft
winapp (le nom s'écrit tout en minuscules, y compris dans les commandes) est publié par Microsoft sur GitHub sous le dépôt winappCli. L'outil regroupe dans une seule interface la gestion des SDK Windows, l'empaquetage MSIX, la génération d'identité d'application, les manifestes et les certificats. Il ne se limite pas au C# : il fonctionne aussi bien avec des projets .NET (WinUI 3, WPF, WinForms, console) qu'avec du C++ via CMake, de l'Electron, du Rust, du Flutter ou du Tauri. Concrètement, il sert de pont entre un développement multiplateforme et les fonctionnalités propres à Windows.
| Critère | Visual Studio | winapp CLI |
|---|---|---|
| Installation | Plusieurs Go, workloads à cocher | Un seul paquet via winget, quelques dizaines de Mo |
| Interface | IDE complet avec éditeur intégré | Terminal, à combiner avec l'éditeur de votre choix |
| Automatisation / CI | Possible mais lourd à scripter | Pensé pour les pipelines (GitHub Actions, Azure DevOps) |
| Frameworks pris en charge | Essentiellement .NET et C++ Microsoft | .NET, C++, Electron, Rust, Flutter, Tauri |
| Statut | Produit mature | Public Preview, mises à jour fréquentes |
| Les deux outils reposent sur le même Windows App SDK. winapp ne remplace pas Visual Studio, il en propose une alternative en ligne de commande. | ||
Pourquoi l'identité de paquet change la donne
On pourrait se demander à quoi bon empaqueter une application qui fonctionne déjà avec un simple .exe. La réponse tient en un mot : l'identité. De nombreuses API Windows exigent que votre application dispose d'une identité de paquet pour s'exécuter, un peu comme un badge d'accès à l'entrée d'un bâtiment. Sans elle, plusieurs fonctions modernes de l'OS restent hors de portée.
- Notifications interactives natives
- Intégration avec l'explorateur de fichiers, la barre des tâches et le volet de partage
- Gestionnaires de protocole personnalisés (
votreapp://) - Liaison web-vers-application (un lien depuis votresite.com ouvre directement l'app)
- API d'IA embarquée sur l'appareil (modèle de langage local, texte et image)
- Alias d'exécution personnalisés en ligne de commande
- Accès contrôlé à la caméra, au micro ou à la localisation, avec consentement de l'utilisateur
- Tâches en arrière-plan et tâches au démarrage
- Associations de types de fichiers
- Installation, désinstallation propre et mises à jour automatiques
Ce qu'il vous faut avant de commencer
Il vous faut Windows 10 version 1809 au minimum (ou une version plus récente), le mode développeur activé dans Paramètres, Système, Options avancées, et le SDK .NET 10 ou plus récent. Visual Studio, en revanche, n'est pas nécessaire. Les deux installations se font via winget, dans un terminal classique :
winget install Microsoft.DotNet.SDK.10 --source winget
winget install Microsoft.winappcli --source winget
Le nom du paquet côté winget est bien Microsoft.winappcli, tout en minuscules : c'est aussi la graphie qu'utilise Microsoft partout dans sa documentation et sur son dépôt GitHub.
Faites ensuite un winapp --version pour vérifier que le CLI répond correctement.
Créer le projet avec winapp new
La commande new fabrique l'application à partir des modèles WinUI 3 officiels de Microsoft, réunis dans le paquet Microsoft.WindowsAppSDK.WinUI.CSharp.Templates, que winapp télécharge automatiquement au premier lancement si besoin. Sans option, elle pose des questions ; avec celles ci-dessous, elle ne demande rien et prend le modèle le plus dépouillé du lot :
winapp new --template winui --name HelloWinapp --use-defaults
cd HelloWinapp
Vous récupérez alors un projet C# complet, avec son manifeste de paquet et ses icônes déjà générées. Le modèle winui vous donne une fenêtre vide, ce qui tombe bien puisqu'on va justement écrire dedans.
Le catalogue de modèles s'est bien étoffé depuis les débuts de l'outil. Un winapp new --list affiche tous les modèles disponibles : winui (application vide), winui-navview (avec menu de navigation), winui-tabview (avec onglets), winui-mvvm (prêt pour le pattern MVVM avec CommunityToolkit.Mvvm), winui-lib (bibliothèque de composants partagés) et winui-unittest (projet de tests). Il existe même une famille de modèles Reactor, encore expérimentale, qui remplace le XAML par du C# pur selon un pattern MVU.
Écrire le Hello World
Attention, il y a un petit piège à ce stade. Le fichier qui décrit la fenêtre principale s'appelle MainWindow.xaml, mais ce n'est pas lui qu'il faut toucher dans le modèle par défaut. Ouvrez plutôt MainPage.xaml, à la racine du projet, et remplacez son <Grid /> vide par ces quelques lignes :
<Grid>
<TextBlock Text="Hello World !"
HorizontalAlignment="Center"
VerticalAlignment="Center"
FontSize="48" />
</Grid>
Un simple winapp run construit ensuite le projet, l'enregistre auprès de Windows avec une identité de paquet qui pointe directement sur votre dossier de build, puis le lance. Votre fenêtre s'ouvre alors avec le Hello World au centre :
winapp run
Vous venez de faire un Hello World, mais si vous demandez un coup de main à une IA pour la partie XAML ou C#, rien ne vous empêche de construire quelque chose de nettement plus élaboré sans forcément maîtriser tout le framework WinUI, et toujours sans ouvrir Visual Studio.
Sortir le fichier d'installation MSIX
Maintenant, à quoi bon empaqueter l'application plutôt que de distribuer le simple .exe ? Cette identité de paquet n'est pas de la paperasse administrative : c'est elle qui débloque les notifications natives, les associations de fichiers, les protocoles maison et les API d'IA locale évoquées plus haut. Pour publier sérieusement votre application, il faut d'abord la compiler dans un dossier :
dotnet publish -o ./publish
L'empaquetage génère au passage un certificat de développement et l'installe dans le magasin Personnes de confiance de la machine. Attention, la commande qui suit réclame un terminal ouvert en administrateur, dans lequel il faudra refaire le cd vers votre dossier de projet pour qu'elle s'y retrouve :
winapp pack ./publish --generate-cert --install-cert
Vous obtenez un fichier .msix signé, nommé d'après l'identité du paquet, sa version et son architecture. Cette identité est générée sous forme de GUID par le modèle : inutile donc de chercher le nom de votre application dans le nom du fichier. Ne l'envoyez pas tel quel à un collègue, en revanche, car le paquet réclamera le runtime Windows App SDK sur la machine de destination. Ajoutez --self-contained à la commande pack pour embarquer le runtime directement dans le paquet. Le certificat, lui, reste local à votre machine de développement : sur un autre poste, Windows refusera le paquet tant que ce certificat n'y sera pas installé également.
Pour une distribution multi-architecture (x64 et Arm64 par exemple), winapp pack accepte plusieurs dossiers d'entrée et génère directement un .msixbundle, prêt pour une soumission au Microsoft Store.
Ce que winapp sait faire d'autre
L'outil a beaucoup évolué depuis sa sortie initiale et il vaut le détour au-delà du simple Hello World.
winapp ui: une suite de commandes d'automatisation d'interface (inspection de l'arbre UI, clic, saisie de texte, capture d'écran, et même enregistrement vidéo MP4 des interactions), utile pour scripter des tests de bout en bout sur une application WinUI- Une extension Visual Studio Code officielle, qui permet d'initialiser un projet, de déboguer avec identité, d'empaqueter et de signer sans quitter l'éditeur, avec un simple F5 pour lancer l'app avec son identité de paquet et attacher automatiquement un débogueur
- Un plugin dédié pour les agents de code IA (GitHub Copilot CLI et Claude Code), qui leur donne une compréhension complète des commandes et du fonctionnement de winapp
Foire aux questions
- Faut-il vraiment installer Visual Studio pour utiliser winapp ?
- Non. winapp fonctionne comme un outil indépendant, à condition d'avoir le SDK .NET pour les projets .NET, ou les outils de build correspondant à votre framework pour les autres langages.
- winapp est-il prêt pour un usage en production ?
- L'outil reste étiqueté Public Preview par Microsoft. Il fonctionne déjà bien pour des cas simples comme celui de ce tutoriel, mais il évolue vite : les options et le comportement de certaines commandes peuvent changer d'une version à l'autre.
- winapp fonctionne-t-il avec un autre langage que le C# ?
- Oui. Le CLI prend en charge le C++ via CMake, l'Electron et Node.js, le Rust, le Flutter et le Tauri, en plus des projets .NET classiques comme WinUI 3, WPF, WinForms ou une simple application console.
- Comment partager mon application avec quelqu'un qui n'a pas le SDK installé ?
- Ajoutez l'option
--self-containedà la commandewinapp packpour embarquer le runtime Windows App SDK dans le paquet, et faites installer votre certificat de développement sur la machine de destination avant d'ouvrir le fichier .msix.
Entre la commande new qui prépare un projet WinUI 3 complet et la commande pack qui produit un .msix signé, winapp couvre l'essentiel du cycle de vie d'une application Windows sans jamais ouvrir Visual Studio. Si vous testez l'outil sur un projet existant, je serais curieux de savoir avec quel framework vous l'avez essayé.