WinUI 시작하기

클래식 Windows Minesweeper와 함께 최신 WinUI 3 Minesweeper 앱이 Windows 앱 개발의 진화를 보여 줍니다.

WinUI 3은 Windows 데스크톱 앱을 빌드하기 위한 네이티브 UI 프레임워크입니다. Windows 운영 체제 자체와 별개이며 대상 컴퓨터에 설치하거나 앱과 함께 패키지해야 하는 API 및 도구 집합인 Windows 앱 SDK 일부입니다. WinUI 3은 C# 및 C++를 모두 지원하며 플랫폼 간 또는 웹 기반 프레임워크가 아닙니다.

Important

WinUI 3은 UWP와 다릅니다. WinUI 3은 Microsoft.UI.Xaml 네임스페이스를 사용하고 데스크톱 프로세스로 실행됩니다. UWP는 Windows.UI.Xaml를 사용하고 앱 컨테이너에서 실행됩니다. WinUI 3은 패키지된(MSIX) 배포, 외부 위치와 함께 패키지된 배포, 그리고 패키지되지 않은 배포를 지원합니다. 적절한 선택은 배포 시나리오에 따라 달라집니다. 자세한 내용은 배포 방법 선택을 참조하세요.

경로 선택

WinUI 3 프로젝트를 만들기 위해 지원되는 두 개의 경로가 있습니다.

	비주얼 스튜디오	명령줄
최적입니다	Windows 개발, 시각적 UI 디자이너 또는 전체 IDE 환경을 원하는 개발자	터미널, CI/CD 파이프라인 또는 스크립팅된 환경 설정에 익숙한 개발자
공구	Windows 앱 SDK 및 WinUI 워크로드가 설치된 Visual Studio 2026	`dotnet new` WinUI 템플릿이 포함된 .NET 10 SDK
Project 만들기	새 프로젝트 마법사: 빈 앱, 패키지됨(데스크톱의 WinUI 3) 템플릿 선택	`dotnet new winui -n MyApp`
빌드 및 실행	F5 키를 누르면 Visual Studio가 MSIX 패키지를 빌드하고 서명하고 배포한 다음 앱을 실행합니다	`dotnet run` - 패키지 ID를 사용하여 앱을 빌드하고 시작합니다(개발자 모드 필요).
Debugging	XAML 실시간 미리 보기가 포함된 모든 기능을 갖춘 Visual Studio 디버거	디버거를 수동으로 연결하거나 Visual Studio에서 생성된 `.sln`를 엽니다

두 경로 모두 동등한 WinUI 3 프로젝트를 생성합니다. Visual Studio 경로는 MSIX 서명 및 배포를 자동으로 처리합니다. 명령줄 경로는 로컬 개발에 사용됩니다 dotnet run (포함된 Microsoft.Windows.SDK.BuildTools.WinApp 패키지는 디버그 ID를 자동으로 처리함). 배포를 위해 패키징하려면 추가 단계가 필요합니다.