Définir l’application et rédiger le premier prompt

Une première instruction utile identifie la technologie, le comportement de l’application, les contraintes et les éléments permettant de vérifier que le travail est terminé. Cela réduit le risque que l’assistant choisit une infrastructure Windows familière mais incorrecte.

Commencer par les critères d’acceptation

Avant de demander du code, définissez ce que vous attendez à observer :

1. Le projet s’appuie sur x64 sans erreurs ni avertissements.
2. L’application utilise WinUI 3 et Microsoft.UI.Xaml, pas UWP et Windows.UI.Xaml.
3. Un utilisateur peut ajouter, terminer et supprimer une tâche.
4. Les tâches restent après le redémarrage de l’application.
5. Chaque entrée et commande a un nom accessible.
6. Les commandes restent disponibles lorsque la fenêtre est étroite.
7. L’Assistant explique toute API qui nécessite une identité de package ou une initialisation de fenêtre.

Ces critères transforment une demande étendue en vérifications que vous et l’assistant pouvez effectuer.

Donner à l’assistant des contraintes persistantes

Ouvrez le dossier où vous gardez vos projets de développement, démarrez votre assistant IA de programmation et utilisez cette instruction :

Create a C# WinUI 3 desktop app named TaskTally.

Technology constraints:
- Use WinUI 3 and the current stable Windows App SDK.
- Use Microsoft.UI.Xaml namespaces. Don't use UWP, Windows.UI.Xaml,
  WPF, Windows Forms, .NET MAUI, or third-party UI controls.
- Create a packaged app and build for x64.
- Start from the dotnet new winui-mvvm template.
- Use CommunityToolkit.Mvvm for observable properties and commands.

App requirements:
- Show a single-page task list.
- Let the user add, complete, and delete tasks.
- Save tasks as JSON in the app's local storage.
- Use ListView for the collection and InfoBar for save status.
- Include an empty state, keyboard access, accessible names, and a
  layout that works at narrow window widths.

Working agreement:
- First show your implementation plan and the files you will change.
- Make one small, buildable change at a time.
- Build after each change and fix errors before continuing.
- Explain which Learn documentation supports any Windows API choice.
- Don't suppress warnings or replace packaged deployment with an
  unpackaged workaround.

La dernière section est importante. Il demande à l’assistant d’exposer ses hypothèses et de produire des points de contrôle plus faciles à inspecter.

Inspecter le plan proposé

Avant d’approuver les modifications, vérifiez que le plan inclut :

• Modèle pour une tâche.
• Modèle d’affichage avec une collection et des commandes observables.
• Un service de stockage.
• XAML pour la page.
• Petite quantité de code-behind pour les événements spécifiques à l’affichage, si nécessaire.
• Étapes de génération et de lancement pour une application WinUI empaquetée.

Demandez à l’assistant de réviser son plan s’il propose une base de données, une injection de dépendances, plusieurs pages ou des contrôles personnalisés. Ces choix peuvent être valides dans une application plus grande, mais ils ajoutent des concepts dont cette application débutant n’a pas besoin.

Créer le projet

L’Assistant doit exécuter des commandes équivalentes à :

dotnet new winui-mvvm -n TaskTally
cd TaskTally
dotnet build -p:Platform=x64

Si vous utilisez Visual Studio, vous pouvez créer un projet WinUI C# empaqueté et ajouter le kit de ressources MVVM. Conservez le nom TaskTally du projet afin que les espaces de noms de ce didacticiel correspondent.

Note

Une application WinUI empaquetée doit être déployée avec son identité de package. Utilisez Visual Studio, dotnet run avec les modèles WinUI pris en charge ou l’interface winapp CLI. Ne lancez pas directement l’élément généré .exe.

Inspecter le projet généré

Demande :

Explain the purpose of App.xaml, MainWindow.xaml, MainPage.xaml,
Package.appxmanifest, and TaskTally.csproj. For each file, identify
the WinUI 3 or Windows App SDK setting that proves this isn't a UWP,
WPF, or MAUI project.

Vérifiez vous-même l’explication :

• Le fichier projet contient <UseWinUI>true</UseWinUI>.
• Le projet fait référence à Microsoft.WindowsAppSDK.
• Le code XAML utilise des Microsoft.UI.Xaml types en C#.
• Package.appxmanifest fournit l’identité du package.
• Le framework cible inclut Windows, comme net10.0-windows10.0.26100.0.

Générez le modèle inchangé avant d’ajouter des fonctionnalités. Si la version de base ne se compile pas, corrigez le problème d’environnement ou de création du projet avant de demander à l’assistant de générer davantage de code.

Ajouter le modèle, le modèle d’affichage et la persistance