🤖 Android開発環境

自動セットアップガイド

リハビリモニタリングアプリ用

✨ 自動セットアップスクリプトを用意しました！
複雑な環境構築を自動化し、数分でAndroid開発を始められます。

📋 提供スクリプト

スクリプト名 機能 実行タイミング
setup_android_auto.bat 環境の自動セットアップ
自動化		 初回のみ
setup_android_check.bat セットアップ状態の確認 セットアップ後

🚀 クイックスタート（3ステップ）

1Android Studio をインストール

公式サイトからダウンロード：

🔗 https://developer.android.com/studio


インストール時の注意：

  • ✅ Android SDK を含める
  • ✅ Android Virtual Device を含める
  • ✅ デフォルトの場所にインストール推奨
💡 インストールには約10-15分かかります。完了後、次のステップに進んでください。

2自動セットアップを実行

setup_android_auto.bat を管理者として実行します。


実行方法：

  1. エクスプローラーで setup_android_auto.bat を右クリック
  2. 「管理者として実行」を選択
  3. 画面の指示に従う

自動実行される処理：

  • ✅ Android Studio と SDK の検出
  • ✅ 環境変数の自動設定（ANDROID_HOME, PATH）
  • ✅ SDK ライセンスへの同意
  • ✅ 必要な SDK コンポーネントのインストール：
    • Platform Tools
    • Build Tools (34.0.0)
    • Android Platform (API 33, 34)
    • System Image (x86_64)
    • Android Emulator
    • CMake
  • ✅ AVD（Pixel 7 エミュレータ）の作成
⏱️ この処理には5-10分かかる場合があります。完了するまでお待ちください。

3セットアップを確認

コマンドプロンプトを再起動してから、setup_android_check.bat を実行します。


確認される項目（8項目）：

  • ✓ Android Studio のインストール
  • ✓ ANDROID_HOME 環境変数
  • ✓ ANDROID_SDK_ROOT 環境変数
  • ✓ adb コマンド
  • ✓ sdkmanager
  • ✓ SDK プラットフォーム
  • ✓ AVD（エミュレータ）
  • ✓ Flutter との連携

✅ すべてのチェックに合格すれば、Android開発環境の構築完了です！

📱 アプリのビルドと実行

開発モード（エミュレータで実行）

cd C:\Users\kawag\work\rehab_monitoring_project
flutter run

デバイス選択画面で Android エミュレータを選択します。

リリース用APKビルド

flutter build apk --release

ビルドされたAPK：build\app\outputs\flutter-apk\app-release.apk

Google Play配信用App Bundle

flutter build appbundle --release

ビルドされたファイル：build\app\outputs\bundle\release\app-release.aab

エミュレータの起動（直接起動）

emulator -avd Pixel_7_API_34

🔧 トラブルシューティング

問題: 管理者権限エラー

症状： スクリプト実行時に「管理者権限が必要」と表示される

解決方法：

  • スクリプトファイルを右クリック
  • 「管理者として実行」を選択

問題: Android Studio が見つからない

症状： スクリプトが Android Studio を検出できない

解決方法：

  1. Android Studio が正しくインストールされているか確認
  2. デフォルトの場所にインストールされているか確認：
    • C:\Program Files\Android\Android Studio
    • または %LOCALAPPDATA%\Android\Android Studio
  3. 別の場所にインストールした場合、スクリプトを編集してパスを追加

問題: 環境変数が反映されない

症状： adb や flutter コマンドが認識されない

解決方法：

  1. コマンドプロンプトを完全に閉じる
  2. 新しいコマンドプロンプトを開く
  3. または、PCを再起動

問題: エミュレータが起動しない

解決方法1: BIOS設定

  1. BIOS設定を開く（起動時にF2やDelキー）
  2. 仮想化技術（VT-x/AMD-V）を有効化
  3. PCを再起動

解決方法2: Hyper-V設定（Intel HAXM使用時）

PowerShell（管理者）で実行：

bcdedit /set hypervisorlaunchtype off

PCを再起動


解決方法3: WHPX使用（推奨）

PowerShell（管理者）で実行：

Enable-WindowsOptionalFeature -Online -FeatureName HypervisorPlatform

問題: Gradle ビルドが遅い

解決方法：

android\gradle.properties に以下を追加：

org.gradle.jvmargs=-Xmx4096m
org.gradle.parallel=true
org.gradle.caching=true
org.gradle.daemon=true

📊 スクリプトの詳細

setup_android_auto.bat の処理フロー

  1. 管理者権限チェック - 環境変数設定に必要
  2. Android Studio 検出 - 複数の標準的な場所を検索
  3. Android SDK パス検出 - ANDROID_HOME/ANDROID_SDK_ROOT 設定
  4. 環境変数設定 - システム環境変数への登録
  5. PATH更新 - platform-tools など必要なパスを追加
  6. ライセンス同意 - SDK使用に必要
  7. SDKコンポーネントインストール - 必要なツールを自動取得
  8. AVD作成 - Pixel 7 エミュレータを作成

setup_android_check.bat の確認項目

8項目をチェックし、合格/不合格を判定：

チェック項目 確認内容
Android Studio インストール場所の確認
ANDROID_HOME 環境変数の設定確認
ANDROID_SDK_ROOT 環境変数の設定確認
adb コマンドの実行可能性確認
sdkmanager SDK管理ツールの存在確認
SDK プラットフォーム インストール済みAPIレベルの一覧表示
AVD エミュレータの作成確認
Flutter連携 flutter doctor の実行

✅ 次のステップ

環境構築が完了したら：

  1. Flutter プロジェクトで flutter run を実行
  2. エミュレータで動作確認
  3. APKをビルドして実機にインストール
  4. Google Playストアへの配信準備

iOS開発も検討している場合：

📄 CROSS_PLATFORM_BUILD_GUIDE.html を参照してください。
MacなしでもクラウドサービスでiOSアプリをビルドできる方法を解説しています。