Xamarin.Forms.NET 업그레이드 도우미를 사용하여 .NET MAUI 앱으로 앱 업그레이드

  • 아티클

.NET 업그레이드 도우미를 사용하면 솔루션의 프로젝트 파일을 변환하고 일반적인 코드 업데이트를 수행하여 프로젝트를 .NET 다중 플랫폼 앱 UI(.NET MAUI)로 업그레이드 Xamarin.Forms 할 수 있습니다. 특히 도구는 다음을 수행합니다.

  • Xamarin.Forms 클래스 라이브러리 프로젝트, Xamarin.iOS 프로젝트 및 Xamarin.Android 프로젝트를 SDK 스타일 프로젝트로 변환합니다.
  • 필요에 따라 프로젝트 파일의 대상 프레임워크를 net8.0-android 업데이트합니다 net8.0-ios.
  • 프로젝트 파일에서 설정합니다 <UseMaui>true</UseMaui> .
  • 추가 프로젝트 속성을 추가하고 필요하지 않은 프로젝트 속성을 제거합니다.
  • 특정 NuGet 패키지를 추가하고 제거합니다.
    • Xamarin.Forms 및 Xamarin.Essentials NuGet 패키지를 제거합니다.
    • Xamarin.CommunityToolkit NuGet 패키지를 NuGet 패키지로 .NET MAUI Community Toolkit 바꿉다.
    • NuGet 패키지의 SkiaSharp 호환되는 버전을 사용하는 경우 .NET MAUI 호환 버전으로 바꿉 Xamarin.Forms 니다.
  • 네임스페이스에 대한 참조를 Xamarin.Essentials 제거하고 네임스페이 Xamarin.Forms 스를 및 Microsoft.Maui.Controls 네임스페이 Microsoft.Maui 스로 바꿉니다.

도구를 실행한 후에는 마이그레이션을 완료하기 위해 추가 작업이 필요합니다.

참고 항목

.NET MAUI용 .NET 업그레이드 도우미는 UWP 프로젝트, iOS 확장 프로젝트 또는 바인딩 프로젝트 업그레이드를 지원하지 않습니다.

변환할 수 있는 다른 앱 유형을 포함하여 .NET 업그레이드 도우미에 대한 자세한 내용은 .NET 업그레이드 도우미 개요를 참조하세요.

시작하기

.NET 업그레이드 도우미는 Windows의 Visual Studio 확장 및 Windows 및 Mac용 CLI 도구로 사용할 수 있습니다. 이를 Xamarin.Forms 사용하려면 프로젝트에서 4.8 이상을 사용해야 Xamarin.Forms 합니다. 그러나 최상의 성공을 위해 프로젝트에서 5.0 및 .NET Standard 2.0 이상을 사용하는 Xamarin.Forms 것이 좋습니다Xamarin.Forms.

Important

.NET MAUI용 .NET 업그레이드 도우미는 아직 개발 중입니다. 이 도구를 계속 개선할 수 있도록 'area:Maui' 레이블로 피드백을 보내주세요.

.NET 업그레이드 도우미는 수행할 업그레이드 유형을 묻는 메시지를 표시합니다.

  • 현재 위치: 이 옵션은 복사본을 만들지 않고 프로젝트를 업그레이드합니다.
  • 나란히: 이 옵션은 프로젝트를 복사하고 복사본을 업그레이드하여 원래 프로젝트를 그대로 둡니다. 현재 .NET MAUI를 병렬로 업그레이드하려면 각 프로젝트 헤드를 업그레이드하는 새 프로젝트를 생성해야 합니다. 프로젝트 헤드를 기존 프로젝트로 업그레이드하려고 하면 오류가 발생할 수 있으며 현재 지원되는 환경이 아닙니다.

앱을 Xamarin.Forms .NET MAUI로 업그레이드하기 전에 먼저 5를 사용하도록 Xamarin.Forms 앱을 Xamarin.Forms 업데이트하고 여전히 올바르게 실행되도록 해야 합니다. 또한 앱에서 사용하는 종속성을 최신 버전으로 업데이트해야 합니다.

이렇게 하면 마이그레이션 프로세스의 나머지 부분을 간소화할 수 있습니다. 이는 .NET MAUI 간의 Xamarin.Forms API 차이를 최소화하고 종속성이 있는 경우 .NET 호환 버전의 종속성을 사용하게 되므로 도움이 됩니다.

Visual Studio의 빠른 작업

.NET 업그레이드 도우미에는 전구로 표시되는 적절한 .NET MAUI 네임스페이스로 네임스페이스를 변환 Xamarin.Forms 하는 빠른 작업이 있습니다.

Screenshot of previewing the application of a light bulb suggestion.

빠른 작업을 수행하면 파일 전체에서 필요한 대체 작업이 수행됩니다.

참고 항목

프로젝트에서 .NET MAUI 프로젝트로 파일을 Xamarin.Forms 마이그레이션할 때 빠른 작업 전구가 표시됩니다.

설치

업그레이드 도우미 실행하려면 Visual Studio 2022 버전 17.6.0 이상을 사용하는 것이 좋습니다. 업그레이드 도우미 확장을 설치하려면 다음을 수행합니다.

  1. Visual Studio를 열고 확장 > 관리 확장 메뉴 항목을 선택합니다.
  2. 확장 관리 대화 상자에서 .NET 업그레이드 도우미를 검색하고 다운로드합니다.
  3. 확장이 다운로드되면 Visual Studio를 닫습니다. 그러면 확장이 설치됩니다.

Visual Studio Marketplace에서 새 버전을 사용할 수 있으면 확장이 자동으로 업데이트됩니다. 자세한 내용은 자동 확장 업데이트를 참조 하세요.

업그레이드 도우미 실행

솔루션 탐색기 프로젝트를 마우스 오른쪽 단추로 클릭하고 업그레이드를 선택합니다.

다음 단계

수동 마이그레이션