Definování aplikace a napsání první výzvy

Užitečná první výzva identifikuje technologii, chování aplikace, omezení a důkazy, které ukážou, že je práce dokončená. Tím se snižuje pravděpodobnost, že asistent zvolí známou, ale nesprávnou architekturu Windows.

Začít s kritérii přijetí

Než požádáte o kód, definujte, co očekáváte:

1. Projekt se sestaví pro platformu x64 bez chyb a upozornění.
2. Aplikace používá WinUI 3 a Microsoft.UI.Xaml, ne UWP a Windows.UI.Xaml.
3. Uživatel může přidat, dokončit a odstranit úkol.
4. Úkoly zůstanou po restartování aplikace.
5. Každý vstup a příkaz má přístupný název.
6. Příkazy zůstanou dostupné, když je okno úzké.
7. Pomocník vysvětluje všechny rozhraní API, které vyžaduje inicializaci identity balíčku nebo okna.

Tato kritéria převedou širokou žádost na kontroly, které můžete vy a asistent provádět.

Nastavte asistentovi trvalá omezení

Otevřete složku, ve které máte vývojové projekty, spusťte pomocníka pro psaní kódu AI a použijte tuto výzvu:

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.

Poslední část je důležitá. Požádá asistenta, aby zpřístupnil své předpoklady a vytvořil kontrolní body, které se snadněji kontrolují.

Kontrola navrhovaného plánu

Před schválením úprav zkontrolujte, jestli plán zahrnuje:

• Model pro jeden úkol.
• Model zobrazení s pozorovatelnou kolekcí a příkazy
• Služba úložiště.
• XAML pro stránku
• Malé množství kódu pro události specifické pro zobrazení v případě potřeby.
• Postup sestavení a spuštění zabalené aplikace WinUI.

Požádejte asistenta, aby upravil svůj plán, pokud navrhuje databázi, injektáž závislostí, více stránek nebo vlastní ovládací prvky. Tyto volby můžou být platné ve větší aplikaci, ale přidávají koncepty, které tato aplikace pro začátečníky nepotřebuje.

Vytvoření projektu

Pomocník by měl spouštět příkazy, které odpovídají:

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

Pokud používáte Visual Studio, můžete místo toho vytvořit zabalený projekt C# WinUI a přidat MVVM Toolkit. Ponechte název projektu TaskTally, aby se oblasti názvů v tomto kurzu shodovaly.

Note

Zabalená aplikace WinUI musí být nasazená s identitou balíčku. Použijte Visual Studio, dotnet run s podporovanými šablonami WinUI nebo nástroj příkazového řádku winapp. Nespouštějte vygenerovaný .exe přímo.

Kontrola vygenerovaného projektu

Požádat:

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.

Ověřte si vysvětlení sami:

• Soubor projektu obsahuje <UseWinUI>true</UseWinUI>.
• Projekt odkazuje na Microsoft.WindowsAppSDK.
• Kód XAML používá Microsoft.UI.Xaml typy v jazyce C#.
• Package.appxmanifest dodává identitu balíčku.
• Cílová architektura zahrnuje Windows, například net10.0-windows10.0.26100.0.

Před přidáním funkcí vytvořte nezměněnou šablonu. Pokud se základní verzi nepodaří sestavit, opravte problém s prostředím nebo s vytvořením projektu, než požádáte asistenta, aby vygeneroval další kód.

Přidání modelu, zobrazení modelu a trvalosti