【ITニュース解説】How to Migrate a Xamarin.Forms App to .NET MAUI 10 (2026 Guide)

Xamarinという開発ツールを使ってAndroidやiOS向けのモバイルアプリを開発していた人にとって、現在非常に重要な転換期が訪れている。マイクロソフトは、2024年5月1日をもって、Xamarinを含む関連SDK（ソフトウェア開発キット）のサポートを完全に終了した。これは、今後Xamarinに対してバグ修正やセキュリティアップデート、新機能の提供が一切行われないことを意味する。このサポート終了は、ただ単に技術が古くなるというだけでなく、既存のXamarin製アプリの運用に直接的な影響を与える深刻な問題だ。

最も大きな問題は、Google PlayやApple App Storeといったアプリストアの要件に、Xamarin製のアプリが対応できなくなることだ。アプリストアは、ユーザーのセキュリティ保護や最新OSへの対応を義務付けるため、アプリの開発に使用されるツールやターゲットとするOSバージョンについて、常に新しい基準を設けている。例えば、2026年にはApple App StoreはXcode 26でビルドされたアプリを、Google PlayはAndroid 16（API 36）をターゲットとするアプリの更新を要求するようになる。しかし、Xamarinの最終バージョンはこれらの要件を満たせないため、Xamarinで作られたアプリは、たとえ軽微なバグ修正であってもストアに更新を公開することができなくなる。これは、セキュリティ上の脆弱性が発見された場合でも修正版を提供できないという致命的な状況を引き起こし、アプリの提供継続が困難になる。このため、Xamarinを利用している開発者は、早急に後継技術である「.NET MAUI」（ドットネット マウイ）への移行を計画する必要がある。

.NET MAUIは、Xamarin.Formsの後継としてマイクロソフトが提供する新しいクロスプラットフォーム開発フレームワークだ。クロスプラットフォームとは、一つのプログラミング言語（主にC#）と一つのコードベースで、Android、iOS、macOS、Windowsといった複数のオペレーティングシステム向けのアプリケーションを同時に開発できる技術のことだ。これにより、プラットフォームごとに別々のコードを書く手間が省け、開発効率が大幅に向上する。.NET MAUIはXamarin.Formsの進化版であり、多くの改善点を含んでいる。例えば、以前はプラットフォームごとに複数のプロジェクトが必要だったのが、.NET MAUIでは一つのプロジェクトで全てのプラットフォームを管理できるようになり、開発と保守がよりシンプルになる。また、アプリの見た目を構成するUI（ユーザーインターフェース）コントロールは、よりモダンでカスタマイズしやすいものに進化し、パフォーマンス改善やアプリのファイルサイズ削減に貢献する新しい「ハンドラー」アーキテクチャが導入された。さらに、コミュニティによって提供される便利なツールキットも充実している。

.NET MAUIへの移行は、単にサポート終了への対応だけでなく、多くのメリットをもたらす。まず、最新の.NET開発環境とC#言語の機能、例えばリアルタイムでコード変更が反映される「.NET Hot Reload」などを利用できるようになるため、開発体験が向上する。また、アプリのパフォーマンスも最新の.NETの最適化によって改善される。単一プロジェクト・単一コードベースでの開発は、開発コストとメンテナンスコストの削減に直結する。そして最も重要なのは、.NET MAUIで開発されたアプリは、マイクロソフトと広範な.NETコミュニティからの継続的なサポートを受けられるため、将来にわたって新しいOSバージョンやデバイスに確実に対応し続けられる「将来性のある」アプリとなる点だ。移行後も、一般的なソフトウェア開発と同様に、毎年リリースされるメジャーバージョンアップに合わせてアプリを更新していくことで、常に最新の状態を保つことができる。

移行作業を始める前に、いくつか準備が必要だ。まず、開発環境として最新のVisual Studio 2026（またはVisual Studio 2022のバージョン17.14以降）と、その中に含まれる「.NET Multi-platform App UI開発」ワークロードをインストールする。macOS環境では、Visual Studio Codeに.NET MAUIの拡張機能を導入して開発を進める。iOSアプリをビルドし、Apple App Storeに公開するためには、Xcode 26がインストールされたMacが必要となる。また、ターゲットとする.NETのバージョンは、長期的なサポートが提供される.NET 10（MAUI 10）を選択するのが推奨される。既存のXamarinアプリについては、事前にXamarin.Formsのバージョンを最新の5.0にアップデートし、利用している外部ライブラリ（NuGetパッケージ）もできる限り最新版にしておくことが重要だ。これにより、.NET MAUIへの移行時に発生するAPI（アプリケーションプログラミングインターフェース）の変更点を最小限に抑え、スムーズな作業につながる。

Xamarinアプリを.NET MAUIに移行する方法は大きく分けて二つある。一つは「ツールによる支援」を利用する方法、もう一つは「新しい.NET MAUIプロジェクトへの手動での移行」だ。以前は.NET Upgrade Assistantというツールがあったが、現在は非推奨となり、代わりにVisual Studio 2026に搭載されている「GitHub Copilot modernization agent」がその役割を担う。このツールは、プロジェクトファイルの設定や一部のコードを自動で変換してくれるため、移行の最初のステップとして非常に有効だ。しかし、このツールの出力はあくまで「最初のたたき台」であり、画面のレイアウト（配置）や独自に実装したUI要素（カスタムレンダラー）、そしてサードパーティの外部ライブラリの対応については、手動での調整と確認が必須となる。もう一つの方法は、まっさらな.NET MAUIプロジェクトを新規作成し、そこに既存のXamarinアプリのコードファイル、XAMLファイル（画面の記述）、画像などのリソースを一つずつコピーしていくというものだ。この方法は手間がかかるが、新しいMAUIのプロジェクト構造に完全に最適化された、最もクリーンな状態のアプリを構築できるというメリットがある。最も効果的で推奨されるアプローチは、これら二つの方法を組み合わせることだ。最初にツールを使ってプロジェクトファイルや基本的な設定を変換し、その結果を参考にしながら、最終的には新しいMAUIプロジェクトにコードを移動していくという手順を踏むと、効率的かつ確実に移行を進められるだろう。

実際の移行作業では、いくつかの重要な修正作業が必要となる。まず、「名前空間（namespace）」の修正だ。Xamarin.Formsから.NET MAUIに変わることで、多くのクラスの名前空間が変わるため、コード内で参照している名前空間を新しいものに更新する必要がある。次に、アプリの起動処理について、Xamarin.Formsではプラットフォームごとに起動コードが異なっていたが、.NET MAUIでは「MauiProgram」という統一されたクラスでアプリの初期設定や依存性注入（DI）コンテナへのサービスの登録などを行う。この部分は、ASP.NET Coreの開発経験がある人には馴染み深い形式だ。APIの変更点も多く、Xamarin.Essentialsという便利な機能群は、ほとんどが.NET MAUIのコア機能として組み込まれたため、特別な参照なしで利用できるようになる。また、旧式の「ListView」は「CollectionView」というより高性能なものに置き換えが推奨され、「MessagingCenter」は「WeakReferenceMessenger」に移行する必要がある。最も手間がかかる作業の一つが「レイアウト」（画面の配置）の修正だ。Xamarin.Formsで使われていた「RelativeLayout」や「StackLayout」の「...AndExpand」といったオプションは廃止されたり、動作が変わったりするため、画面の見た目が崩れることがある。この場合、「Grid」などの新しいレイアウトコンテナや、「HorizontalStackLayout」「VerticalStackLayout」といった新しいStackLayoutを使って、画面を再構築する必要がある。マージンやパディングなどの細かい設定も、手動で調整して元の見た目に近づける作業が求められる。さらに、独自のUI要素を実装するために使っていた「カスタムレンダラー」は、.NET MAUIの新しいアーキテクチャである「ハンドラー」に移行する必要がある。互換性維持のための暫定的な方法もあるが、将来的にはハンドラーへの全面的な書き換えを検討すべきだ。

そして、アプリが依存している「外部ライブラリ（NuGetパッケージ）」の対応は、移行作業で最も難しい部分の一つとなることが多い。多くのライブラリはMAUI対応版が提供されているが、中にはMAUIに対応していないものや、代替となる別のライブラリを探す必要があるもの、あるいは自分でコードを修正しなければならないケースも出てくる。例えば、Firebaseのようなクラウドサービスを利用している場合、マイクロソフトが提供する既存のXamarin向けバインディングパッケージを継続して使うか、MAUI向けに作られた「Plugin.Firebase」のような新しいラッパーパッケージに切り替えるかの選択肢がある。Windows環境でビルド中に「パスの長さ制限」によってエラーが発生する場合があり、その場合はPowerShellを使ってWindowsのロングパス機能を有効にし、NuGetパッケージの保存場所をより短いパスに変更することで解決できる。Twilio Videoのようなビデオ通話機能を使っている場合、Twilioは公式の.NET MAUIライブラリを提供していないため、コミュニティが作成した「The49.Twilio.Video」のようなパッケージを利用するか、そのプロジェクトからバインディング部分だけを再利用して既存のカスタムレンダラーをMAUIの環境に適合させるなどの工夫が必要となる。これらの具体的な対応は、アプリが使用している個々のライブラリによって大きく異なるため、それぞれの状況に合わせて調査し、解決策を見つけ出す必要がある。最後に、移行したアプリはエミュレーター上だけでなく、実際のAndroidやiOSデバイスで徹底的にテストし、動作や見た目の違いを修正した上で、最新のアプリストア要件に適合するSDK（Xcode 26、Android API 36）でビルドして公開する。

結論として、.NET MAUIはXamarin.Formsの後継として、クロスプラットフォームアプリ開発の未来を担う重要なフレームワークだ。Xamarinのサポート終了とアプリストアの要件変更により、Xamarinアプリの更新は事実上不可能になっているため、.NET MAUIへの移行は避けられない道となる。移行作業は、ツールの助けを借りつつも、レイアウトやカスタムレンダラー、外部ライブラリの調整など、手動での確認と修正に多くの時間と労力がかかることを覚悟する必要がある。この一連の作業は大変な道のりだが、アプリを長く使い続け、ユーザーに安全で最新の体験を提供するために不可欠なプロセスだ。一度.NET MAUIへ移行すれば、アプリは将来にわたってアップデートを継続できるようになり、開発者は最新の技術で効率的なアプリ開発を進めることができるだろう。