기술문서

 > 

C#, .NET, Visual Studio

기존 .NET 데스크톱 개발 앱을 WinUI 애플리케이션으로 마이그레이션에 대한 고려사항

.NET Framework 4.6.1 기반의 데스크톱 애플리케이션(WinForms 또는 WPF)을 WinUI로 마이그레이션하는 것은 가능합니다, 하지만 이는 상당한 노력이 필요한 작업이 될 수 있습니다.

마이그레이션의 종류와 접근 방식

.NET Framework에서 최신 WinUI로의 마이그레이션은 일반적으로 다음과 같은 단계를 포함하며, 그 복잡성은 애플리케이션의 규모와 아키텍처에 따라 달라집니다.

1. .NET Framework -> .NET으로 업그레이드 (필수 선행 조건)

   • WinUI 애플리케이션은 .NET (구 .NET Core) 기반으로 구축됩니다. .NET Framework 4.6.1은 이제 지원 종료되었으며, WinUI와 직접 호환되지 않습니다.

   • 따라서 첫 번째 단계는 프로젝트를 .NET 6, .NET 7, .NET 8과 같은 최신 .NET 버전으로 마이그레이션하는 것입니다.

   • .NET Upgrade Assistant 도구를 사용하는 것이 이 과정을 자동화하는 데 큰 도움이 됩니다. 이 도구는 csproj 파일 형식 업데이트, NuGet 패키지 참조 정리, 일부 코드 변경 등을 수행합니다.

2. UI 프레임워크 전환 (WinForms/WPF -> WinUI)

   • 이것이 가장 큰 변화이자 가장 많은 수작업이 필요한 부분입니다. WinForms는 GDI+ 기반의 UI 프레임워크이고, WPF는 XAML 기반이지만 WinUI와는 다른 XAML 다이얼렉트를 사용합니다.

   • 완전한 UI 재작성: 대부분의 경우, WinForms/WPF의 UI는 WinUI의 XAML 기반으로 거의 새로 작성해야 합니다. 컨트롤의 이름, 속성, 이벤트 모델 등이 다릅니다. 이는 상당한 시간과 노력을 필요로 합니다.

   • 비즈니스 로직 재활용: 다행히 UI 로직과 분리된 **비즈니스 로직(Backend Logic)**은 .NET으로 마이그레이션된 후에는 WinUI 앱에서 재활용할 가능성이 높습니다. 만약 비즈니스 로직이 UI 코드와 강하게 결합되어 있다면, 이 부분도 분리하고 재구성해야 할 수 있습니다. (좋은 아키텍처를 가졌다면 이 부분이 가장 큰 이점)

   • XAML Islands (부분적 현대화):

     • 이것은 기존 WinForms 또는 WPF 애플리케이션 내부에 **WinUI 컨트롤을 "임베드"**하는 기능입니다.

     • 완전히 WinUI로 전환하기에는 너무 큰 프로젝트이거나, 특정 부분만 최신 UI로 현대화하고 싶을 때 유용합니다.

     • 예를 들어, 기존 WinForms 앱의 특정 탭 페이지에 최신 WinUI 차트 컨트롤을 넣고 싶을 때 사용할 수 있습니다.

     • 모든 UI를 한 번에 바꾸지 않고 점진적으로 마이그레이션할 수 있는 옵션을 제공하지만, 아키텍처 복잡성이 증가할 수 있습니다.

마이그레이션 시 고려사항 및 예상되는 어려움

• .NET 버전 호환성: .NET Framework 4.6.1은 오래된 버전이므로, 마이그레이션 과정에서 사용하던 라이브러리나 API가 최신 .NET에서는 더 이상 지원되지 않거나 변경되었을 수 있습니다.

• UI 컨트롤 및 API 차이: WinForms/WPF에서 사용하던 커스텀 컨트롤이나 특정 렌더링 로직은 WinUI에서 그대로 동작하지 않을 가능성이 매우 높습니다.

• 서드파티 라이브러리: 사용하고 있는 서드파티 UI 컨트롤 라이브러리(예: Telerik, Syncfusion 등)가 WinUI를 지원하는지, 아니면 새로운 WinUI용 버전을 구매해야 하는지 확인해야 합니다.

• 배포 모델: WinUI 앱은 MSIX 패키징을 사용하는 경우가 많습니다. 기존 배포 방식과 다를 수 있으므로 새로운 배포 파이프라인 구축이 필요할 수 있습니다.

• 학습 곡선: WinUI는 XAML 기반이며 UWP의 사상과 Fluent Design을 계승하므로, WinForms 개발자에게는 XAML과 MVVM(Model-View-ViewModel) 패턴에 대한 새로운 학습이 필요할 수 있습니다. WPF 개발자에게는 XAML 자체가 익숙하겠지만, WinUI의 특정 XAML 요소나 API 사용법은 다를 수 있습니다.

• 테스트: 마이그레이션 후에는 기능, 성능, UI 측면에서 광범위한 테스트가 필수적입니다. 자동화된 UI 테스트가 있다면 큰 도움이 됩니다.

결론

.NET Framework 4.6.1 WinForms/WPF 앱을 WinUI로 마이그레이션하는 것은 기술적으로 가능하지만, 이는 단순한 버전 업그레이션이 아니라 상당한 재작업(특히 UI 부분)을 동반하는 프로젝트가 될 것입니다.

마이그레이션을 고려한다면 다음 질문을 해보세요:

• 왜 WinUI로 마이그레이션해야 하는가? (현대적인 UI, Windows 11/10 디자인 적용, 최신 기능 활용, 장기적인 유지보수 용이성 등 명확한 목표가 있는지)

• 기존 앱의 코드베이스는 얼마나 UI와 분리되어 있는가? (비즈니스 로직을 얼마나 재활용할 수 있는가)

• 마이그레이션에 투입할 수 있는 리소스(개발 시간, 인력)는 충분한가?

• 점진적인 마이그레이션(XAML Islands)도 가능한 시나리오인가?

마이그레이션은 투자를 동반하는 결정이므로, 예상되는 이점과 필요한 노력을 신중하게 저울질해야 합니다.