.NET MAUI Blazorで構築したアプリを、モバイル環境に適用しよう

Android開発環境のセットアップ

　モバイル環境で実行した場合の動作画面のイメージは次の通りです。

　.NET MAUIでAndroidアプリを開発するには、Android SDKとエミュレータまたは実機が必要です。Visual Studio 2022には、これらを統合的に管理する機能が用意されているため、比較的簡単にセットアップできます。

Android SDKの自動インストール

　Visual Studio 2022をインストールする際に「.NET マルチプラットフォーム アプリ UI 開発」ワークロードを選択したはずです。このワークロードでは、Android SDK Tools、Android SDK Build-tools、Android Emulatorなどの必要なコンポーネントも自動的にインストールされます。

　Visual Studioの［ツール］メニューから［Android］ー［Android SDK Manager］を選択すると、インストール済みのSDKや追加でインストール可能なコンポーネントを確認できます。

Android エミュレータの設定

　実機を持っていない場合は、Android エミュレータを使用してアプリをテストできます。Visual Studioの［ツール］メニューから［Android］ー［Android Device Manager］を選択して、エミュレータを作成・管理します。

　新しいエミュレータを作成する際は、以下の点に注意してください：

• APIレベル：最低でもAPI 21（Android 5.0）以上を選択
• ハードウェア：Google Playサービスが必要な場合は「Google APIs」を含むイメージを選択
• アーキテクチャ：開発マシンがx64の場合はx86_64イメージを選択（パフォーマンス向上のため）
• メモリ：最低2GB、推奨4GB以上のRAMを割り当て

実機での開発設定

　実機を使用する場合は、デバイス側で開発者オプションとUSBデバッグを有効にする必要があります。設定手順は以下の通りです。

1. ［設定］ー［端末情報］ー［ビルド番号］を7回タップして開発者オプションを有効化
2. ［設定］ー［開発者向けオプション］ー［USBデバッグ］を有効化
3. USBケーブルでPCと接続し、デバッグを許可

　正しく設定されていれば、Visual Studioのデバッグターゲット選択ドロップダウンに、ローカルデバイスとして実機が表示されます。

Androidでのビルド

　環境が整ったら、実際にImageGeneratorアプリをAndroid向けにビルドしてみましょう。

初回ビルドの実行

　Visual Studioで以下の手順を実行します。

1. ソリューションエクスプローラーでImageGeneratorプロジェクトを右クリックする
2. 「スタートアッププロジェクトに設定」を選択する
3. ツールバーのデバッグターゲットでAndroidエミュレータまたは実機を選択
4. ［デバッグ］ー［デバッグの開始］またはF5キーを押下

　初回ビルド時は、NuGetパッケージのダウンロードやAOT（Ahead-of-Time）コンパイルが実行されるため、時間がかかる場合があります。ビルドが成功すると、選択したエミュレータまたは実機でアプリが起動します。

　アプリが起動したら、メニュー画像生成を選択してみましょう。すると、エラーが出るはずです。

　これは、OpenAIのAPIキーが取得できず、OpenAIクライアントの初期化で失敗するからです。根本的な原因は、前回組み込んだユーザーシークレットが、モバイル環境では動作しないためです。ユーザーシークレットは、あくまでWindowsの開発環境で成立する仕組みです。そこで、この部分を、モバイル環境や、本番環境を見すえた処理に変更します。