Créer votre première application WinUI

Créez votre première application WinUI et voyez-la prendre vie sous Windows. Ce guide de démarrage rapide vous guide de la configuration de l’outil vers une application en cours d’exécution, puis vous guide tout au long de votre première mise à jour de l’interface.

Avant de commencer

Ce que vous allez découvrir

  • Choisissez et configurez vos outils de développement.
  • Créez et exécutez une application WinUI.
  • Mettez à jour l’interface et voyez votre modification dans l’application en cours d’exécution.

Choisir vos outils de développement

Suivez l’un des parcours recommandés dans ce guide de démarrage rapide :

  • interface CLI winapp : Travailler à partir d’un terminal dans votre éditeur préféré. Ce flux de travail en ligne de commande fonctionne également bien pour le codage agentique.
  • Visual Studio : utilisez une expérience de développement et de débogage intégrée.

Si vos outils sont déjà installés, accédez à Créer votre première application.

Installation des outils

  1. Activez le mode Développeur. Vous pouvez ouvrir les paramètres dans Paramètres développeur.

  2. Installez le SDK .NET 10 et l’outil en ligne de commande application Windows Development. Si vous utilisez WinGet, exécutez :

    winget install --id Microsoft.DotNet.SDK.10 --exact --source winget
winget install --id Microsoft.WinAppCLI --exact --source winget

    Ignorez l’installation si l’outil requis est déjà installé.

  3. Ouvrez un nouveau terminal pour qu’il récupère les commandes installées, puis vérifiez les versions :

    dotnet --version
winapp --version

    Utilisez le SDK .NET 10 ou une version ultérieure et winapp CLI 0.6 ou une version ultérieure pour ce flux de travail.

Note

winapp CLI est en préversion publique. winapp new gère les modèles de projet WinUI, mais winapp new n’installe pas le SDK .NET. Consultez l’annonce de CLI 0.6 pour le nouveau projet et les nouvelles commandes d’exécution.

Créer votre première application

Utilisez le flux de travail que vous avez installé ci-dessus pour créer et lancer le projet.

Depuis le dossier où vous stockez vos projets, exécutez :

winapp new --name MyWinUIApp --template winui --use-defaults
cd MyWinUIApp
winapp run

winapp new crée l’application WinUI vide. winapp run compile le projet et le lance ; vous n’avez pas besoin d’une commande distincte de compilation ou d’empaquetage.

Votre application ouvre une fenêtre sur le bureau. Poursuivez avec Effectuer une modification ci-dessous.

Apporter une modification

Conservez le projet que vous venez de créer. Ajoutez un message à son interface existante :

  1. Fermez l’application ouverte. Ouvrez MainPage.xaml dans votre éditeur. Si votre modèle ne contient pas ce fichier, ouvrez plutôt MainWindow.xaml.

  2. Recherchez le panneau de disposition qui contient le contenu de l’application. Dans le modèle vide CLI actuel, MainPage.xaml contient un <Grid /> vide. Remplacez cette grille vide par :

    <Grid>
    <TextBlock
        Text="Hello, WinUI!"
        HorizontalAlignment="Center"
        VerticalAlignment="Center" />
</Grid>

    Si le panneau contient déjà des contrôles, ajoutez uniquement le TextBlock dans ce panneau. Conservez les contrôles, noms et gestionnaires d’événements existants. Ne remplacez pas l’environnement Page ou Windowla barre de titre et le cadre dans MainWindow.xaml.

  3. Enregistrez le fichier. Exécutez winapp run à nouveau à partir du dossier du projet, ou appuyez sur F5 dans Visual Studio.

Félicitations ! Vous avez créé, exécuté et mis à jour votre première application WinUI. La fenêtre affiche maintenant Hello, WinUI !

Résolution des problèmes

Problème Que vérifier
winapp ou dotnet ne sont pas reconnus. Rouvrez le terminal après l’installation. Utilisez les commandes version dans l’onglet CLI pour vérifier que les deux outils sont bien disponibles.
winapp new n’est pas reconnu. Ce flux de travail nécessite winapp CLI 0.6 ou une version ultérieure. Mettez à jour le CLI à l’aide de la méthode d’installation que vous avez choisie.
Les modèles WinUI n'apparaissent pas dans Visual Studio. Ouvrez le programme d’installation de Visual Studio, sélectionnez Modifier, puis vérifiez que la charge de travail Développement d’applications WinUI est installée. Redémarrez Visual Studio ensuite.
La génération signale une erreur du SDK ou de restauration. Vérifiez les prérequis du workflow sélectionné ainsi que la première erreur dans la sortie de génération. Utilisez la prise en charge du SDK Windows App pour vérifier les exigences de version avant de modifier les propriétés du projet.
Le déploiement signale que le mode développeur est désactivé. Activez le mode développeur, puis réexécutez l’application.
Votre nouveau message n’apparaît pas. Enregistrez le fichier XAML et relancez le projet. Dans les modèles comportant un MainPage.xaml, ajoutez le message à la page concernée plutôt que de remplacer le cadre hôte de la fenêtre.

Étapes suivantes

Créer une application de notes

Le didacticiel Notes utilise un projet distinct WinUINotes pour enseigner les pages, la navigation, la liaison de données et le stockage local. Vous pouvez également trouver des exemples de contrôles spécifiques dans Ressources.

  • Last updated on