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デバッグを有効にする必要があります。設定手順は以下の通りです。
- ［設定］ー［端末情報］ー［ビルド番号］を7回タップして開発者オプションを有効化
- ［設定］ー［開発者向けオプション］ー［USBデバッグ］を有効化
- USBケーブルでPCと接続し、デバッグを許可
正しく設定されていれば、Visual Studioのデバッグターゲット選択ドロップダウンに、ローカルデバイスとして実機が表示されます。
Androidでのビルド
環境が整ったら、実際にImageGeneratorアプリをAndroid向けにビルドしてみましょう。
初回ビルドの実行
Visual Studioで以下の手順を実行します。
- ソリューションエクスプローラーでImageGeneratorプロジェクトを右クリックする
- 「スタートアッププロジェクトに設定」を選択する
- ツールバーのデバッグターゲットでAndroidエミュレータまたは実機を選択
- ［デバッグ］ー［デバッグの開始］またはF5キーを押下
初回ビルド時は、NuGetパッケージのダウンロードやAOT（Ahead-of-Time）コンパイルが実行されるため、時間がかかる場合があります。ビルドが成功すると、選択したエミュレータまたは実機でアプリが起動します。
アプリが起動したら、メニュー画像生成を選択してみましょう。すると、エラーが出るはずです。
これは、OpenAIのAPIキーが取得できず、OpenAIクライアントの初期化で失敗するからです。根本的な原因は、前回組み込んだユーザーシークレットが、モバイル環境では動作しないためです。ユーザーシークレットは、あくまでWindowsの開発環境で成立する仕組みです。そこで、この部分を、モバイル環境や、本番環境を見すえた処理に変更します。
