同じソースから作った縮小済みAPKなのに、一部の成果物だけが起動時にクラッシュし、端末ログやdexdumpにOut-of-order annotation_element name_idxと出ることがあります。Google Issue #485558707で追跡された、R8が断続的に検証不能なDEXを生成する不具合です。公式修正版はAndroid Gradle Plugin(AGP)9.3.3と9.4.1です。
代表的なログ
Failed to verify .../base.apk!classes7.dex:
Failure to verify dex file 'classes7.dex':
Out-of-order annotation_element name_idx: bb15 then bb15
dexdump.cc:2012 Failure to verify dex file 'classes5.dex':
Out-of-order entry types: 30fc then 30fc
問題のDEXが読み込めないため、表面上は次のような別エラーになることもあります。
FATAL EXCEPTION: main
java.lang.RuntimeException: Unable to instantiate application ...
Caused by: java.lang.ClassNotFoundException:
Didn't find class "com.example.MyApplication" on path: DexPathList[...]
原因
DEXでは注釈要素などを規定順に格納する必要があります。この不具合ではR8が順序違反のデータを書き込み、dex2oatやdexdumpがDEX全体を拒否します。後続のClassNotFoundExceptionは、クラスが必ず削除されたという意味ではなく、収録先DEXを読み込めない結果です。
断続的に発生: 報告環境ではキャッシュなし・同一ソースのビルドでも約8回に1回発生しました。この割合は一例であり、全プロジェクト共通ではありません。
発生条件・対象バージョン
- R8を使う縮小済みAPK/AAB
- 複数DEXを生成する比較的大きなアプリ
- 注釈要素またはエントリーの順序が不正になった成果物
公式IssueはAGP 8.7.2から8.12.3(同梱R8 8.12.22)へ更新後の発生例を示します。影響範囲全体は公開されていないため、8.12.3だけの問題とは断定できません。AGP 9.3.3と9.4.1では修正済みと公式に掲載されています。
推奨する解決手順
- ルートのビルドスクリプトまたはVersion CatalogでAGP版を確認します。
- 9.3系は9.3.3以上、9.4系は9.4.1以上へ更新します。
- 選んだAGPに対応するGradle/JDKへ揃えます。AGP 9.3の公式互換表はGradle 9.5.0、JDK 17です。
- CIの古いAPK/AABやキャッシュと区別し、リリース成果物を作り直します。
plugins {
id("com.android.application") version "9.4.1" apply false
}
代替策
すぐ更新できない場合は、報告環境で再現しなかったAGP 8.7.2相当の既知の正常な構成へ一時的に戻す、または配布前にdexdumpで各DEXを検査する方法があります。ただし前者は全アプリ向けの公式保証ではなく、後者は不良成果物を検出するだけで原因を直しません。
R8関与の確認には一時的に縮小を無効化できます。
android {
buildTypes {
release {
isMinifyEnabled = false // 診断時のみ
}
}
}
再ビルドで偶然成功しても根本修正ではありません。恒久対応は修正版AGPへの更新です。
確認方法
- 修正版AGPで縮小済みAPKを新規生成します。
- APK Analyzerと
dexdumpでDEXを検査します。 - 再現端末へ新規インストールし、Logcatに
Failed to verify dex fileがないことを確認します。 - 同一コミットを複数回ビルドし、断続的な再発がないことを確認します。
注意点
- 後続の
ClassNotFoundExceptionだけを見てkeepルールを足しても、不正なDEX自体は直りません。 classesN.dex番号はビルドごとに変わり得ます。- AGP更新時はGradle Wrapper/JDKの互換性も確認してください。
- AABでは実際の配布経路から生成される成果物も試してください。
まとめ
Out-of-order annotation_element name_idxはソース内の注釈順序ではなく、R8が生成したDEXの構造エラーです。AGP 9.3.3または9.4.1以上へ更新し、縮小済み成果物を再生成・検証してください。
