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.

winapp CLI face à Visual Studio pour l'empaquetage 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.

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.

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 commande winapp pack pour 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é.

Source