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

マルチプラットフォームビルドガイド（Windows環境）

最終更新: 2025年12月8日

📑 目次

1. 概要

✅ 完全マルチプラットフォーム対応完了！
本アプリは Web、Android、iOS のすべてで動作するように実装されています。

🌐 Web

ビルド成功

ブラウザで即座に動作可能。Windows環境で完結。

🤖 Android

環境構築必要

Android Studioのインストールが必要。Windows環境で完結。

🍎 iOS

クラウド推奨

通常はMac必須だが、クラウドサービスで回避可能。

プラットフォーム別通知実装

プラットフォーム 通知実装 ファイル
Web Web Notifications API (dart:html) notification_service_web.dart
Android flutter_local_notifications notification_service_mobile.dart
iOS flutter_local_notifications notification_service_mobile.dart

2. Android開発環境セットアップ（Windows）

💡 ポイント
Windows環境でAndroid開発は完全にサポートされています。以下の手順でセットアップできます。

1Android Studio のダウンロード

公式サイトから最新版をダウンロードします。

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

2Android Studio のインストール

インストーラーを実行し、以下のコンポーネントを含めます：

  • ✅ Android SDK
  • ✅ Android SDK Platform
  • ✅ Android Virtual Device (エミュレータ用)
  • ✅ Android SDK Build-Tools

3環境変数の設定

システム環境変数に以下を追加します：

ANDROID_HOME = C:\Users\<ユーザー名>\AppData\Local\Android\Sdk

Path に追加:
%ANDROID_HOME%\platform-tools
%ANDROID_HOME%\tools
%ANDROID_HOME%\tools\bin

4Android SDK の設定

Android Studio を起動し、SDK Manager で以下をインストール：

  • Android SDK Platform (最新版 + API 33以降推奨)
  • Android SDK Build-Tools
  • Android Emulator
  • Intel x86 Emulator Accelerator (HAXM) または WHPX

5Flutter との連携確認

コマンドプロンプトまたはPowerShellで実行：

flutter doctor

期待される結果：

[✓] Flutter (Channel stable, 3.x.x)
[✓] Android toolchain - develop for Android devices
[✓] Android Studio (version 2023.x or later)
[✓] VS Code (version x.x.x)
[✓] Connected device (1 available)

6エミュレータの作成

Android Studio の AVD Manager で仮想デバイスを作成：

  1. Android Studio を起動
  2. Tools → Device Manager を開く
  3. 「Create Device」をクリック
  4. Pixel 7 などの端末を選択
  5. システムイメージをダウンロード（API 33以降推奨）
  6. 設定を確認して「Finish」

7アプリのビルドと実行

プロジェクトディレクトリで以下を実行：

開発用ビルド（エミュレータで実行）

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

リリース用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
⚠️ 初回ビルドについて
初回ビルドは依存関係のダウンロードに時間がかかる場合があります（5-15分程度）。

3. iOSアプリビルド（Macなし）

🎯 重要情報
通常、iOSアプリのビルドにはMacが必須ですが、クラウドCI/CDサービスを使用することで、 Windows環境からでもiOSアプリをビルド・配信できます！

方法の比較

🥇 方法1: Codemagic（推奨）

最も人気 無料枠あり

特徴：

  • Flutter公式推奨のCI/CDサービス
  • 無料プラン: 月500分のビルド時間
  • Apple Silicon Mac (M2/M4) 対応で高速ビルド
  • GUIベースで設定が簡単
  • App Store Connect への自動配信対応

料金: 無料プランあり、有料プランは$40/月～

🔗 https://codemagic.io/

🥈 方法2: Bitrise

無料枠あり

特徴：

  • 老舗のモバイルCI/CDサービス
  • 無料プラン: 月300クレジット（約300分）
  • 豊富なプラグインとワークフロー
  • GitHubとの連携が強い

料金: 無料プランあり、有料プランは$36/月～

🔗 https://bitrise.io/

🥉 方法3: GitHub Actions

無料枠大

特徴：

  • GitHubに組み込まれているCI/CD
  • 無料プラン: パブリックリポジトリは無制限
  • プライベートリポジトリは月2,000分
  • YAML設定ファイルで柔軟なカスタマイズ

料金: 無料プランあり

🔗 https://github.com/features/actions

🖥️ 方法4: クラウドMacレンタル

有料のみ

特徴：

  • 実際のMac環境をリモートで使用
  • 完全な開発環境（Xcode, Simulator使用可能）
  • デバッグも可能

サービス例:

  • MacStadium: 企業向け高性能、$79/月～
  • MacinCloud: 時間課金可能、$30/月～
  • AWS EC2 Mac instances: 24時間最低契約、$25/日～

推奨: Codemagic での iOSビルド手順

1Codemagic アカウント作成

  1. https://codemagic.io/signup にアクセス
  2. GitHubアカウントでサインアップ（推奨）
  3. 無料プランを選択

2リポジトリの準備

アプリをGitHubにプッシュ：

cd C:\Users\kawag\work\rehab_monitoring_project
git init
git add .
git commit -m "Initial commit"
git remote add origin https://github.com/<your-username>/rehab-monitoring.git
git push -u origin main

3Codemagic でプロジェクトを追加

  1. Codemagic ダッシュボードで「Add application」をクリック
  2. GitHubリポジトリを選択
  3. 「Flutter App」を選択
  4. プロジェクトタイプを確認

4iOS署名の設定

⚠️ Apple Developer アカウントが必要
iOSアプリを配信するには Apple Developer Program への登録が必要です（年間99ドル）。
  1. Apple Developer アカウントにログイン
  2. App ID を作成（Bundle Identifier: com.example.rehab_monitoring）
  3. Provisioning Profile を作成
  4. Codemagic の設定画面で証明書をアップロード

5ビルド設定

Codemagic でビルド設定を構成：

  • Flutter version: 最新安定版を選択
  • Build for platforms: iOS を選択
  • Build mode: Release を選択
  • Build format: IPA を選択

6ビルド実行

  1. 「Start new build」をクリック
  2. ビルドの進行状況を監視（5-10分程度）
  3. ビルド成功後、IPAファイルをダウンロード

7App Store への配信（オプション）

Codemagic から直接App Store Connect に配信可能：

  1. App Store Connect API キーを取得
  2. Codemagic の Publishing 設定に追加
  3. 自動配信を有効化
✅ 完了！
Windows環境からiOSアプリをビルド・配信できました！

4. クラウドサービス比較表

サービス 無料プラン 有料プラン ビルド速度 おすすめ度
Codemagic 500分/月
Apple Silicon Mac対応		 $40/月～
無制限ビルド		 高速
7分22秒（Flutter）		 ⭐⭐⭐⭐⭐
Bitrise 300クレジット/月
（約300分）		 $36/月～ 標準
11分22秒（Flutter）		 ⭐⭐⭐⭐
GitHub Actions 2,000分/月
（プライベート）
無制限（パブリック）		 無料～$4/月 標準 ⭐⭐⭐⭐
Appcircle 100分/月 $25/月～ 標準 ⭐⭐⭐
MacinCloud なし $30/月～
時間課金も可能		 完全制御 ⭐⭐⭐
MacStadium なし $79/月～ 企業向け高性能 ⭐⭐⭐⭐
（企業向け）

選択基準

  • 個人開発者・スタートアップ: Codemagic または GitHub Actions がおすすめ
  • 頻繁にビルドする: GitHub Actions（パブリックリポジトリなら無制限）
  • デバッグも必要: MacinCloud などのクラウドMacレンタル
  • 企業・チーム開発: Codemagic Pro または MacStadium

5. トラブルシューティング

Android関連

問題: No Android SDK found

解決方法:

  1. 環境変数 ANDROID_HOME が正しく設定されているか確認
  2. コマンドプロンプトを再起動
  3. flutter doctor で状態確認

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

解決方法:

  1. BIOS で仮想化（VT-x/AMD-V）を有効化
  2. Hyper-V を無効化（Intel HAXM使用時）
  3. または WHPX（Windows Hypervisor Platform）を使用
# 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

iOS関連（Codemagic）

問題: 署名エラー

解決方法:

  1. Apple Developer アカウントの証明書が有効か確認
  2. Bundle Identifier が一致しているか確認
  3. Provisioning Profile が最新か確認

問題: ビルドがタイムアウト

解決方法:

  1. 不要な依存関係を削除
  2. キャッシュを有効化
  3. より高速なプラン（Apple Silicon Mac）を検討

Flutter 共通

問題: flutter doctor でエラー

解決方法:

# Flutter の再インストール
flutter upgrade
flutter doctor -v

# 依存関係のクリーンアップ
flutter clean
flutter pub get

6. 参考資料

公式ドキュメント

クラウドサービス

補足情報

🎉 マルチプラットフォーム開発の準備完了！

このガイドに従うことで、Windows環境から以下のすべてが可能になります：

  • ✅ Webアプリの開発とデプロイ
  • ✅ Androidアプリの開発、ビルド、配信
  • ✅ iOSアプリのビルドと配信（Macなし）