前言
起因:專案使用的一直是multidex:1.0.3版本就想著版本低了要不要升級一下,驚喜就這么來了,
65536
當你的應用及其參考的庫超過 65,536 個方法時,你會遇到構建錯誤,表明你的應用已達到 Android 構建架構的限制:
trouble writing output:
Too many field references: 131000; max is 65536.
You may try using --multi-dex option.
舊版本的構建系統報告了不同的錯誤,這表明存在相同的問題:
Conversion to Dalvik format failed:
Unable to execute dex: method ID not in [0, 0xffff]: 65536
這兩種錯誤情況都顯示一個共同的數字:65536,這個數字表示單個 Dalvik 可執行檔案 (DEX) 位元組碼檔案中的代碼可以呼叫的參考總數,本問介紹了如何通過啟用稱為multidex的應用程式配置來克服此限制,該配置允許你的應用程式構建和讀取多個 DEX 檔案,
關于 64K 參考限制
Android 應用 APK 檔案包含 Dalvik 可執行檔案 DEX 檔案形式的可執行位元組碼檔案,其中包含用于運行應用的編譯代碼,Dalvik Executable 規范將單個 DEX 檔案中可以參考的方法總數限制為 65,536,包括 Android 框架方法、庫方法和你自己代碼中的方法,在計算機科學的背景關系中,術語Kilo, K表示 1024(或 2^10),由于 65,536 等于 64 X 1024,因此此限制稱為64K 參考限制,
解決64K限制
對 Android 5.0 及更高版本的 Multidex 支持
Android 5.0(API 級別 21)及更高版本使用稱為 ART 的運行時,該運行時本機支持從 APK 檔案加載多個 DEX 檔案, ART 在應用安裝時執行預編譯,它會掃描 classesN.dex 檔案并將它們編譯成單個 .oat 檔案以供 Android 設備執行, 因此,如果你的 minSdkVersion 為 21 或更高,則默認啟用 multidex,并且你不需要 multidex 庫,
注意: 當使用 Android Studio 運行你的應用程式時,構建會針對你部署到的目標設備進行優化, 這包括在目標設備運行 Android 5.0 及更高版本時啟用 multidex, 由于此優化僅在使用 Android Studio 部署應用程式時應用,因此你可能仍需要為 multidex 配置發布版本以避免 64K 限制,
看到沒,這里最好的解決辦法就是設定minSdkVersion設定為 21 或更高,這樣網上的一些什么
-
multidex你遇到的坑
-
multidex與你不得不說的秘密
-
multidex原理及實作就和你沒得關系了,當然你想了解也可以,
Android SDK 為 21 或更高的問題解決了,那Android SDK 低于 21 的呢,咱接著往下看嘍,
Android 5.0 之前的 Multidex 支持
為你的應用程式配置 multidex
如果你的 minSdkVersion 設定為 21 或更高,則默認啟用 multidex,你不需要 multidex 庫,
但是,如果你的 minSdkVersion 設定為 20 或更低,那么你必須使用 multidex 庫并對你的應用專案進行以下修改:
1.修改模塊級 build.gradle 檔案以啟用 multidex 并添加 multidex 庫作為依賴項,如下所示:
-
使用AndroidX
android {
defaultConfig {
...
minSdkVersion 15
targetSdkVersion 30
multiDexEnabled true
}
...
}
dependencies {
implementation "androidx.multidex:multidex:2.0.1"
}
-
不使用AndroidX(已棄用)
android {
defaultConfig {
...
minSdkVersion 15
targetSdkVersion 30
multiDexEnabled true
}
...
}
dependencies {
implementation 'com.android.support:multidex:1.0.3'
}
2.根據你是否覆寫 Application 類,執行以下操作之一:
-
如果你不覆寫 Application 類,請編輯你的清單檔案以在 < application > 標記中設定 android:name,如下所示:
<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
package="com.scc.demo">
<application
android:name="androidx.multidex.MultiDexApplication" >
...
</application>
</manifest>
-
如果你確實覆寫了 Application 類,請將其更改為擴展 MultiDexApplication(非必須),如下所示:
public class MyApplication extends MultiDexApplication { ... }
-
或者,如果你確實覆寫了 Application 類但無法更改基類,那么你可以覆寫 attachBaseContext() 方法和 callMultiDex.install(this) 以啟用 multidex:
public class MyApp extends Application {
@Override
protected void attachBaseContext(Context base) {
super.attachBaseContext(base);
MultiDex.install(this);
}
}
注意: 在 MultiDex.install() 完成之前,不要通過反射或 JNI 執行 MultiDex.install() 或任何其他代碼, Multidex 跟蹤不會跟隨這些呼叫,導致 ClassNotFoundException 或由于 DEX 檔案之間的類磁區錯誤而導致驗證錯誤,
現在,當你構建應用程式時,Android 構建工具會根據需要構建一個主要的 DEX 檔案 (classes.dex) 和支持的 DEX 檔案(classes2.dex、classes3.dex 等),構建系統然后將所有 DEX 檔案打包到你的 APK 中,
在運行時,multidex API 使用特殊的類加載器來搜索所有可用的 DEX 檔案以查找你的方法(而不是僅在主 classes.dex 檔案中搜索),
multidex 庫的限制
multidex 庫有一些已知的限制,當你將其合并到應用程式構建配置中時,你應該注意并測驗這些限制:
-
在啟動期間將 DEX 檔案安裝到設備的資料磁區上很復雜,如果輔助 DEX 檔案很大,可能會導致應用程式無回應 (ANR) 錯誤,為避免此問題,請啟用代碼收縮以最小化 DEX 檔案的大小并洗掉未使用的代碼部分,
-
在 Android 5.0(API 級別 21)之前的版本上運行時,使用 multidex 不足以解決 linearalloc 限制(問題 78035),此限制在 Android 4.0(API 級別 14)中有所增加,但這并沒有完全解決,在低于 Android 4.0 的版本上,你可能會在達到 DEX 索引限制之前達到線性分配限制,因此,如果你的目標 API 級別低于 14,請在平臺的這些版本上進行徹底測驗*,因為你的應用程式可能在啟動時或加載特定類組時出現問題,
代碼縮減可以減少或可能消除這些問題,
在主 DEX 檔案中宣告所需的類
如果你收到 java.lang.NoClassDefFoundError,那么你必須通過在構建型別中使用 multiDexKeepFile 或 multiDexKeepProguard 屬性宣告它們,根據主 DEX 檔案中的要求手動指定這些附加類, 如果某個類在 multiDexKeepFile 或 multiDexKeepProguard 檔案中匹配,則該類將添加到主 DEX 檔案中,
multiDexKeepFile 屬性
你在multiDexKeepFile其中指定的檔案應每行包含一個類,格式為com/example/MyClass.class. 例如,你可以創建一個如下所示的檔案multidex-config.txt:
com/scc/MyClass.class
com/scc/MyOtherClass.class
然后,你可以為構建型別宣告該檔案,如下所示:
android {
buildTypes {
release {
multiDexKeepFile file('multidex-config.txt')
...
}
}
}
注意: Gradle 讀取相對于build.gradle檔案的路徑,因此如果multidex-config.txt與build.gradle檔案位于同一目錄中,則上述示例有效,
multiDexKeepProguard 屬性
該multiDexKeepProguard檔案使用與 Proguard 相同的格式,并支持整個 Proguard 語法,
你在multiDexKeepProguard其中指定的檔案應包含 -keep 任何有效 ProGuard 語法中的選項,例如, -keep com.scc.MyClass.class,你可以創建一個名為的檔案 multidex-config.pro,如下所示:
-keep class com.scc.MyClass
-keep class com.scc.MyClassToo
如果要指定包中的所有類,檔案如下所示:
-keep class com.scc.** { *; } // com.scc 包中的所有類
然后,你可以為構建型別宣告該檔案,如下所示:
android {
buildTypes {
release {
multiDexKeepProguard file('multidex-config.pro')
...
}
}
}
在開發版本中優化 multidex
為了減少更長的增量構建時間,使用 pre-dexing在構建之間重用 multidex 輸出,Pre-dexing 依賴于僅在 Android 5.0(API 級別 21)及更高版本上可用的 ART 格式,如果你使用的是 Android Studio 2.3 及更高版本,則在將你的應用程式部署到運行 Android 5.0(API 級別 21)或更高版本的設備時,IDE 會自動使用此功能,
注意: 適用于 Gradle 3.0.0及更高版本的Android 插件包括進一步改進以優化構建速度,例如按類進行 dexing(以便僅對你修改的類進行重新索引),一般來說,為了獲得最佳的開發體驗,你應該始終升級到 最新版本的 Android Studio和 Android 插件,
但是,如果你從命令列運行 Gradle 構建,則需要將 minSdkVersion 設定為 21 或更高以啟用 pre-dexing,保留生產版本設定的一個有用策略是使用產品風格創建兩個版本的應用程式 :開發風格和發布風格,具有不同的值minSdkVersion,如下所示,
android {
defaultConfig {
...
multiDexEnabled true
//最低 API 級別,
minSdkVersion 15
}
productFlavors {
dev {
//(API 級別 21)或更高 .
minSdkVersion 21
}
prod {
// 如果你已經為生產版本配置了 defaultConfig 塊
// 你的應用程式,你可以將此塊留空,Gradle 會使用其中的配置
// 代替 defaultConfig 塊, 你仍然需要包括這種味道,
// 否則,所有變體都使用“dev”配置,
}
}
buildTypes {
release {
minifyEnabled true
proguardFiles getDefaultProguardFile('proguard-android.txt'),
'proguard-rules.pro'
}
}
}
dependencies {
implementation "androidx.multidex:multidex:2.0.1"
}
避免 64K 限制
在配置應用以啟用 64K 或更多方法參考之前,你應該采取措施減少應用代碼呼叫的參考總數,包括應用代碼定義的方法或包含的庫,以下策略可以幫助你避免達到 DEX 參考限制:
-
檢查你的應用程式的直接和傳遞依賴項 - 確保你在應用程式中包含的任何大型庫依賴項的使用方式都超過添加到應用程式的代碼量,一個常見的反模式是包含一個非常大的庫,因為一些實用方法是有用的,減少你的應用程式代碼依賴性通常可以幫助你避免 DEX 參考限制,
-
使用 R8 洗掉未使用的代碼 -啟用代碼收縮以運行 R8 以用于你的發布版本,啟用收縮可確保你不會隨 APK 一起發送未使用的代碼,
使用這些技術可能會幫助你避免在應用中啟用 multidex,同時還可以減少 APK 的整體大小,
以上就是本文的全部內容,希望對大家學習Android multidex有所幫助和啟發,
轉載請註明出處,本文鏈接:https://www.uj5u.com/yidong/292381.html
標籤:其他
上一篇:電賽推遲了,回家嗎?
