【解決】 Android: Dex limit exceeded の解決方法と原因 | Android/Gradle トラブルシューティング

「Android: Dex limit exceeded」エラーに直面し、お困りではないでしょうか？
ご安心ください。このエラーはAndroid開発では非常に一般的で、多くの場合、確立されたシンプルな解決策によってすぐに解消できます。
この記事では、このエラーの概要から、Windows環境で今すぐ試せる最速の解決策、そして将来的な再発を防ぐためのヒントまで、シニアエンジニアのアシスタントとして分かりやすく解説します。
結論から言うと、この問題のほとんどは「MultiDexを有効にする」ことで解決します。

1. Android: Dex limit exceeded とは？（概要と緊急度）

「Android: Dex limit exceeded」エラーは、Androidアプリケーションのビルド時に発生するエラーの一つです。
Androidアプリは、Dalvik実行可能ファイル（DEXファイル）と呼ばれる形式にコンパイルされます。このDEXファイルには、アプリが使用するすべてのメソッド（コード内の関数など）の情報が含まれています。
しかし、歴史的な理由から、一つのDEXファイルが含むことができるメソッド参照の数には上限があり、約65,536個（65K）とされています。

このエラーが発生するということは、あなたのアプリが使用するコード（あなたの書いたコードや、導入している多くのライブラリのコード）が、この65Kのメソッド上限を超えてしまったことを意味します。
具体的には、com.android.builder.dexing.DexArchiveBuilderException: Failed to process ...のようなメッセージがビルドログに出力されることが多いです。

緊急度

このエラーが発生すると、アプリケーションのビルドが完全に停止してしまいます。そのため、開発を続行するためには、すぐに解決すべき高緊急度の問題と言えます。しかし、前述の通り、解決策は明確ですのでご安心ください。

2. 【最速】今すぐ試すべき解決策

「Android: Dex limit exceeded」エラーの最も一般的で効果的な解決策は、Androidプロジェクトで「MultiDex（マルチDex）」を有効にすることです。
MultiDexは、アプリケーションが65Kのメソッド上限を超えた場合に、複数のDEXファイルを生成してこの制限を回避する仕組みです。

解決策1：[最も簡単な方法] MultiDexの有効化

以下の手順で、build.gradle (app) ファイルと AndroidManifest.xml を編集し、MultiDexを有効にしてください。

  1. build.gradle (app) ファイルを開きます。
    通常、プロジェクトのルートディレクトリの下の app/build.gradle にあります。
  2. android { ... } ブロック内に defaultConfig { ... } を探し、multiDexEnabled true を追加します。
    もし defaultConfig ブロックがない場合は、android { ... } ブロックの直下に追加します。
  3. dependencies { ... } ブロックに MultiDex ライブラリを追加します。
    プロジェクトがAndroidXを使用している場合は androidx.multidex:multidex:2.0.1 を、古いAndroid Support Libraryを使用している場合は com.android.support:multidex:1.0.3 を追加します。最新のプロジェクトではAndroidXの使用が推奨されます。
  4. AndroidManifest.xml ファイルを開き、<application> タグに android:name="androidx.multidex.MultiDexApplication" を追加します。
    もし既にカスタムの Application クラスを使用している場合は、そのクラスが androidx.multidex.MultiDexApplication を継承するように変更してください。
  5. 設定変更後、プロジェクトをクリーンして再ビルドします。
    Android Studioを使用している場合は、Gradle Syncボタンをクリックし、その後「Build > Rebuild Project」を実行します。コマンドプロンプトやPowerShellを使用している場合は、以下のコマンドを実行します。

# build.gradle (app) の編集例
# -----------------------------------------------------------------------------
# android {
#     compileSdk 34
#
#     defaultConfig {
#         applicationId "com.example.yourapp"
#         minSdkVersion 21 # minSdkVersion は21以上を推奨
#         targetSdkVersion 34
#         versionCode 1
#         versionName "1.0"
#
#         testInstrumentationRunner "androidx.test.runner.AndroidJUnitRunner"
#         multiDexEnabled true // ★ ここにこの行を追加します
#     }
#     ...
# }
#
# dependencies {
#     implementation 'androidx.appcompat:appcompat:1.6.1'
#     implementation 'com.google.android.material:material:1.10.0'
#     implementation 'androidx.constraintlayout:constraintlayout:2.1.4'
#     testImplementation 'junit:junit:4.13.2'
#     androidTestImplementation 'androidx.test.ext:junit:1.1.5'
#     androidTestImplementation 'androidx.test.espresso:espresso-core:3.5.1'
#
#     implementation 'androidx.multidex:multidex:2.0.1' // ★ ここにこの行を追加します
#     # もしAndroidXではなくSupport Libraryを使っている場合は以下のように記述
#     # implementation 'com.android.support:multidex:1.0.3'
# }
# -----------------------------------------------------------------------------


# AndroidManifest.xml の編集例
# -----------------------------------------------------------------------------
# <?xml version="1.0" encoding="utf-8"?>
# <manifest xmlns:android="http://schemas.android.com/apk/res/android">
#
#     <application
#         android:name="androidx.multidex.MultiDexApplication" // ★ ここにこの属性を追加します
#         android:allowBackup="true"
#         android:icon="@mipmap/ic_launcher"
#         android:label="@string/app_name"
#         android:roundIcon="@mipmap/ic_launcher_round"
#         android:supportsRtl="true"
#         android:theme="@style/Theme.YourApp">
#         <activity
#             android:name=".MainActivity"
#             android:exported="true">
#             <intent-filter>
#                 <action android:name="android.intent.action.MAIN" />
#                 <category android:name="android.intent.category.LAUNCHER" />
#             </intent-filter>
#         </activity>
#     </application>
#
# </manifest>
# -----------------------------------------------------------------------------


# 設定変更後、WindowsのPowerShellまたはCmdで以下のコマンドを実行して、プロジェクトをクリーンし再ビルドします。
# プロジェクトのルートディレクトリに移動してから実行してください。
.\gradlew clean build

これにより、ほとんどの場合で「Dex limit exceeded」エラーは解消し、プロジェクトが正常にビルドできるようになります。

3. Android: Dex limit exceeded が発生する主要な原因（複数）

なぜアプリのメソッド参照数が65Kを超えてしまうのでしょうか？主な原因は以下の通りです。

  • 多くのライブラリを使用している:
    Google Play Services、Firebase、複数のサードパーティ製SDK（広告SDK、解析SDKなど）といった大規模なライブラリを多数プロジェクトに組み込んでいる場合、それらのライブラリが持つメソッドの合計数が容易に上限を超えてしまいます。
  • 既存のライブラリ自体が大規模:
    個々のライブラリが非常に多くのメソッドを含んでいる場合があります。例えば、特定の機能のために導入した一つのライブラリが、その機能とは関係ない多数のメソッドも内部に持っていることがあります。
  • 古いバージョンのAndroid SDKを使用している:
    minSdkVersionが低い場合（特にAPIレベル20以下）、古いAndroidシステムではMultiDexがOSレベルでサポートされていません。この場合、MultiDexサポートライブラリを明示的に導入し、Applicationクラスで工夫をする必要があります（上記で紹介した解決策はAPIレベル21以上を推奨しています）。
  • コードベースの大規模化:
    アプリケーションの機能が豊富になり、自社で記述したコードの規模が非常に大きくなった場合も、メソッド参照数が増加します。

4. Android/Gradleで恒久的に再発を防ぐには

一度MultiDexを有効にすれば、多くの場合問題は解決しますが、プロジェクトの成長とともに再びメソッド数の上限に近づく可能性もあります。将来的な再発を防ぎ、アプリのパフォーマンスを最適化するためには、以下の対策を検討してください。

  • 不要なライブラリの削除または最適化:
    使用していないライブラリや、必要最小限の機能しか使わないのにフルセットのライブラリを導入している場合は、適切な軽量版のライブラリに切り替えることを検討してください。

    
# 例えば、Firebaseの全機能を導入する代わりに、必要な機能だけを個別に導入する
# 以下はFirebase AnalyticsとAuthのみを導入する例
# implementation 'com.google.firebase:firebase-analytics:21.3.0'
# implementation 'com.google.firebase:firebase-auth:22.2.0'
  • ProGuard/R8によるコード最適化:
    ProGuardやR8は、アプリのリリースビルド時に使用されないコード（メソッド、クラスなど）を削除し、コードを難読化してサイズを削減するツールです。これにより、Dexファイルのメソッド数も減少させることができます。
    build.gradle (app)でminifyEnabled trueを設定することで有効になります（Android Studioの新規プロジェクトではデフォルトで有効になっていることが多いです）。

    
# build.gradle (app) 内の buildTypes ブロック
android {
    ...
    buildTypes {
        release {
            minifyEnabled true      # ★ これをtrueにする (ProGuard/R8を有効化)
            shrinkResources true    # ★ 未使用のリソースも削除 (サイズ削減効果大)
            proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'
        }
    }
}
  • Gradle依存関係の分析:
    どのライブラリが多くのメソッドを占めているかを確認することで、最適化のターゲットを見つけやすくなります。以下のコマンドをPowerShellまたはCmdで実行し、依存関係ツリーを確認してください。

    
# アプリケーションモジュールの依存関係ツリーを表示
.\gradlew :app:dependencies

    出力されたログを分析し、特に多くの依存関係を持つライブラリや、予想外に大きなライブラリがないかを確認します。

  • アプリケーションのモジュール化:
    大規模なアプリケーションでは、複数のモジュールに分割することで、それぞれのモジュールが独立したDEXファイルを生成するように設計できます。これにより、個々のモジュールのDEX制限を管理しやすくなります。ただし、これはより高度なアーキテクチャ設計が必要となります。

これらの対策を講じることで、「Dex limit exceeded」エラーに悩まされることなく、スムーズなAndroid開発を続けることができるでしょう。

 

Related Posts