随着你的App不断更新,添加功能引入更多的第三方库,Android 应用的大小将不断增加。当应用及其引用的内容库超过特定大小(65536)时,构建时将会报错,错误的内容可能是这样的:
Conversion to Dalvik format failed:
Unable to execute dex: method ID not in [0, 0xffff]: 65536
如果是较新版本的 Android 构建系统虽然显示的错误不同,但指示的是同一问题:
trouble writing output:
Too many field references: 131000; max is 65536.
You may try using --multi-dex option.
这些错误都会包含65,536这个数字,它代表的是单个 Dalvik Executable (dex) 字节码文件内的代码可调用的引用总数。
如果你构建的 Android 应用出现了这个错误,那么可能代表你的App功能很多或者引入了很多第三方的库。
下面就介绍如何在不改变当前代码的情况下越过这一限制。
官方对于64K限制的解释:
Android 应用 (APK) 文件包含 Dalvik Executable (DEX) 文件形式的可执行字节码文件,其中包含用来运行您的应用的已编译代码。
Dalvik Executable 规范将可在单个 DEX 文件内可引用的方法总数限制在 65,536,其中包括 Android 框架方法、内容库方法
以及您自己代码中的方法。 65,536即 64 X 1024,因此这一限制也称为“64K 引用限制”。
如果想突破这种限制,那就需要配置生成多个 DEX 文件,这种配置称为 Dalvik 可执行文件分包配置。
当你希望APP运行在Android5.0之前的设备上,即你的build.gradle中的配置minSdkVersion 20 这里的数字小于21,需要进行Dex分包配置,你需要引入一个Dalvik可执行文件分包支持库:com.android.support:multidex:1.0.1,这个支持库将完成对Dex文件的管理功能。因为Android5.0之前(API 级别 21)之前的平台版本使用 Dalvik 运行时来执行应用代码。默认情况下,Dalvik 限制应用的每个 APK 只能使用单个 classes.dex 字节码文件。
而当你的App运行环境是Android 5.0(API 级别 21)及更高版本使用 ART 运行时,原生支持从 APK 文件加载多个 dex 文件。ART 在应用安装时执行预编译,扫描 classes(..N).dex 文件,并将它们编译成单个 .oat 文件,供 Android 设备执行。
下面开始进行多Dex支持的配置过程:
1. 确保你的Android SDK Build Tools 21.1大于等于这个版本,尽可能更新到最新版
2. 在的你的app下的build.gradle文件中启用分包配置,multiDexEnabled true
android {
compileSdkVersion 21
buildToolsVersion "21.1.0"
defaultConfig {
minSdkVersion 14
targetSdkVersion 21
// Enabling multidex support.
multiDexEnabled true
}
}
dependencies {
compile 'com.android.support:multidex:1.0.1'
}
- 在AndroidManifest文件中添加MultiDexApplication 类到Application元素节点
<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
package="com.example.android.multidex.myapplication">
<application
...
android:name="android.support.multidex.MultiDexApplication">
...
</application>
</manifest>
如果你有自定义的继承Application的实现类,那么这里就需要添加你自己实现的Application类,然后你自定义的Application类还需要继承MultiDexApplication,并在attachBaseContext方法中添加MultiDex.install(this);
public class BsApplication extends MultiDexApplication {
protected void attachBaseContext(Context base) {
super.attachBaseContext(base);
MultiDex.install(this);
}
@Override
public void onCreate() {
super.onCreate();
//Your init code
}
}
至此就完成了对于超过64K方法APP的分包配置,现在就可以正常编译了。
但是,Dalvik 可执行文件分包配置大幅增加构建处理时间,因为构建系统必须就哪些类必须包括在主 DEX 文件中以及哪些类可以包括在辅助 DEX 文件中作出复杂的决策。这意味着作为 Dalvik 可执行文件分包开发流程的一部分执行的例行构建通常耗时更长,可能会拖慢开发进度。
目前来说你可以通过使用Android plugin for Gradle productFlavors 构建输出开发版和发布版。将开发版的minSdkVersion设置为21,这样使用ART进行分包可提高构建速度,当要发布正式版是则使用实际的minSdkVersion进行构建,但构建时间会更长。
android {
productFlavors {
// Define separate dev and prod product flavors.
dev {
// dev utilizes minSDKVersion = 21 to allow the Android gradle plugin
// to pre-dex each module and produce an APK that can be tested on
// Android Lollipop without time consuming dex merging processes.
minSdkVersion 21
}
prod {
// The actual minSdkVersion for the application.
minSdkVersion 14
}
}
...
buildTypes {
release {
runProguard true
proguardFiles getDefaultProguardFile('proguard-android.txt'),
'proguard-rules.pro'
}
}
}
dependencies {
compile 'com.android.support:multidex:1.0.0'
}
其实最主要的还是要减少工程中的方法数,减少APP中第三方库的使用,特别是方法特别多的库。下一篇文章将讲述通过使用ProGuard压缩代码和资源的方式来避免64K的问题。