PC パソコン

Android Studio「Out-of-order annotation_element name_idx」の解決方法【R8・AGP 9.4.1】

同じソースから作った縮小済み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では修正済みと公式に掲載されています。

推奨する解決手順

  1. ルートのビルドスクリプトまたはVersion CatalogでAGP版を確認します。
  2. 9.3系は9.3.3以上、9.4系は9.4.1以上へ更新します。
  3. 選んだAGPに対応するGradle/JDKへ揃えます。AGP 9.3の公式互換表はGradle 9.5.0、JDK 17です。
  4. 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への更新です。

確認方法

  1. 修正版AGPで縮小済みAPKを新規生成します。
  2. APK AnalyzerとdexdumpでDEXを検査します。
  3. 再現端末へ新規インストールし、LogcatにFailed to verify dex fileがないことを確認します。
  4. 同一コミットを複数回ビルドし、断続的な再発がないことを確認します。

注意点

  • 後続の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以上へ更新し、縮小済み成果物を再生成・検証してください。

参照した公式情報