Definieren der App und Schreiben der ersten Eingabeaufforderung

Eine nützliche erste Eingabeaufforderung identifiziert die Technologie, das App-Verhalten, Einschränkungen und die Beweise, die zeigen, dass die Arbeit abgeschlossen ist. Dies reduziert die Chance, dass der Assistent ein vertrautes, aber falsches Windows Framework auswähnt.

Beginnen Mit Akzeptanzkriterien

Bevor Sie nach Code fragen, definieren Sie, was Sie beachten möchten:

  1. Das Projekt lässt sich für x64 ohne Fehler oder Warnungen erstellen.
  2. Die App verwendet WinUI 3 und Microsoft.UI.Xamlnicht UWP und Windows.UI.Xaml.
  3. Ein Benutzer kann eine Aufgabe hinzufügen, abschließen und löschen.
  4. Aufgaben verbleiben nach dem Neustart der App.
  5. Jede Eingabe und jeder Befehl hat einen barrierefreien Namen.
  6. Befehle bleiben verfügbar, wenn das Fenster schmal ist.
  7. Der Assistent erläutert jede API, die paketidentitäts- oder Fensterinitialisierung erfordert.

Mit diesen Kriterien wird eine umfassende Anforderung in Prüfungen umgewandelt, die Sie und der Assistent ausführen kann.

Dem Assistenten dauerhafte Einschränkungen geben

Öffnen Sie den Ordner, in dem Sie Entwicklungsprojekte beibehalten, ihren KI-Codierungs-Assistenten starten und diese Eingabeaufforderung verwenden:

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.

Der letzte Abschnitt ist wichtig. Er fordert den Assistenten auf, seine Annahmen offenzulegen und Prüfpunkte zu erzeugen, die leichter zu prüfen sind.

Prüfen des vorgeschlagenen Plans

Bevor Sie Bearbeitungen genehmigen, überprüfen Sie, ob der Plan Folgendes umfasst:

  • Ein Modell für eine Aufgabe.
  • Ein Ansichtsmodell mit einer feststellbaren Auflistung und Befehlen.
  • Ein Speicherdienst.
  • XAML für die Seite.
  • Eine kleine Menge an Code-Behind für ansichtsspezifische Ereignisse, falls erforderlich.
  • Erstellungs- und Startschritte für eine verpackte WinUI-App.

Bitten Sie den Assistenten, seinen Plan zu überarbeiten, wenn er eine Datenbank, Abhängigkeitseinfügung, mehrere Seiten oder benutzerdefinierte Steuerelemente vorschlägt. Diese Optionen können in einer größeren App gültig sein, aber sie fügen Konzepte hinzu, die diese Anfänger-App nicht benötigt.

Erstelle das Projekt

Der Assistent sollte Befehle ausführen, die folgendem entsprechen:

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

Wenn Sie Visual Studio verwenden, können Sie stattdessen ein verpacktes C#-WinUI-Projekt erstellen und das MVVM-Toolkit hinzufügen. Behalten Sie den Projektnamen TaskTally bei, damit die Namespaces in diesem Lernprogramm übereinstimmen.

Note

Eine verpackte WinUI-App muss mit seiner Paketidentität bereitgestellt werden. Verwenden Sie Visual Studio, dotnet run mit den unterstützten WinUI-Vorlagen, oder die winapp CLI. Starten Sie die generierte .exe Datei nicht direkt.

Überprüfen des generierten Projekts

Fragen:

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.

Überprüfen Sie die Erklärung selbst:

  • Die Projektdatei enthält <UseWinUI>true</UseWinUI>.
  • Das Projekt verweist auf Microsoft.WindowsAppSDK.
  • XAML-Code verwendet Microsoft.UI.Xaml Typen in C#.
  • Package.appxmanifest liefert paketidentität.
  • Das Zielframework umfasst Windows, wie etwa net10.0-windows10.0.26100.0.

Erstellen Sie die unveränderte Vorlage, bevor Sie Features hinzufügen. Wenn sich die Baseline nicht erstellen lässt, beheben Sie das Umgebungs- oder Projekterstellungsproblem, bevor Sie den Assistenten auffordern, mehr Code zu generieren.

Hinzufügen des Modells, des Ansichtsmodells und der Persistenz

  • Last updated on