GitHub Actions で Android の Gradle ビルドが遅い：Gradle のキャッシュ、ビルドキャッシュ、ヒープ、コア数

GitHub Actions の Android の Gradle ビルドが遅いのは、4 つの理由が重なっているからです。ジョブは毎回新しい VM なので、Gradle User Home（~/.gradle：依存ライブラリ、ラッパーの Gradle 本体、ローカルのビルドキャッシュ）は空から始まります。Gradle のビルドキャッシュは、org.gradle.caching=true にするまで無効です。Gradle のヒープは既定で 512 MB（-Xmx512m）で、Android のドキュメントは、ガベージコレクションがビルド時間の 15% を超えるなら 4〜8 GB に上げるよう勧めています。そしてプライベートリポジトリの ubuntu-latest は 2 CPU・メモリ 8 GB です。直すのはこの順です。gradle/actions/setup-gradle で Gradle User Home をキャッシュし、ビルドキャッシュと並列実行を有効にし、ヒープを上げ、最後にコアとメモリを増やします。最後の 2 つはマシンの問題です。~/.gradle をジョブのあともディスクに残すランナーなら、キャッシュの復元そのものも要りません。

Skipbox は、アカウント専用のマシンでジョブを動かします。Gradle User Home、JDK、Docker のレイヤーはジョブのあとも残ります。runs-on: skipbox の 1行を書き換えるだけで、月 6,000 円の定額、実行時間は無制限です。skipbox-8x16 なら 8 vCPU・メモリ 16 GB です。

1. Gradle User Home をキャッシュする

setup-gradle は、Gradle User Home のうち次のビルドに効く部分、つまりダウンロードした依存ライブラリ、ラッパーの Gradle 本体、ローカルのビルドキャッシュをキャッシュします。

- uses: actions/setup-java@v5
  with:
    distribution: temurin
    java-version: 17
- uses: gradle/actions/setup-gradle@v6
- run: ./gradlew assembleDebug

どれだけ効くかは、ドキュメントにある 3 つの点で決まります。

• 書き込むのはデフォルトブランチだけ。 既定では、ほかのブランチとプルリクエストのジョブはキャッシュを読むだけで保存しません。長く続くブランチは、main が最後に保存したものを毎回復元します。
• 実行のたびに新しいエントリを書きます。 ジョブと OS ごとで、どれも GitHub のリポジトリごと 10 GB の枠を使います。
• 既定のキャッシュの仕組みは、公開リポジトリなら無料、プライベートリポジトリでは Free Preview です。cache-provider: basic は MIT ライセンスです。

2. ビルドキャッシュと並列実行を有効にする

Gradle の性能のガイドから、gradle.properties に書きます。

org.gradle.caching=true
org.gradle.parallel=true
org.gradle.configuration-cache=true

• org.gradle.caching=true。 「既定では、Gradle はビルドキャッシュを使いません」。有効にすると、入力の変わっていないタスクは FROM-CACHE になります。CI のジョブをまたいで効かせるには、Gradle User Home のローカルのビルドキャッシュがジョブのあとも残るか、リモートのビルドキャッシュが要ります。
• org.gradle.parallel=true で、別々のモジュールのタスクを同時に動かします。動かすためのコアが要ります。
• 設定キャッシュは、ビルドスクリプトが変わっていなければ設定のフェーズを飛ばします。Android のビルド速度のガイドも勧めています。

Android のガイドは、作業を減らすプロジェクトの設定をさらに 2 つ挙げています。推移的でない R クラスと、どの依存ライブラリにも要らなくなった Jetifier を切ることです。

3. ビルドに合ったヒープを Gradle に渡す

Gradle の JVM の引数は、既定で -Xmx512m -XX:MaxMetaspaceSize=384m です（ビルド環境）。Android のガイドは、ガベージコレクションがビルド時間の 15% を超えるなら（Build Analyzer で見えます）ヒープを 4、6、8 GB に上げ、パラレル GC も試すよう勧めています。

org.gradle.jvmargs=-Xmx6g -XX:+UseParallelGC

プライベートリポジトリの ubuntu-latest では、6 GB のヒープはマシンの 8 GB の 4 分の 3 で、ビルドのほかのプロセスと OS もそこに入ります。マシンのメモリが尽きると Linux がビルドを止め、ジョブは exit code 137 で終わります。Skipbox の M の 16 GB なら余裕があります。

4. ビルドにコアを増やす

並列実行を有効にすると、Gradle は独立したモジュールのタスクを同時に動かします。プライベートリポジトリの ubuntu-latest は 2 CPU です（GitHub ホストランナー）。GitHub の大きいランナーならコアは増えますが、使えるのは GitHub Team と Enterprise Cloud の組織だけで、分課金です。8 コア・32 GB で 1分 $0.022 です。

CI でのデーモン

Gradle のガイドによれば、CI では「長く動き続けるエージェントにはデーモンが効くが、短命なものには効かないことがある」。GitHub ホストランナーのジョブは短命です。Skipbox のジョブも、デーモンにとっては短命です。ジョブのたびにプロセスをすべて止めるので、次のジョブは新しいデーモンで始まります。次に渡るのはディスクにあるものです。

GitHub のランナーで、それぞれの直し方にかかるもの

• setup-gradle のキャッシュは、ジョブの始まりのダウンロードと展開、そしてデフォルトブランチのジョブの終わりのアップロードです。プルリクエストが読むのは main が保存したもので、自分の前回の実行ではありません。
• リモートのビルドキャッシュは、もう 1 台のサーバーを動かすことで、ヒットのたびにネットワークを通ります。
• コアとメモリを増やすのは大きいランナーで、GitHub Team か Enterprise Cloud が要ります。

Skipbox は Gradle User Home を残す

プランごとに、アカウント専用のマシンが付き、ジョブのあとも残ります。

• ~/.gradle/caches が残ります。 依存ライブラリ、変換結果、ローカルのビルドキャッシュです。org.gradle.caching=true なら、入力の変わっていないタスクは次のジョブで FROM-CACHE になります。プルリクエストのジョブもです。
• ラッパーの Gradle 本体は ~/.gradle/wrapper に残り、setup-java で入れた JDK、Docker のイメージとレイヤーも残ります。
• setup-gradle は手を出しません。 ~/.gradle/caches が既にあれば、setup-gradle は既定でそれを上書きせず、ジョブのサマリーに「Caching for Gradle actions was disabled due to pre-existing Gradle User Home」と出ます。同じワークフローは GitHub のランナーでもそのまま動きます。
• イメージに Android SDK はありません。 GitHub の ubuntu-latest には入っています。Skipbox では android-actions/setup-android を足してください。
• コアとメモリはラベルで選び、定額です。 実行時間は無制限です。

S で、キャッシュに使える容量は GitHub の 7倍以上。マシンの大きさは、ジョブのラベルで選びます。

月 20,000分なら、GitHub の 4 コアのランナーは 約 35,120 円参考値：2026年11月10日の為替レート・1ドル＝158.22円。米ドルの料金を、このレートで円に換算した概算です。で S は 6,000 円、8 コアのランナーは 約 66,770 円参考値：2026年11月10日の為替レート・1ドル＝158.22円。米ドルの料金を、このレートで円に換算した概算です。で M は 12,000 円です。GitHub の額は、GitHub Team に含まれる無料分を引いたあとの請求です。

移行は runs-on を 1行書き換えるだけ

jobs:
  build:
    runs-on: skipbox-8x16 # ubuntu-latest から書き換える
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-java@v5
        with:
          distribution: temurin
          java-version: 17
      - uses: android-actions/setup-android@v4
      - uses: gradle/actions/setup-gradle@v6
      - run: ./gradlew assembleDebug testDebugUnitTest

skipbox-8x16 はプラン M で動きます。トライアルで動くのは runs-on: skipbox です。

1. Skipbox に GitHub でログインする
2. Skipbox の GitHub アプリを入れて、使うリポジトリを選ぶ
3. runs-on を書き換えて push する

セキュリティ

• マシンはアカウントごとの専用です。ほかの会社のジョブと同じマシンで動くことはありません。
• ジョブが終わるたびに、ランナーの認証情報、プロセスとコンテナ、ホームディレクトリの認証情報のファイルを消します。「毎回クリーン」なら、ジョブごとに新しいマシンで動きます。
• 書き込み権限のない人のコード（フォークからのプルリクエストなど）は、使い捨ての VM で動きます。キャッシュは読めますが、書き換えられません。

くわしくはジョブの分離のしくみにあります。

Android のビルドで試す

カード不要で、7日間かジョブの合計 3,000分まで無料です。ビルドのジョブを runs-on: skipbox にして 2 回動かし、2 回目のタスクの結果（FROM-CACHE、UP-TO-DATE）を GitHub と並べてください。

2026年11月13日 更新