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

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

그러나 UWP에서 Windows 앱 SDK 앱을 마이그레이션하기로 결정한 경우 대부분의 경우 UI 코드에는 몇 가지 네임스페이스 변경이 필요합니다. 대부분의 플랫폼 코드는 동일하게 유지될 수 있습니다. 데스크톱 앱과 UWP 앱 간의 차이로 인해 일부 코드를 조정해야 합니다. 그러나 대부분의 앱(물론 코드베이스 크기에 따라)의 경우 마이그레이션은 몇 주가 아닌 일 단위로 수행될 것으로 예상합니다. 대략적인 단계는 다음과 같습니다.

  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 플랫폼) 앱을 Windows 앱 SDK 및 WinUI 3으로 마이그레이션하는 데 도움이 되는 다음 단계로 C# UWP 앱 마이그레이션에 대한 지원을 추가하여 .NET 업그레이드 도우미를 활용했습니다. UWP 지원은 대부분의 마이그레이션 프로세스를 자동화합니다. 이제 미리 보기를 사용할 수 있습니다. 자세한 내용은 .NET 업그레이드 도우미를 사용하여 UWP 앱을 Windows 앱 SDK 마이그레이션을 참조하세요.

.NET 업그레이드 도우미의 UWP 지원에 대한 로드맵에는 추가 도구 개선 사항과 새 기능에 대한 마이그레이션 지원 추가가 포함됩니다.

업그레이드 도우미 GitHub 리포지토리는 팁 및 알려진 문제를 해결하는 문서를 설명합니다. 도구를 사용하는 동안 문제가 발견되면 동일한 GitHub 리포지토리에 보고하고 영역 태그UWP로 태그를 지정하세요.

이 섹션의 항목

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