Flutter・Androidアプリの開発環境を作った時のメモ（Mac）

以下の Flutter のサンプルアプリの実機テストを行う中で調べたり、対応した内容のメモです。

https://x.com/youtoy/status/1874457716762284415

利用したデバイスは、MacBook Pro（Intel版）と、Pixel 6a になります。

## Flutter SDK のセットアップ関連
Mac での Flutter SDK のセットアップについては、以下の SDK のバージョン管理が行える FVM を使いました。

元々、Mac に Homebrew は入っていたので、brewコマンドで導入しました。

●Installation – FVM
　https://fvm.app/documentation/getting-started/installation

```zsh
brew tap leoafarias/fvm
brew install fvm
```

以下のコマンドで、インストールができていることを確認します。

```zsh
fvm --version
```

その後は、安定版の SDK をダウンロードして、グローバルで使う形に設定しました。

なお、以下のコマンドで安定版の確認・インストールと、グローバルで利用するための設定をしました。

```zsh
fvm releases
fvm install 【安定版のバージョン】
fvm global 【安定版のバージョン】
```

また、以下を実行して開発環境のセットアップがどこまで進んでいるかを確認してみます。

```zsh
fvm flutter doctor
```

この時に参考にした情報は以下です。

●2024年12月版 macOS Sequoia にFVM+Flutterの開発環境を構築する - Qiita
　https://qiita.com/okaxaki/items/07b40a95b9170834def2

●macOS | Flutter
　https://docs.flutter.dev/get-started/install/macos

## Androidアプリの開発環境（Android Studio）のセットアップ
そして、Androidアプリの開発環境として Android Studio のセットアップを行いました。

基本的には、公式からのダウンロードを行い、デフォルト設定でインストールしました。

●Android Studio とアプリツールのダウンロード - Android デベロッパー  |  Android Developers
　https://developer.android.com/studio/releases?hl=ja

### Flutter用の対応
Android Studio では、Flutter用のプラグインの導入やパスの設定をしました。

![2025-01-04_17-56-17.jpg](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/50868/4f85e6b8-da7a-570b-d359-267daf4d5c3f.jpeg)

また以下などを行いました。

- SDK Manager での Android SDKにて SDK Tools を追加
- `fvm flutter doctor --android-licenses` でライセンス規約の同意に関する対応

ここで参照した情報は以下です。

●【Flutter】Android実機テストと「Running Gradle task 'assembleDebug'... 」｜辛島信芳（Flutterアプリ個人開発📱）
　https://note.com/karanobu/n/n68708b45f1ab

### 実機テスト用の設定
Android Studio から Androidスマホの実機を扱えるように設定をしました。

この部分は過去に行っていた内容もあり（例えば、Androidスマホでの USBデバッグの有効化など）、今回やったのはスマホ側で PC を信頼するという設定をしたくらいでした。

また Flutter SDK のパスは以下を指定しました。

```
/Users/【Macのユーザー名】/fvm/versions/【上でインストールしたFlutterのバージョン】
```

Flutter SDK のパスは、以下によるとグローバルで設定した後は `/Users/【Macのユーザー名】/fvm/default/` としても良さそうです。

●Flutter – FVMツール導入の手順ミスるとめんどい
　https://taniguchi-kanto.com/blog-20241021/

### ビルド周りの対応
アプリを実機で動かそうとした際に、Android Studio で「Running Gradle task 'assembleDebug'... 」というメッセージが出たところから先に進まない感じになったため、それについて調べて対応しました。

具体的には、以下の「Project SDK」「Module SDK」が空になっていた部分に関し、SDK の指定を行いました。

●Android Studioで「Running Gradle task 'assembleDebug'…」のまま進まない | つめあと的なやつ。
　https://saka24.blue/index.php/2021/05/12/android-studio_assembledebug/

![2025-01-04_18-43-05111.jpg](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/50868/d8fd59d8-537a-c587-9dc9-b0a9b9a6442c.jpeg)

![2025-01-04_18-43-27222.jpg](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/50868/7d059b79-b882-b3f7-60b3-7bfbd9b4fae6.jpeg)

また以下に書かれた「flutter clean（ `fvm flutter clean` ）」の対応もやってみていましたが、上で書いた SDK の指定と合わせてやっていたので、こちらに効果があったかは不明です。

●Android Build stuck on "Running Gradle task 'assembleDebug'... And 'flutter clean' stuck at 'Deleting build...' · Issue #116085 · flutter/flutter
　https://github.com/flutter/flutter/issues/116085

主に上記の対応を行った結果、無事にサンプルアプリを Androidスマホで動作させることができました。

## その他の参考情報
以下は、上記の対応をする中で見かけてメモしておきたいと思った内容があった記事です。

●Make Android apps | Flutter
　https://docs.flutter.dev/get-started/install/macos/mobile-android

●Flutter SDKをバージョン管理できるfvmでFlutterを使う
　https://zenn.dev/welchi/articles/d8f120adeebc7a85ed17

●やはりFlutterの難所は環境セットアップだった
　https://zenn.dev/peter_norio/articles/22d17e9ae33ab3


## 【2025/1/26追記】Windows での手順

この記事で作ったのと同じ環境を、Windows でも作ってみて、その手順を以下の記事に書いてみました。

●FVM で Windows上での Flutter の開発構築のメモ（＋ Androidアプリの開発環境も） - Qiita
　https://qiita.com/youtoy/items/edca3e29ac3e39108579