앱 정의 및 첫 번째 프롬프트 작성

유용한 첫 번째 프롬프트는 기술, 앱 동작, 제약 조건 및 작업이 완료됨을 보여 주는 증거를 식별합니다. 이렇게 하면 길잡이가 친숙하지만 잘못된 Windows 프레임워크를 선택할 가능성이 줄어듭니다.

수락 기준부터 시작

코드를 요청하기 전에 관찰할 항목을 정의합니다.

  1. 프로젝트는 오류 또는 경고 없이 x64용으로 빌드됩니다.
  2. 앱은 UWP 및 Microsoft.UI.Xaml.가 아닌 WinUI 3을 Windows.UI.Xaml사용합니다.
  3. 사용자는 작업을 추가, 완료 및 삭제할 수 있습니다.
  4. 작업은 앱을 다시 시작한 후에도 유지됩니다.
  5. 모든 입력 및 명령에는 액세스 가능한 이름이 있습니다.
  6. 창이 좁을 때는 명령을 계속 사용할 수 있습니다.
  7. 도우미는 패키지 ID 또는 창 초기화가 필요한 API를 설명합니다.

이러한 기준은 광범위한 요청을 사용자와 도우미가 수행할 수 있는 검사로 바뀝니다.

어시스턴트에 지속되는 제약 조건을 부여하세요

개발 프로젝트를 유지하는 폴더를 열고, AI 코딩 도우미를 시작하고, 다음 프롬프트를 사용합니다.

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.

마지막 섹션이 중요합니다. 도우미에게 가정을 노출하고 검사하기 쉬운 검사점을 생성하도록 요청합니다.

제안된 계획 검사

편집을 승인하기 전에 계획에 다음이 포함되어 있는지 확인합니다.

  • 하나의 작업에 대한 모델입니다.
  • 관찰 가능한 컬렉션 및 명령이 있는 뷰 모델입니다.
  • 스토리지 서비스입니다.
  • 페이지의 XAML입니다.
  • 필요한 경우 뷰별 이벤트를 처리하기 위한 약간의 코드 비하인드.
  • 패키지된 WinUI 앱에 대한 빌드 및 시작 단계입니다.

도우미에게 데이터베이스, 종속성 주입, 여러 페이지 또는 사용자 지정 컨트롤을 제안하는 경우 계획을 수정하도록 요청합니다. 이러한 선택은 더 큰 앱에서 유효할 수 있지만 이 초보자 앱에는 필요하지 않은 개념을 추가합니다.

프로젝트를 만듭니다.

도우미는 다음과 같은 명령을 실행해야 합니다.

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

Visual Studio 사용하는 경우 패키지된 C# WinUI 프로젝트를 만들고 MVVM 도구 키트를 추가할 수 있습니다. 이 자습서의 네임스페이스가 일치하도록 프로젝트 이름을 TaskTally 유지합니다.

Note

패키지된 WinUI 앱은 패키지 ID를 사용하여 배포해야 합니다. 지원되는 WinUI 템플릿과 함께 winapp Visual Studio 또는 dotnet run CLI를 사용하세요. 생성된 .exe 직접 시작하지 마세요.

생성된 프로젝트 검사

물어:

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.

설명을 직접 확인합니다.

  • 프로젝트 파일에는 <UseWinUI>true</UseWinUI>이(가) 포함되어 있습니다.
  • 프로젝트가 Microsoft.WindowsAppSDK을 참조합니다.
  • XAML 코드는 C#의 형식을 사용합니다 Microsoft.UI.Xaml .
  • Package.appxmanifest 는 패키지 ID를 제공합니다.
  • 대상 프레임워크에는 다음과 같은 net10.0-windows10.0.26100.0Windows 포함됩니다.

기능을 추가하기 전에 변경되지 않은 템플릿을 빌드합니다. 기준 버전이 빌드되지 않으면 어시스턴트에게 추가 코드를 생성해 달라고 요청하기 전에 환경 또는 프로젝트 생성 문제를 해결하세요.