WinUI 3 - Project Reunion 0.5 안정화 버전 출시

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의 일부로 제공됩니다. 설치하려면 다음을 참조하십시오.

 

Installation instructions for 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 도구를 사용하도록 설정해야 합니다.

개발 환경을 설정한 후에는 Visual Studio의 WinUI 3 프로젝트 템플릿을 참조하여 사용 가능한 Visual Studio 프로젝트 및 항목 템플릿을 숙지하십시오.

 

WinUI 3 앱 구축을 시작하는 방법에 대한 자세한 내용은 다음 문서를 참조하십시오.

• Get started with WinUI 3 for desktop apps
• Build a basic WinUI 3 app for desktop

한계와 알려진 문제 외에도 WinUI 프로젝트를 이용해 앱을 구축하는 것은 XAML과 WinUI 2.x로 UWP 앱을 구축하는 것과 비슷합니다. 따라서 Windows SDK의 UWP 앱 및 Windows.UI WinRT 네임스페이스에 대한 지침 설명서가 대부분 적용됩니다.

 

WinUI 3 API 참조 설명서는 여기에서 확인할 수 있습니다. WinUI 3 API 참조

WebView2

이 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의 기본 프로젝트 템플릿은 다음 줄이 포함되었습니다. 코드에 여전히 있으면 이 줄을 제거하십시오.
  • C#: this.Suspending += OnSuspending;
  • C++: Suspending({ this, &App::OnSuspending });

이제 프로젝트를 변경하십시오.

• Visual Studio에서 Tools -> NuGet Package Manager -> Package Manager Console로 이동하십시오.
• uninstall-package Microsoft.WinUI -Projectname {yourproject}와 엔터를 입력합니다.
• install-package Microsoft.ProjectReunion -version 0.5.0 -projectname {yourprojectname}와 엔터를 입력합니다.
• 응용 프로그램 (패키지)에서 다음과 같이 변경하십시오. Wapproj :
• 이 섹션을 추가하십시오.

<ItemGroup>
  <PackageReference Include="Microsoft.ProjectReunion" Version="[0.5.0]">
    <IncludeAssets>build</IncludeAssets>
  </PackageReference>
</ItemGroup>

• 그런 다음 다음 줄을 제거하십시오.

<AppxTargetsLocation Condition="'$(AppxTargetsLocation)'==''">$(MSBuildThisFileDirectory)build\</AppxTargetsLocation>

and

<Import Project="$(Microsoft_ProjectReunion_AppXReference_props)" />
<Import Project="$(Microsoft_WinUI_AppX_targets)" />

and this item group:

<ItemGroup>
    <PackageReference Include="Microsoft.ProjectReunion" Version="[0.5.0-prerelease]" GeneratePathProperty="true">
      <ExcludeAssets>all</ExcludeAssets>
    </PackageReference>
    <PackageReference Include="Microsoft.ProjectReunion.WinUI" Version="[0.5.0-prerelease]" GeneratePathProperty="true">
      <ExcludeAssets>all</ExcludeAssets>
    </PackageReference>
  </ItemGroup>

Major changes introduced in this release

Stable features

이 릴리스는 WinUI 3를 Microsoft Store로 보낼 수 있는 프로덕션 앱에 적합하게 만들 수 있는 안정성과 지원을 제공합니다. 여기에는 과거 미리 보기에 도입된 대부분의 기능에 대한 지원 및 전달 호환성이 포함됩니다.

• Ability to create desktop apps with WinUI, including .NET 5 for Win32 apps
• RadialGradientBrush
• TabView updates
• Dark theme updates
• Improvements and updates to WebView2
  • Support for High DPI
  • Support for window resizing and moving
  • Updated to target more recent version of Edge
  • No longer necessary to reference a WebView2-specific Nuget package
• SwapChainPanel
• MRT Core Support
  • This makes apps faster and lighter on startup and provides quicker resource lookup.
• ARM64 Support
• Drag and drop inside and outside of apps
• RenderTargetBitmap (currently only XAML content - no SwapChainPanel content)
• Custom cursor support
• Off-thread input
• Improvements to our tooling/developer experience:
  • Live Visual Tree, Hot Reload, Live Property Explorer and similar tools
  • Intellisense for WinUI 3
• Improvements required for open source migration
• Custom titlebar capabilities: new Window.ExtendsContentIntoTitleBar and Window.SetTitleBar APIs that allow developers to create custom title bars in desktop apps.
• VirtualSurfaceImageSource support
• In-app acrylic

Preview features

안정적인 릴리스이기 때문에 이 버전의 WinUI 3에서는 미리 보기 기능이 제거되었습니다. 현재 WinUI 3 미리보기 버전을 사용하여 테스트 기능에 액세스할 수 있습니다. 다음 주요 기능은 여전히 미리보기 중이며 이러한 기능을 안정화시키기 위한 작업은 계속 진행 중입니다.

• UWP support
  • This means you cannot build or run a UWP app using the WinUI 3 - Project Reunion 0.5 VSIX. You'll need to use the WinUI 3 - Project Reunion 0.5 Preview VSIX, and follow the rest of the instructions for setting up your development environment in Get started with Project Reunion. See Windows UI Library 3 - Project Reunion 0.5 Preview (March 2021) release notes for more information.
• Multi-window support in desktop apps
• Input validation

Provide feedback and suggestions

WinUI Github Repo에서 당신의 의견을 환영합니다.

What's coming next?

특정 기능이 계획되는 경우에 대한 자세한 내용은 GitHub의 기능 로드맵을 참조하십시오.

Limitations and known issues

다음 항목은 WinUI 3 - Project Reunion 0.5의 알려진 문제점입니다. 아래에 나열되지 않은 문제를 발견하면 기존 문제에 기여하거나 Winui Github Repo를 통해 새로운 문제를 제출함으로써 알려주십시오.

Platform and OS support

WinUI 3 - Project Reunion 0.5는 Windows 10 10월 10일 업데이트(버전 1809 - Build 17763)와 새로운 것을 실행하는 PC와 호환됩니다.

 

WinUI 3 Project Reunion 0.5 (March 2021) - WinUI | Microsoft Docs

WinUI 3 Project Reunion 0.5 (March 2021) - WinUI