Windows UI Library(WinUI) 3은 최신 Windows 앱을 구축하기 위한 기본 사용자 환경(UX) 프레임워크입니다. 이 제품은 Project Reunion의 일부로 Windows 운영 체제와 독립적으로 제공됩니다. Project Reunion 0.5 릴리스에서는 WinUI 3 기반 사용자 인터페이스를 사용하여 앱 구축을 시작하는 데 도움이 되는 Visual Studio 프로젝트 템플릿을 제공합니다.
WinUI 3 - Project Reunion 0.5는 Microsoft Store에 게시가 가능한 프로덕션 앱을 만드는데 사용할 수 있는 안정적인 첫번째 버전입니다. 이 릴리스는 안정성 업데이트와 WinUI 3이 향후 호환성과 프로덕션 준비를 할 수 있도록 하는 일반적인 개선 사항으로 구성되어 있습니다.
Install WinUI 3 - Project Reunion 0.5
이 새로운 버전의 WinUI 3는 Project Reunion 0.5의 일부로 제공됩니다. 설치하려면 다음을 참조하십시오.
현재 WinUI는 Project Reunion의 일부로 제공되며 개발자 도구 및 구성 요소 세트가 포함된 VSIX(Project Reunion Visual Studio Extension)를 다운로드하여 시작합니다. Project Reunion 패키지에 대한 자세한 내용은 Project Reunion을 사용하는 앱 배포를 참조하십시오. Project Reunion VSIX에는 WinUI 3 앱을 구축하는데 사용할 WinUI 프로젝트 템플릿이 포함되어 있습니다.
작동 중인 WinUI 3 컨트롤 및 기능을 보려면 GitHub에서 XAML 컨트롤 갤러리의 WinUI 3 버전을 복제하고 빌드할 수 있습니다.
Live Visual Tree, Hot Reload 및 Live Property Explorer와 같은 WinUI 3 도구를 사용하려면 다음 지침에 설명된 대로 Visual Studio Preview Features를 사용하여 WinUI 3 도구를 사용하도록 설정해야 합니다.
한계와 알려진 문제 외에도 WinUI 프로젝트를 이용해 앱을 구축하는 것은 XAML과 WinUI 2.x로 UWP 앱을 구축하는 것과 비슷합니다. 따라서 Windows SDK의 UWP 앱 및 Windows.UI WinRT 네임스페이스에 대한 지침 설명서가 대부분 적용됩니다.
이 WinUI 3 릴리스에서 WebView2를 사용하려면, WebView2 런타임이 설치되어 있지 않은 경우 이 페이지에 있는 Evergen Bootstrapper 또는 Evergen Standalone Installer를 다운로드하십시오.
Windows Community Toolkit
Windows Community Toolkit을 사용하는 경우 최신 버전을 다운로드합니다.
Visual Studio Support
Hot Reload, Live Visual Tree 및 Live Property Explorer와 같이 WinUI 3에 추가된 최신 툴링 기능을 사용하려면 Visual Studio의 최신 프리뷰 버전을 사용하고 Visual Studio Preview Features(Visual Studio 미리 보기 기능)에서 WinUI 툴링을 활성화해야 합니다. 아래 표는 WinUI 3 - Project Reunion 0.5와 Visual Studio 2019 버전의 호환성을 보여줍니다.
VS VersionWinUI 3 - Project Reunion 0.5
VS Version
WinUI 3 - Project Reunion 0.5
16.8
No
16.9
Yes, but with no Hot Reload, Live Visual Tree, or Live Property Explorer
16.10 Previews
Yes, with all WinUI 3 tooling
Updating your existing WinUI 3 app
미리보기 버전의 WinUI 3를 사용하던 앱을 업데이트하여 새 버전의 WinUI 3을 사용할 수 있습니다. 앱 유형에 따라 아래 지침을 참조하십시오.
이러한 지침은 각 앱의 개별 시나리오의 고유성 때문에 문제가 있을 수 있습니다. 주의해서 따라오시고 문제가 발견되면 GitHub repo에 버그를 달아주세요.
Updating a WinUI 3 Preview 4 app to use WinUI 3 - Project Reunion 0.5
시작하기 전에 Project Reunion VSIX 및 NuGet 패키지를 포함하여 WinUI 3 - Project Reunion 0.5 필수 구성 요소가 모두 설치되어 있는지 확인하십시오. 설치 지침은 여기를 참조하십시오.
먼저 다음 단계를 수행하십시오.
.wapproj 파일에서 TargetPlatFormMinVersion이 10.0.17763.0보다 오래된 경우 10.0.17763.0으로 변경하십시오.
앱에서 Application.Suspending 이벤트를 사용하는 경우 Application.Suspending은 더 이상 데스크톱 응용 프로그램을 더 이상 호출하지 않으므로 해당 줄을 제거하거나 변경해야합니다. 자세한 정보는 API 참조 설명서를 참조하십시오.
C++ 및 C# Apps의 기본 프로젝트 템플릿은 다음 줄이 포함되었습니다. 코드에 여전히 있으면 이 줄을 제거하십시오.
안정적인 릴리스이기 때문에 이 버전의 WinUI 3에서는 미리 보기 기능이 제거되었습니다. 현재 WinUI 3 미리보기 버전을 사용하여 테스트 기능에 액세스할 수 있습니다. 다음 주요 기능은 여전히 미리보기 중이며 이러한 기능을 안정화시키기 위한 작업은 계속 진행 중입니다.