結論
オフラインのキャッシュに 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 のキャッシュに直接書き込むのは避け、足りないものだけを別のフォルダに置いて読ませました。
- 足りないファイルを Google の公開の Maven(maven.google.com)から取得する。今回は browser 1.4.0 の aar と、解決に要るメタデータの合計 3 ファイルでした。置き場は既存のキャッシュとは別の新しいフォルダにします。
- 取得したファイルの一覧と SHA を記録し、配布元が公開しているチェックサムと照らす。今回は 3 種類とも一致しました。あわせて、手元の変換キャッシュから展開された中身と同じであることも確かめました。
- そのフォルダを Maven のリポジトリとして読む init script(
*.init.gradle.kts)を用意し、ビルドのときに読ませる。読むのは一覧に載せたファイルだけにしました。 - ビルドの前に、置き場の中身が記録した SHA と一致するかを照らす。一致しなければビルドを始めずに止めます。
- もう一度 offline でビルドする。今回は
checkDebugAarMetadataを越えて、Gradle の組み立ては最後まで通りました。
init script とビルドの前の照合は、ビルドを流す自前の Python の道具に組み込みました。わざと改ざんしたファイルや別のファイルを混ぜた置き場も作って試し、どれもビルドの前に止まることを確かめています。
再発防止・気づき
- オフラインでビルドする環境では、新しい依存を足したら、kotlinc ではなく Gradle で一度ビルドを流して キャッシュにあるかを確かめる。コンパイルが通っても安心できません。
- 足りない依存は、既存のキャッシュに混ぜるより別の置き場に分けると、何を足したかが後から分かります。
- 外から取ったファイルは、公開のチェックサムとの照合と、ビルドのたびの SHA の照合をセットにしておくと、すり替わりに気づけます。
関連
- Kotlin「’public’ function exposes its ‘internal’ return type argument」で compileDebugKotlin が失敗する。試験用の関数を internal にして通った:同じ Android のビルドで、Kotlin のコンパイルの段で止まったとき
- Windows の Job オブジェクトで CPU 上限をかけたのに Gradle(java)が効かない。Microsoft Store 版 Python から起動した子が Job の外に出ていた:Gradle のビルドを道具から流していて、CPU の上限が効かないとき