Flutter

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つです。

  1. しばらくビルドしていないプロジェクトの build/ と .dart_tool/flutter_build/
  2. Androidエミュレータのスナップショット
  3. Xcode の DerivedData

Gradleのバージョンをそろえる作業は、減らす効果は小さく、増やさない効果が中心でした。

ディスクが埋まると、つい「何かを共通化しなければ」と考えてしまいます。 実際には、まず測って、再生成できるものを消すだけで大半は片付きました。 同じ状況の方は、最初の du から試してみてください。

made with Flutter

この記事を書いた人がつくったアプリ

Flutter の記事

コメントの受け付けは終了しました。ご意見・ご質問は X(@nm_aru)へどうぞ。