UWP에서 Windows 앱 SDK로 마이그레이션

UWP(유니버설 Windows 플랫폼)의 현재 기능에 만족하는 경우 프로젝트 형식을 마이그레이션할 필요가 없습니다. WinUI 2.x 및 Windows SDK는 UWP 프로젝트 형식을 지원합니다.

그러나 UWP에서 Windows 앱 SDK로 앱을 마이그레이션하기로 결정한 경우 대부분 UI 코드에서 몇 가지 네임스페이스만 변경하면 됩니다. 대부분의 플랫폼 코드는 동일하게 유지할 수 있습니다. UWP 앱과 데스크톱 앱의 차이로 인해 일부 코드를 조정해야 합니다. 하지만 대부분의 앱은 (당연히 코드베이스 크기에 따라) 마이그레이션에 몇 주가 아닌 며칠이 걸릴 것으로 예상됩니다.

대략적으로 이러한 단계는 수동으로 마이그레이션하는 단계입니다(이 .NET 업그레이드 도우미 도구사용에 대한 자세한 내용은 다음 섹션 참조).

1. 새 WinUI 3 패키지 데스크톱 프로젝트를 만듭니다( 첫 번째 WinUI 3 프로젝트 만들기 참조). 기존 솔루션으로 이동할 수 있습니다.
2. XAML/UI 코드를 복사합니다. 대부분의 경우 네임스페이스만 변경하면 됩니다(예: Windows.UI.*에서 Microsoft.UI.*로 변경).
3. 앱 논리 코드를 복사합니다. 일부 API는 팝업, 선택기 및 SecondaryTile과 같은 조정이 필요합니다.

자세한 내용은 아래 표의 항목을 참조하십시오. UWP(유니버설 Windows 플랫폼) 애플리케이션을 Windows 앱 SDK로 수동으로 마이그레이션하는 방법을 설명하고 보여 줍니다.

특히 UWP에서 WinUI 3로 마이그레이션할 때 지원되는 기능에 주의하십시오. 이 토픽에서는 WinUI 3 및 Windows 앱 SDK에서 아직 지원되지 않는 기능에 대해 설명합니다. 앱에 이러한 기능/라이브러리가 필요한 경우 마이그레이션을 기다리는 것이 좋습니다.

.NET 업그레이드 도우미 도구를 사용하여 마이그레이션

UWP 앱을 Windows 앱 SDK 및 WinUI 3으로 마이그레이션하는 데 도움이 되는 추가 단계로 C# UWP 앱 마이그레이션에 대한 지원을 추가하여 .NET 업그레이드 도우미를 활용했습니다. UWP 지원은 대부분의 마이그레이션 프로세스를 자동화합니다. 자세한 내용은 .NET 업그레이드 도우미를 사용하여 UWP에서 Windows 앱 SDK로 마이그레이션 항목을 참조하세요.

이 섹션의 토픽

토픽	설명
전체 마이그레이션 전략	마이그레이션 프로세스에 접근하기 위한 고려 사항 및 전략과 마이그레이션을 위한 개발 환경을 설정하는 방법을 설명합니다.
Windows 앱 SDK에 UWP 기능 매핑	이 항목에서는 UWP 및 Windows App SDK에 표시되는 다양한 형식의 주요 기능 영역을 비교합니다.
지원 내용	지금 UWP 앱 마이그레이션을 시도해야 하는지 여부를 평가하기 위해 현재 WinUI 3 데스크톱에서 사용할 수 있는 기능에 대해 알아봅니다.
UWP API 및 라이브러리를 Windows 앱 SDK에 매핑	이 항목에서는 UWP API 및 라이브러리를 해당 Windows App SDK에 매핑하는 방법을 제공합니다.
기능 영역 가이드	각각 특정 기능 영역에 초점을 맞춘 마이그레이션 참고 자료 항목의 컬렉션입니다.
사례 연구 1 - PhotoLab(C#)	이 항목은 C# UWP PhotoLab 샘플 앱을 가져와 Windows 앱 SDK로 마이그레이션하는 사례 연구입니다.
사례 연구 2 - Photo Editor(C++/WinRT)	이 항목은 C++/WinRT UWP Photo Editor 샘플 앱을 가져와 Windows 앱 SDK로 마이그레이션하는 사례 연구입니다.
추가 마이그레이션 지침	이 항목에는 기능 영역 지침에서 기능 영역으로 분류되지 않은 추가 마이그레이션 지침이 포함되어 있습니다.
.NET Upgrade Assistant를 사용하여 UWP에서 Windows App SDK로 마이그레이션	이 .NET 업그레이드 도우미 는 C# UWP 앱을 Windows 앱 SDK를 사용하는 WinUI(Windows UI 라이브러리) 3 앱으로 마이그레이션하는 데 도움이 될 수 있는 명령줄 도구입니다.