Winapp – Comment créer une app Windows native sans Visual Studio

Pour fabriquer une application Windows native, le passage par Visual Studio était jusqu’ici la voie normale. Mais c’était sans compter sur Microsoft qui a publié

winapp

, un outil en ligne de commande qui permet de faire tout pareil directement depuis un terminal : il crée le projet, le construit, le lance avec son identité de paquet et sort le résultat sous la forme d’un fichier d’installation MSIX.

C’est encore estampillé en version “expérimentale” par ses auteurs, mais ça fonctionne déjà très bien pour des trucs basiques. C’est pour ça qu’aujourd’hui, je vous propose un petit tuto pour afficher un Hello World dans une vraie fenêtre Windows. Vous allez voir, c’est fastoche !

Ce qu’il faut avant de commencer

Il vous faut donc Windows 10 version 1809 au minimum, le mode développeur activé dans Paramètres, Système, Options avancées, et le SDK .NET 10 ou plus récent. Visual Studio, non par contre, y’en a pas besoin. Les deux installations se font via winget, dans un terminal normal :

winget install Microsoft.DotNet.SDK.10
winget install Microsoft.winappcli --source winget

Faites ensuite un winapp --version et vous saurez si le CLI répond.

Créez le projet

La commande new fabrique l’application à partir des modèles WinUI 3 officiels, qu’elle télécharge toute seule dès qu’on la lance. Sans option elle vous pose des questions, mais avec celles que je vous mets ci-dessous, elle ne demandera rien et prendra le modèle le plus dépouillé du lot :

winapp new --template winui --name HelloKorben --use-defaults
cd HelloKorben

Vous récupérez alors un projet C# complet, avec son manifeste de paquet et ses icônes. Et surtout, le modèle winui vous donne une fenêtre vide, ce qui tombe bien puisqu’on va écrire dedans. Notez que le pack de modèles est encore publié en 0.0.6-alpha, donc si un nom de fichier a bougé depuis, winapp new --list vous sortira la liste de ce que le vôtre propose.

Écrire le Hello World

Attention, là y’a un petit piège ! Le fichier qui décrit la fenêtre s’appelle MainWindow.xaml, sauf que ce n’est pas celui-là qu’il faut toucher. Ouvrez plutôt MainPage.xaml, qui est à 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>

Ensuite, un petit winapp run construira le projet, l’enregistrera auprès de Windows avec une identité de paquet qui pointe droit sur votre dossier de build, et le lancera. Votre fenêtre s’ouvre alors avec le Hello World au milieu :

winapp run

La fenêtre HelloKorben ouverte par winapp run, et derrière, le terminal qui vient de la construire en 12 secondes

Bon, là, on a fait un Hello World, mais bien sûr, si vous faites chauffer une IA là-dessus, vous pouvez faire des trucs un peu plus complexes sans forcément savoir coder, et tout ça, une fois encore, sans Visual Studio.

Sortir le fichier d’installation

Maintenant, à quoi bon empaqueter ?

Cette identité de paquet, ce n’est pas de la paperasse. En fait c’est elle qui ouvre à votre application les notifications natives, les associations de fichiers, les protocoles maison et les API d’IA locale de Windows. Donc si vous voulez du sérieux, il faut publier l’application compilée dans un dossier, et ça, c’est possible comme ceci directement dans votre terminal :

dotnet publish -o ./publish

L’empaquetage fabrique au passage un certificat de développement et l’installe dans le magasin Personnes de confiance de la machine mais faut que je vous prévienne, la commande qui suit réclame un terminal ouvert en admin dans lequel il faudra refaire le cd vers votre dossier de projet pour qu’il s’y retrouve.

winapp pack ./publish --generate-cert --install-cert

Le MSIX signé sort dans le dossier du projet, nommé d’après le GUID du paquet

Vous obtenez alors un .msix signé, nommé d’après l’identité du paquet, sa version et son architecture, qui s’installe chez vous d’un double clic. Et cette identité, le modèle la génère sous forme de GUID : ne cherchez pas le nom de votre application dans le nom du fichier. Par contre, ne l’envoyez pas tel quel à un collègue, parce que le paquet réclamera le runtime Windows App SDK. Ajoutez --self-contained à la commande pack et le runtime partira dans le paquet. Le certificat, lui, reste un certificat de développement local : sur le PC d’en face, Windows refusera le paquet tant que ce certificat n’y sera pas installé aussi.

Maintenant, si vous vous demandez à quoi sert vraiment ce CLI, c’est surtout l’étape MSIX qui sera moins douloureuse car vous n’aurez pas besoin de lancer Visual Studio.

Source :

Neowin