다음을 통해 공유

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

  • 아티클

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

참고 항목

기존 UWP 앱은 예상대로 계속 작동합니다. 그러나 WinUI 3의 최신 기능과 Windows 앱 SDK 활용하려면 앱을 마이그레이션하는 것이 좋습니다.

다음은 수동으로 마이그레이션하기 위한 높은 수준의 단계입니다. 그러나 .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 아직 지원되지 않는 기능을 설명합니다. 앱에 이러한 기능/라이브러리가 필요한 경우 마이그레이션을 연기하는 것이 좋습니다.

참고 항목

UWP 앱의 소스 코드가 C++/CX로 작성된 경우 C++/CX에서 C++/WinRT로 이동도 참조하세요.

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

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

컨테이너화 이점

Windows 앱 SDK 전환할 때 UWP 애플리케이션은 원래 플랫폼의 고유 컨테이너화 이점을 잃을 수 있습니다. 그러나 이러한 이점은 샌드박스 환경 내에서 애플리케이션을 격리하여 보호를 향상시키는 새로운 보안 기능인 Win32 앱 격리를 사용하여 복원할 수 있습니다. 이 방법은 기존 코드를 최소한으로 변경하여 잠재적 위협에 대한 추가 보안을 제공합니다. 자세한 내용을 확인하고 Win32 앱 격리 사용을 시작하려면 GitHub의 Win32 앱 격리 리포지토리 에 오신 것을 환영합니다.

이 섹션의 토픽

토픽 설명
전체 마이그레이션 전략 마이그레이션 프로세스에 접근하기 위한 고려 사항 및 전략과 마이그레이션을 위한 개발 환경을 설정하는 방법을 설명합니다.
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 업그레이드 도우미 는 Windows 앱 SDK를 사용해 C# UWP 앱을 WinUI 3 앱으로 마이그레이션하는 데 도움이 되는 명령줄 도구입니다.

참고 항목