빠른 시작: 환경 설정 및 WinUI 3 project 만들기

이 빠른 시작 가이드에서는 WinUI 및 Windows 앱 SDK 개발 환경을 설정하고 첫 번째 앱을 만드는 방법에 대해 설명합니다. Visual Studio 및 템플릿 WinUI 개발을 지원하는 방법에 대한 자세한 내용은 Visual Studio 개요를 참조하세요. WinUI 앱을 개발하려면 다음이 필요합니다.

• WinUI 및 Windows 앱 SDK 필요한 워크로드가 있는 Visual Studio 2026
• 디바이스에서 사용하도록 설정된 개발자 모드

개발 환경 설정

Windows 터미널 열고 PowerShell에서 다음 명령을 실행하여 WinGet 구성 파일 사용하여 환경을 자동으로 설정합니다. 이렇게 하면:

• 필요한 워크로드를 사용하여 Visual Studio 2026 설치
• 개발자 모드 사용

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

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

개발자 모드 사용

Windows 빌드하는 앱을 실행하고 테스트할 수 있도록 보안 설정을 조정하는 Developer Mode 포함되어 있습니다. Visual Studio 사용하여 앱을 빌드, 배포 및 테스트하기 전에 개발자 모드를 사용하도록 설정합니다.

개발자 모드를 사용하도록 설정하려면:

• Windows 설정을 열고 System > 고급 페이지로 이동합니다.
• 개발자 모드 스위치를 켜기로 전환하고 확인 대화 상자에서 선택 사항을 확인합니다.

Visual Studio 및 필요한 WinUI 및 Windows 앱 SDK 워크로드 설치

아래 링크를 사용하여 최신 Visual Studio 다운로드하여 설치합니다. 자세한 내용은 Visual Studio 설치를 참조하세요.

Visual Studio 다운로드

필수 워크로드 및 구성 요소

Visual Studio 설치 관리자의 Workloads 탭에서 다음 워크로드를 선택합니다. Visual Studio 이미 설치된 경우 설치 관리자를 열고 Modify를 선택하여 추가합니다.

• C# 앱 개발의 경우 Windows 앱 SDK 사용하여 WinUI 애플리케이션 개발 선택합니다.

WinUI 애플리케이션 개발 워크로드가 선택된 Visual Studio 설치 관리자 UI의 스크린샷

• C++ 앱 개발의 경우설치 세부 정보 창의 WinUI 애플리케이션 개발 노드에서 C++ WinUI 앱 개발 도구를 선택합니다(필요한 추가 구성 요소도 선택됨).

첫 번째 WinUI 앱 만들기 및 시작

1. Visual Studio 열고 새 프로젝트 만들기 선택합니다.

2. WinUI 검색하고, WinUI 빈 앱(패키지) C# project 템플릿을 선택하고, Next 선택합니다.

   블랭크, 패키지된 WinUI C# 데스크톱 앱

3. project 이름을 입력하고 Create 선택합니다.

   프로젝트 세부 정보 지정

4. 시작(F5)을 눌러 앱을 빌드하고 실행합니다.

   프로젝트를 빌드 및 실행합니다

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

   

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

다음 단계

Hello WinUI
첫 번째 WinUI 앱 빌드
더 멀리 갈 준비가 되셨나요? 단계별 자습서에 따라 전체 WinUI 앱을 빌드합니다.

WinUI 3 갤러리
WinUI 3 갤러리
WinUI 컨트롤, 기능 및 기능의 대화형 예제를 살펴봅니다.

샘플 아이콘
샘플 및 리소스
코드 샘플, 시작 프로젝트 및 도구를 찾아 개발을 가속화합니다.