Gradle のオフラインビルドが checkDebugAarMetadata で「Could not download browser-1.4.0.aar … No cached version available for offline mode」。足りない aar だけを別の置き場に取ってきて通した

結論

オフラインのキャッシュに androidx.browser 1.4.0 の aar 本体が入っていなかったのが原因でした。足りないファイルだけを Google の Maven から別のフォルダに取ってきて、チェックサムを照らしてから init script でそのフォルダを読ませたら、Gradle のビルドは最後まで通りました。

--offline で Android アプリをビルドしていて、新しく androidx.browser を使うコードを足したところで止まりました。紛らわしかったのは、同じコードを kotlinc で先にコンパイルしたときは通っていたことです。

症状

:app:checkDebugAarMetadata で失敗します。

> Task :app:checkDebugAarMetadata FAILED

FAILURE: Build failed with an exception.

* What went wrong:
Execution failed for task ':app:checkDebugAarMetadata'.
> Could not resolve all files for configuration ':app:debugRuntimeClasspath'.
   > Failed to transform browser-1.4.0.aar (androidx.browser:browser:1.4.0) to match attributes {artifactType=android-aar-metadata, ...

ログを追うと、肝心の行はこれでした。

Could not download browser-1.4.0.aar (androidx.browser:browser:1.4.0): No cached version available for offline mode

環境

  • Windows
  • Android アプリ(Kotlin)を Gradle の offline モードでビルド
  • 依存: androidx.browser:browser:1.4.0
  • 事前に kotlinc で同じソースのコンパイルは通っていた

原因

kotlinc でコンパイルできたときに使っていた jar は、Gradle の 変換キャッシュ(transforms)の中身 でした。aar を展開した後の classes.jar が残っていたので、コンパイルだけなら通ります。

ところが Gradle 本体のビルドは、checkDebugAarMetadata などで aar そのもの を要求します。オフラインのキャッシュには aar 本体が無かったので、ネットに取りに行けず止まった、という流れです。

使ったもの 中身の出どころ 結果
kotlinc でのコンパイル 変換キャッシュの中の jar 通る
Gradle の本ビルド(offline) オフラインのキャッシュの aar 本体 無いので失敗

「jar が手元にある=依存がキャッシュにある」ではない、というのが今回の要点です。

解決手順

C: の Gradle のキャッシュに直接書き込むのは避け、足りないものだけを別のフォルダに置いて読ませました。

  1. 足りないファイルを Google の公開の Maven(maven.google.com)から取得する。今回は browser 1.4.0 の aar と、解決に要るメタデータの合計 3 ファイルでした。置き場は既存のキャッシュとは別の新しいフォルダにします。
  2. 取得したファイルの一覧と SHA を記録し、配布元が公開しているチェックサムと照らす。今回は 3 種類とも一致しました。あわせて、手元の変換キャッシュから展開された中身と同じであることも確かめました。
  3. そのフォルダを Maven のリポジトリとして読む init script(*.init.gradle.kts)を用意し、ビルドのときに読ませる。読むのは一覧に載せたファイルだけにしました。
  4. ビルドの前に、置き場の中身が記録した SHA と一致するかを照らす。一致しなければビルドを始めずに止めます。
  5. もう一度 offline でビルドする。今回は checkDebugAarMetadata を越えて、Gradle の組み立ては最後まで通りました。

init script とビルドの前の照合は、ビルドを流す自前の Python の道具に組み込みました。わざと改ざんしたファイルや別のファイルを混ぜた置き場も作って試し、どれもビルドの前に止まることを確かめています。

再発防止・気づき

  • オフラインでビルドする環境では、新しい依存を足したら、kotlinc ではなく Gradle で一度ビルドを流して キャッシュにあるかを確かめる。コンパイルが通っても安心できません。
  • 足りない依存は、既存のキャッシュに混ぜるより別の置き場に分けると、何を足したかが後から分かります。
  • 外から取ったファイルは、公開のチェックサムとの照合と、ビルドのたびの SHA の照合をセットにしておくと、すり替わりに気づけます。

関連

この記事を書いた人

realine

Windows の PC で、MT5(MQL5)の EA・インジケーターの開発、WordPress のプラグイン開発とサイト運営、PowerShell・Python での作業の自動化をしています。このサイトには、その作業で実際につまずいたことと、効いた直し方を、確かめた環境と手順つきで残しています。

運営者情報と記事の作り方