다음을 통해 공유

Visual Studio의 WinUI 3 템플릿

개발 컴퓨터를 설정했으면( Windows 앱 개발 시작 참조) Visual Studio의 프로젝트 템플릿 중 하나에서 시작하여 WinUI 3 앱을 만들 준비가 되었습니다. 이 항목에서는 사용 가능한 프로젝트 및 항목 템플릿에 대해 설명합니다.

WinUI 3 프로젝트 템플릿에 액세스하려면 새 프로젝트 대화 상자의 드롭다운 필터에서 프로젝트 유형 드롭다운에서 WinUI 를 선택합니다. 또는 WinUI를 검색하고 사용 가능한 C# 또는 C++ 템플릿 중 하나를 선택할 수 있습니다.

WinUI 프로젝트 템플릿

WinUI 3용 프로젝트 템플릿

이러한 WinUI 3 프로젝트 템플릿을 사용하여 앱 만들기를 시작할 수 있습니다.

WinUI 빈 앱(패키지화된)

이 프로젝트 템플릿은 WinUI 3 기반 사용자 인터페이스를 사용하여 데스크톱 .NET(C#) 또는 네이티브 Win32(C++) 앱을 만듭니다. 생성된 프로젝트에는 UI 빌드를 시작하는 데 사용할 수 있는 WinUI 3 라이브러리의 Microsoft.UI.Xaml.Window 클래스에서 파생되는 기본 창이 포함되어 있습니다. 이 프로젝트 템플릿 사용에 대한 자세한 내용은 Windows 앱 개발 시작을 참조하세요.

WinUI 빈 앱(Windows 애플리케이션 패키징 프로젝트로 패키지됨)

이 프로젝트 템플릿은 WinUI 3 기반 사용자 인터페이스를 사용하여 데스크톱 .NET(C#) 또는 네이티브 Win32(C++) 앱을 만듭니다. 생성된 프로젝트에는 UI 빌드를 시작하는 데 사용할 수 있는 WinUI 3 라이브러리의 Microsoft.UI.Xaml.Window 클래스에서 파생되는 기본 창이 포함되어 있습니다.

이 솔루션에는 MSIX 패키지로 앱을 빌드하도록 구성된 별도의 Windows 애플리케이션 패키징 프로젝트도 포함되어 있습니다. 필요에 따라 Visual Studio용 단일 프로젝트 MSIX 패키징 도구 확장을 설치하고 패키징 프로젝트 설정을 애플리케이션 프로젝트에 결합하여 더 이상 별도의 패키징 프로젝트를 유지 관리할 필요가 없습니다.

다른 구성 요소에 대한 WinUI 프로젝트 템플릿

이러한 WinUI 3 프로젝트 템플릿을 사용하여 WinUI 3 기반 앱에서 로드하고 사용할 수 있는 구성 요소를 빌드할 수 있습니다.

Template Language Description
WinUI 클래스 라이브러리 C# 전용 WinUI 3 기반 사용자 인터페이스를 사용하여 다른 .NET 데스크톱 앱에서 사용할 수 있는 C#에서 .NET 관리 클래스 라이브러리(DLL)를 만듭니다.
Windows 런타임 구성 요소(WinUI 3) C++ 전용 앱이 작성된 프로그래밍 언어에 관계없이 WinUI 3 기반 사용자 인터페이스를 사용하여 UWP 또는 데스크톱 앱에서 사용할 수 있는 C++/WinRT로 작성된 Windows 런타임 구성 요소를 만듭니다.
WinUI 단위 테스트 앱 C#/C++ MSTest를 사용하여 앱에 대한 자동화된 테스트를 작성하고 실행하는 데 도움이 되는 단위 테스트 프로젝트를 만듭니다.

WinUI 3용 항목 템플릿

WinUI 3 프로젝트에서 사용할 수 있는 항목 템플릿은 다음과 같습니다. 이러한 WinUI 3 항목 템플릿에 액세스하려면 솔루션 탐색기에서 프로젝트 노드를 마우스 오른쪽 단추로 클릭하고 새>추가를 선택한 다음 새 항목 추가 대화 상자에서 WinUI를 클릭합니다.

WinUI 항목 템플릿

Template Language Description
빈 페이지 C# 및 C++ Microsoft.UI.Xaml.Controls.Page 클래스에서 파생된 새 페이지를 정의하는 XAML 파일 및 코드 파일을 추가합니다.
빈 창 C# 및 C++ Microsoft.UI.Xaml.Window 클래스에서 파생된 새 창을 정의하는 XAML 파일 및 코드 파일을 추가합니다.
리소스 사전 C# 및 C++ XAML 리소스의 키가 지정된 빈 컬렉션을 추가합니다. 자세한 내용은 ResourceDictionary 및 XAML 리소스 참조를 참조하세요.
리소스 파일(.resw) C# 및 C++ 앱에 대한 문자열 및 조건부 리소스를 저장하기 위한 파일을 추가합니다. 이 항목을 사용하여 앱을 지역화할 수 있습니다. 자세한 내용은 UI 및 앱 패키지 매니페스트에서 문자열 지역화를 참조하세요.
템플릿화된 컨트롤 C# 및 C++ 기본 스타일을 사용하여 템플릿 컨트롤을 만들기 위한 코드 파일을 추가합니다. 템플릿 컨트롤은 Microsoft.UI.Xaml.Controls.Control 클래스에서 파생됩니다.

이 항목 템플릿을 사용하는 방법을 보여주는 연습은 C++/WinRT를 사용하는 UWP 및 WinUI 3 앱을 위한 템플릿 XAML 컨트롤과 C#을 사용하는 UWP 및 WinUI 3 앱을 위한 템플릿 XAML 컨트롤을 참조하세요. 템플릿 컨트롤에 대한 자세한 내용은 사용자 지정 XAML 컨트롤을 참조하세요.
사용자 제어 C# 및 C++ Microsoft.UI.Xaml.Controls.UserControl 클래스에서 파생되는 사용자 컨트롤을 만들기 위한 XAML 파일 및 코드 파일을 추가합니다. 일반적으로 사용자 컨트롤은 관련된 기존 컨트롤을 캡슐화하고 자체 논리를 제공합니다.

사용자 정의 컨트롤에 대한 자세한 내용은 사용자 지정 XAML 컨트롤을 참조하세요.

참고하십시오

  • Last updated on