De app definiëren en de eerste prompt schrijven

Een nuttige eerste prompt identificeert de technologie, het gedrag, de beperkingen van de app en het bewijs dat aangeeft dat het werk is voltooid. Dit vermindert de kans dat de assistent een vertrouwd maar onjuist Windows framework kiest.

Beginnen met acceptatiecriteria

Voordat u om code vraagt, definieert u wat u verwacht te observeren:

  1. Het project bouwt voor x64 zonder fouten of waarschuwingen.
  2. De app maakt gebruik van WinUI 3 en Microsoft.UI.Xamlniet uwp en Windows.UI.Xaml.
  3. Een gebruiker kan een taak toevoegen, voltooien en verwijderen.
  4. Taken blijven behouden nadat de app opnieuw is opgestart.
  5. Elke invoer en opdracht hebben een toegankelijke naam.
  6. Opdrachten blijven beschikbaar wanneer het venster smal is.
  7. In de assistent wordt uitgelegd welke API pakketidentiteit of venster-initialisatie vereist.

Met deze criteria wordt een brede aanvraag omgezet in controles die u en de assistent kunnen uitvoeren.

Geef de assistent blijvende beperkingen

Open de map waarin u ontwikkelingsprojecten bewaart, start uw AI-coderingsassistent en gebruik deze prompt:

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.

De laatste sectie is belangrijk. De assistent wordt gevraagd zijn veronderstellingen beschikbaar te maken en controlepunten te produceren die gemakkelijker te inspecteren zijn.

Het voorgestelde plan inspecteren

Controleer voordat u wijzigingen goedkeurt of het plan het volgende bevat:

  • Een model voor één taak.
  • Een weergavemodel met een waarneembare verzameling en opdrachten.
  • Een opslagservice.
  • XAML voor de pagina.
  • Een kleine hoeveelheid code achter voor weergavespecifieke gebeurtenissen, indien nodig.
  • Stappen voor het bouwen en starten van een verpakte WinUI-app.

Vraag de assistent om het plan te herzien als het een database, afhankelijkheidsinjectie, meerdere pagina's of aangepaste besturingselementen voorstelt. Deze opties kunnen geldig zijn in een grotere app, maar ze voegen concepten toe die deze beginners-app niet nodig heeft.

Het project maken

De assistent moet opdrachten uitvoeren die gelijk zijn aan:

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

Als u Visual Studio gebruikt, kunt u in plaats daarvan een verpakt C# WinUI-project maken en de MVVM Toolkit toevoegen. Behoud de projectnaam TaskTally zodat de naamruimten in deze zelfstudie overeenkomen.

Note

Een verpakte WinUI-app moet worden geïmplementeerd met de bijbehorende pakketidentiteit. Gebruik Visual Studio, dotnet run met de ondersteunde WinUI-sjablonen of de winapp CLI. Start de gegenereerde .exe niet rechtstreeks.

Het gegenereerde project controleren

Stel:

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.

Controleer de uitleg zelf:

  • Het projectbestand bevat <UseWinUI>true</UseWinUI>.
  • Het project verwijst naar Microsoft.WindowsAppSDK.
  • XAML-code maakt gebruik van Microsoft.UI.Xaml typen in C#.
  • Package.appxmanifest levert pakketidentiteit.
  • Het doelframework bevat Windows, zoals net10.0-windows10.0.26100.0.

Bouw de ongewijzigde sjabloon voordat u functies toevoegt. Als de basis niet compileert, los dan het probleem met de omgeving of het aanmaken van het project op voordat u de assistent vraagt meer code te genereren.

Het model toevoegen, model weergeven en persistentie toevoegen

  • Last updated on