MAUI 프로젝트 MSVS2022에서 MSVS2026 마이그레이션

우선 단순히 MSVS2022 MAUI 프로젝트를 MSVS 2026에서 열어 빌드를 하면 에러가 발생한다.

에러 내용은 Workload 문제인 것으로 보인다.

따라서 Visual Studio 버전이 바뀌면 MAUI 워크로드도 다시 설정해야 합니다.

 

1. SDK 설치 여부 확인

- '보기' - '터미널' 클릭 해서 '터미널' 창을 실행합니다.

- "dotnet --list-sdks" 명령어를 입력해서 설치된 버전을 확인 합니다.

 

2. MAUI 워크로드 (Workload) 설치 상태
 Visual Studio 버전이 바뀌면 MAUI 워크로드도 다시 설정해야 합니다.

• 워크로드 확인: 터미널에서 "dotnet workload list"를 입력하여 설치된 목록을 확인합니다.
• 워크로드 업데이트: "dotnet workload restore" 또는 "dotnet workload install maui" 명령어를 실행하여 필수 구성 요소를 설치하거나 복구하세요.

 설치가 완료 된 후에 다시 "dotnet --list-sdks" 명령어를 입력해서 설치된 버전을 확인 합니다.

 

3. NuGet 패키지 호환성 및 업데이트
구버전 MAUI에 맞춰진 라이브러리들이 최신 .NET 런타임과 호환되지 않을 수 있습니다.

• 패키지 업데이트: 솔루션 탐색기에서 'NuGet 패키지 관리'를 열고 Microsoft.Maui.Controls, Microsoft.Maui.Controls.Compatibility 등 주요 패키지를 최신 안정화(Stable) 버전으로 업데이트하세요.
• 서드파티 라이브러리: CommunityToolkit.Maui 같은 외부 라이브러리도 최신 버전으로 올려야 합니다.

4. 플랫폼별 설정 파일 (Android/iOS)
기반이 되는 플랫폼 SDK(Android SDK, Xcode)의 최소 요구 사양 변경으로 에러가 발생할 수 있습니다.

• AndroidManifest.xml: targetSdkVersion이 너무 낮지 않은지 확인하세요. 구글 정책이나 새 도구 버전에 맞춰 상향 조정이 필요할 수 있습니다.
• Info.plist: iOS의 경우, 최소 배포 타겟(MinimumOSVersion)을 확인하세요.

5. 사용 중단된(Obsolete) API 및 문법 변화
.NET 버전이 올라가면서 기존에 사용하던 MAUI 핸들러(Handler)나 렌더러(Renderer) 코드가 변경되었을 수 있습니다.

• 네임스페이스 변경: Microsoft.Maui.Essentials 등이 통합되거나 네임스페이스가 변경된 경우가 많으므로, 에러 로그에서 '찾을 수 없는 네임스페이스' 오류를 확인하세요.
• Global using: ImplicitUsings 설정 변화로 인해 명시적인 using 선언이 필요해졌을 수도 있습니다.