Flutter開発でMacのディスクが埋まったので、空きを27GBから113GBまで増やした記録

こんにちは。趣味グラマのNobu(@nm_aru)です。
複数のFlutterアプリを1台のMacで開発していたら、空き容量が27GBまで減りました。 ディスクは約500GBで、使用率は94%です。
調査と整理は Claude Code と一緒に進めました。 数時間の作業で、空きは113GB(使用率74%)まで戻りました。
始める前は「プロジェクトごとにGradleのバージョンが違うのが原因だろう」と考えていました。 実際に測ってみると、いちばん大きかったのは別のものでした。 同じように困っている方の参考になるよう、測り方・消したもの・外れた見積もりを記録しておきます。
数字はすべて私の環境での実測です。 Flutterのプロジェクトは9つ、Flutterは3.50、Xcodeのシミュレータのランタイムは1つだけ入っている状態でした。
まず何が容量を使っているか測る
消す前に、どこが大きいのかを測りました。 見るのは、ホーム配下のキャッシュと、各プロジェクトの中の2か所です。
# ホーム配下の、開発で増えやすい場所
du -sh ~/.gradle ~/.pub-cache ~/.android ~/Library/Android \
~/Library/Developer/Xcode/DerivedData \
~/Library/Developer/CoreSimulator \
~/Library/Caches/Homebrew
# プロジェクトごとの build と .dart_tool(プロジェクトを並べているフォルダで実行)
du -sh */build */.dart_tool
結果は次のとおりでした。
| 場所 | 容量 |
|---|---|
| 各プロジェクトのフォルダ(合計) | 約69GB |
iOSシミュレータ(CoreSimulator) |
57GB |
Androidエミュレータ(~/.android/avd) |
34GB |
Xcodeの DerivedData |
30GB |
| Android SDK | 22GB |
~/.gradle |
19GB |
| Homebrewのキャッシュ | 7.4GB |
| Flutter SDK | 3.7GB |
~/.pub-cache |
2.8GB |
プロジェクトのフォルダの内訳は、build/ が37.6GB、.dart_tool/ が11.5GBでした。
残りの多くは、作業用に増やした git worktree(リポジトリの複製)です。
開発関連だけで、使用中の400GBのうち約240GBを占めていました。
思い込みと実際
始める前に、原因を2つ予想していました。
予想1:Gradleのバージョンがプロジェクトごとに違い、~/.gradle が膨らんでいる
これは事実でした。
9つのプロジェクトで、Gradleが6種類、AGP(Android Gradle Plugin)が6種類、Kotlinが3種類に分かれていました。
ただし ~/.gradle は19GBで、全体の中では6番目です。
予想2:Flutterの共有ライブラリ(.so)がプロジェクトごとに入っている
これは半分だけ当たっていました。
Flutter SDK とエンジンは1か所にあり、全プロジェクトで共有されています。
重複していたのは、各プロジェクトの build/app/intermediates/ にコピーされる .so です。
あるプロジェクトでは、debugとreleaseの分を合わせて1.8GBありました。
これはビルドの出力なので、プロジェクト間で共有する仕組みはありません。 使っていないプロジェクトの分を消すのが対策になります。
つまり、容量を使っていたのは「共通化できていないもの」より「消してよいのに残っていたもの」でした。
効果が大きかった順にやったこと
空き容量は次のように変わりました。
| 作業 | 空き容量 |
|---|---|
| 開始時 | 27GB |
| Gradle統一後の確認ビルド(一時的に減る) | 20GB |
| 古いGradleキャッシュを削除 | 27GB |
DerivedData を整理 |
41GB |
build/ の中間生成物を削除 |
67GB |
| 使い終わった worktree と Homebrew のキャッシュを削除 | 78GB |
| AVDのスナップショットを削除 | 95GB |
| 重複するシミュレータ4台を削除 | 99GB |
| 約35分後に測り直し | 113GB |
以下、効果の大きかった順に書きます。
1. build の中間生成物(+26GB)
しばらくビルドしていない5つのプロジェクトで、build/ と .dart_tool/ が合計31GBありました。
中間生成物を消したところ、2.9GBになりました。
いちばん簡単な方法は flutter clean です。
ただ、build/ の中には消したくないものも入っていました。
- ストア用の画像や、撮影スクリプトの出力
- リリースしたビルドのシンボルファイル
- iOSのアーカイブ(
build/ios/archive)と ipa - リリース用の AAB と、R8 の
mapping
シンボルやアーカイブは、クラッシュレポートを読み解くときに必要になることがあります。 そのため、これらを残して、それ以外だけを消しました。
もう1つ見落としやすいのが .dart_tool/flutter_build/ です。
ビルドの構成ごとにフォルダが増えていき、自動では消えません。
あるプロジェクトでは54世代分、3.7GBが溜まっていました。
2. AVDのスナップショット(+17GB)
Androidエミュレータは4台で34GBありました。 そのうち15GBは、クイックブート用のスナップショットです。
du -sh ~/.android/avd/*.avd/snapshots
スナップショットを消しても、エミュレータに入れたアプリやデータは残ります。 次の起動が数十秒遅くなるだけです。
そのままだと、エミュレータを終了したときにまた作られます。
ストアのスクリーンショット専用のAVDは、毎回コールドブートする設定に変えました。
各AVDの config.ini で、次の2行を書き換えます。
fastboot.forceColdBoot=yes
fastboot.forceFastBoot=no
3. Xcode の DerivedData(+14GB)
DerivedData は30GBあり、47個のフォルダが入っていました。
どのプロジェクトのものかは、各フォルダの info.plist で分かります。
/usr/libexec/PlistBuddy -c "Print :WorkspacePath" \
~/Library/Developer/Xcode/DerivedData/Runner-xxxx/info.plist
調べると、すでに削除した worktree のものが4つ、合計4.3GB残っていました。
元のフォルダを消しても、DerivedData 側は消えません。
全部消しても再生成されますが、次のビルドが遅くなります。 今回は「直近2日以内に使ったもの」と共有のモジュールキャッシュだけ残しました。
4. 使い終わった worktree と Homebrew のキャッシュ(+11GB)
git worktree は、1つ増やすたびに build/・.dart_tool/・DerivedData が丸ごと増えます。
私の環境では、1つあたり5〜9GBでした。
マージ済みで未コミットの変更がないものを3つ消しました。
Homebrew のキャッシュは7.4GBあり、次のコマンドでほぼ空になりました。
brew cleanup --prune=all
5. 古いバージョンのGradleキャッシュ(+7GB)
これは、次の節の「バージョンをそろえる」とセットの作業です。
そろえたあとで、使わなくなったバージョンの ~/.gradle/caches/<バージョン>/ と wrapper/dists/ を消しました。
消す前に、そのバージョンのGradleデーモンが動いていないかを確かめます。 私の環境では、Android Studio が起動したデーモンが1つ残っていました。
# そのバージョンの gradle で、デーモンの状態を見る
gradle --status
# 処理中でなければ(IDLE なら)止める
gradle --stop
Gradle・AGP・Kotlinを全プロジェクトでそろえる
Gradleは、バージョンごとに専用のキャッシュ(~/.gradle/caches/<バージョン>/)を持ちます。
中身の大半は、ライブラリを変換した結果(transforms)です。
私の環境では、1バージョンあたり3〜4.5GBありました。
そこで、9つのプロジェクトのバージョンを1セットにそろえました。 書き換えるのは、各プロジェクトの次の2ファイルです。
android/gradle/wrapper/gradle-wrapper.properties(Gradle本体)android/settings.gradle.kts(AGPとKotlin)
そろえる先は「いちばん新しいものを使っているプロジェクト」に合わせました。 新しいAGPを必要とするプラグインがあるので、下げるより上げるほうが安全です。
あわせて、wrapperを -all から -bin に変えました。
-all にはソースとドキュメントが含まれていて、数百MB大きくなります。
distributionUrl=https\://services.gradle.org/distributions/gradle-9.9.1-bin.zip
ハマったこと:AGP 8系は Gradle 9.6 以降で動かない
1つだけ、AGPを意図的に8系で止めていたプロジェクトがありました。 Gradle本体だけをそろえようとしたところ、次のエラーで止まりました。
Plugin ‘com.android.internal.application’ relies on ‘org.gradle.api.problems.internal.InternalProblems’, a Gradle internal API that was removed in Gradle 9.6.0.
Gradle 9.6で内部のAPIが削除されたためで、AGPを9系に上げるしかありません。 このプロジェクトは、AGPも上げたうえでリリースビルドが通ることを確認しました。
書き換えたら、必ずビルドして確かめる
設定を書き換えただけでは安心できません。 全プロジェクトで、実際のリリース手順と同じコマンドを実行しました。
flutter build appbundle --release
9つのうち2つは、Gradleとは関係のない理由で止まりました。 少し前にFlutterを上げたあと、依存パッケージのバージョンが解決できなくなっていたためです。 しばらくビルドしていないプロジェクトの問題が、こうして見つかることもあります。
見積もりが外れたこと
Claude Code に出してもらった見積もりは、2か所で外れました。 外れたことはその都度報告を受けたので、そのまま書いておきます。
Gradleの統一は、思ったほど減らなかった
当初の見積もりは「約10GBの削減」でした。
実際には、~/.gradle は19GBのままです。
理由は2つあります。
- 調査した時点では、たまたま3バージョン分のキャッシュしか残っていなかった
- 1バージョンにそろえても、9プロジェクト分の変換結果で9.6GBになった
このほか、作業中のブランチが使っている古いバージョンの分が、まだ約4GB残っています。
キャッシュの大きさは、バージョンの数だけでなく、プロジェクトとプラグインの数にも比例します。 統一の効果は「減る」ことより「6バージョン分まで増えるのを防ぐ」ことでした。 そろえなければ、全プロジェクトをビルドし直した時点で30GB近くになっていたはずです。
シミュレータは、消した直後の数字では判断できない
iOSシミュレータは du で57GBと出ていました。
ここを減らせば40GB空く、というのが最初の見積もりです。
重複していた4台(表示上は合計26GB)を消したところ、直後に増えた空きは約4GBでした。 ところが、ほかに何も消していない約35分後に測り直すと、さらに14GB増えていました。
遅れて解放されたのか、別の要因なのかは切り分けられていません。 言えるのは、次の2点です。
- フォルダの表示サイズと、実際に空く容量は一致しない
- 効果は、時間をおいて測り直さないと分からない
なお、重複の判断は画面の解像度で行いました。 iPhone 17 Pro Max と iPhone 18 Pro Max は、どちらも1320×2868で同じです。 ランタイムも同じなので、2台持つ意味はありませんでした。
2台残っていた理由は、スクリーンショット用のスクリプトの機種名が、プロジェクトごとに違っていたことだけです。 機種名をそろえてから、片方を消しました。 消す前にスクリプトを調べなければ、撮影が動かなくなるところでした。
やらなくてよかったこと
調べた結果、導入しなかったものもあります。
- FVMなどのバージョン管理ツール:Flutter SDK は1つだけで、3.7GBでした。プロジェクトごとにバージョンを分けると、SDKが複数入って逆に増えます。
- Pub workspace:
~/.pub-cacheはもともと全プロジェクトで共有されていて、2.8GBでした。プロジェクトが別々のリポジトリなので、まとめる利点もありませんでした。
「共通化すれば減るはず」と考えがちですが、すでに共通化されているものも多くありました。
再発を防ぐ決まり
今回決めたことは次のとおりです。
- Gradle・AGP・Kotlinは全プロジェクトで同じにする。上げるときは全部同時に上げる
- worktree を消すときは、対応する
DerivedDataも消す - しばらく触らないプロジェクトは、
build/の中間生成物を消しておく - スクリーンショット専用のAVDは、コールドブートにする
- 撮影用のシミュレータは、全アプリで同じ機種・同じ名前を使う。アプリごとに専用の端末を作らない
- 消す前に、中身と使用中のプロセスを確かめる
最後の点は、今回いちばん役に立ちました。
build/ の中のシンボルファイル、動いていたGradleデーモン、機種名を直書きしたスクリプト。
どれも、確かめずに消していたら後で困ったものです。
まとめ
空き容量は27GBから113GBになりました。 効果が大きかったのは、次の3つです。
- しばらくビルドしていないプロジェクトの
build/と.dart_tool/flutter_build/ - Androidエミュレータのスナップショット
- Xcode の
DerivedData
Gradleのバージョンをそろえる作業は、減らす効果は小さく、増やさない効果が中心でした。
ディスクが埋まると、つい「何かを共通化しなければ」と考えてしまいます。
実際には、まず測って、再生成できるものを消すだけで大半は片付きました。
同じ状況の方は、最初の du から試してみてください。
Flutter の記事
コメントの受け付けは終了しました。ご意見・ご質問は X(@nm_aru)へどうぞ。


