빠른 시작: 첫 번째 WinUI 3 앱 만들기

첫 번째 WinUI 3 앱을 만들고, 빌드하고, 실행합니다. 비주얼 디자이너 지원을 통해 전체 IDE 환경을 위한 Visual Studio 선택하거나 편집기에서 명령줄에서 작업할 dotnet new를 선택합니다. 아래 탭을 사용하여 두 방법 간에 전환합니다.

Visual Studio
명령줄

개발 환경 설정

Visual Studio 사용하여 WinUI 3 앱을 개발하려면 필요한 워크로드 및 개발자 모드를 사용하도록 설정된 Visual Studio 2026이 필요합니다.

WinGet을 사용하여 설정(권장)

Windows 터미널 열고 PowerShell에서 다음 명령을 실행하여 필요한 워크로드로 Visual Studio 2026을 자동으로 설치하고 WinGet 구성 파일을 사용하여 개발자 모드를 사용하도록 설정합니다.

winget configure -f https://aka.ms/winui-config

구성 파일을 검토하고 자세히 알아보려면 GitHub README 참조하세요.

메모

사용자 환경에서 WinGet을 사용할 수 없는 경우 먼저 설치합니다.

Install-Module -Name Microsoft.WinGet.Client -Force
Repair-WinGetPackageManager -AllUsers

자세한 내용은 WinGet 사용을 참조하세요.

수동으로 설정

도구를 수동으로 설치하려는 경우:

개발자 모드 사용: Windows 설정을 열고, System > Advanced로 이동하고, 개발자 모드를 켜기로 전환합니다.
2026년 Visual Studio 다운로드하여 설치합니다. 자세한 내용은 Visual Studio 설치를 참조하십시오.
Visual Studio 설치 관리자의 [워크로드] 탭에서 WinUI 애플리케이션 개발 워크로드를 선택합니다. C++ 개발의 경우 설치 세부 정보 창에서 해당 워크로드에서 C++ WinUI 앱 개발 도구도 선택합니다.

팁 (조언)

Visual Studio 설치한 후 WinUI 템플릿이 표시되지 않으면 Visual Studio 설치 관리자를 열고 Modify를 선택하고 WinUI 애플리케이션 개발 워크로드가 선택되어 있는지 확인합니다. 설치를 수정한 후 Visual Studio 다시 시작합니다.

첫 번째 WinUI 3 앱 만들기 및 시작

Visual Studio 2026을 열고 새 프로젝트 만들기를 선택합니다.
WinUI를 검색하고, WinUI 빈 앱(패키지된) C# 프로젝트 템플릿을 선택하고, 다음을 선택합니다.
프로젝트 이름을 입력하고 만들기를 선택합니다.
시작(F5)을 눌러 앱을 빌드하고 실행합니다.

앱은 디버그 모드에서 빌드, 배포 및 시작합니다.

첫 번째 WinUI 3 앱을 빌드하고 시작했습니다! 🎉

사전 요구 사항

Windows 10 버전 1809(빌드 17763) 이상
개발자 모드 사용(ms-settings:developers)
.NET 10 SDK 이상(dotnet --version로 확인)

첫 번째 WinUI 3 앱 만들기 및 실행

WinUI 3 프로젝트 템플릿을 dotnet new 설치합니다(한 번 실행).
```
dotnet new install Microsoft.WindowsAppSDK.WinUI.CSharp.Templates
```
새 프로젝트를 만들고 해당 프로젝트로 이동합니다.
```
dotnet new winui -n MyWinUIApp
cd MyWinUIApp
```
프로젝트를 빌드합니다.
```
dotnet build
```
앱을 실행합니다.
```
dotnet run
```
템플릿에는 디버그 ID를 등록하고 MSIX 패키지 ID를 사용하여 앱을 시작하기 위해 .NET CLI Microsoft.Windows.SDK.BuildTools.WinApp 대상에 연결하는 템플릿이 포함되어 run있습니다. 수동 배포 단계는 필요하지 않습니다.

빈 앱 창이 열립니다. 첫 번째 WinUI 3 앱을 빌드하고 시작했습니다! 🎉