[Android]Android 64k問題を回避するための設定方法(Cannot fit requested classes in a single dex file / Too many field references)

Androidアプリは、ビルドシステムの都合により、メソッド数が65536（64k=64☓1024）を超えるとビルドできないという制約があり、「64k問題」と呼ばれたりしています。

ですので、メソッド数が65536を超えるアプリをビルドすると、

こんなエラーとか

Cannot fit requested classes in a single dex file. Try supplying a main-dex list.
# methods: 68029 > 65536

こんなエラーが出て、ビルドが止まってしまいます。

trouble writing output:
Too many field references: 131000; max is 65536.
You may try using --multi-dex option.

 

この「65536」という数字は、自分が作ったメソッドだけではなくて、Androidのフレームワークや使っている外部のライブラリとかを全部含むので、意外と超える可能性のある数字です。

もちろん、ライブラリの見直しなどを行って、メソッド数を減らすという手段を取るのが常道ではありますが、メソッド数が65536を超えてもビルドを回せるように予め設定しておきたい場合の対処法の説明です。

（最初から複数のdexファイルが使えるように設定をしておくということです）

 

１．モジュール レベル（アプリケーションレベル）の build.gradle ファイルで multiDexEnabled を trueに

android {
    defaultConfig {
        ...
        minSdkVersion 21 
        targetSdkVersion 26
        multiDexEnabled true　←　コレ
    }
    ...
}

 

２．minSdkVersion を 20 以下に設定している場合は、Multidex サポート ライブラリを依存関係に追加

android {
    defaultConfig {
        ...
        minSdkVersion 15 
        targetSdkVersion 26
        multiDexEnabled true
    }
    ...
}

dependencies {
  compile 'com.android.support:multidex:1.0.3'　←　コレ
}

 

３．MultiDexの初期化

１．Applicationクラスを継承したクラスを使っていない場合

アプリ内でApplicationクラスを継承したクラスを使っていない場合は、マニフェストファイルの<application>タグ内に、以下の編集を行います（最初に起動するクラスをMultiDexApplicationクラスにする）

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    package="com.example.myapp">
    <application
            android:name="android.support.multidex.MultiDexApplication" >　←　コレ
        ...
    </application>
</manifest>

 

２．Applicationクラスを継承したクラスを使っている場合

Java/Kotlinではクラスの継承は１つしかできないので、自作ApplicationクラスのattachBaseContext()メソッド内で、Multidexを有効にする

public class MyApplication extends Application {
  @Override
  protected void attachBaseContext(Context base) {
     super.attachBaseContext(base);
     MultiDex.install(this);　←　コレ
  }
}

 

これで、最初から複数のdexファイルが使えるように設定できたので、メソッド数が65536を超えても、ビルドがちゃんと回ってくれるようになります。

（下の動画で詳しく説明していますので、よろしければご覧ください）