要盡可能減小 APK 文件，您應(yīng)該啟用壓縮來移除發(fā)布構(gòu)建中未使用的代碼和資源砂缩。

代碼壓縮通過 ProGuard 提供泵额，ProGuard 會檢測和移除封裝應(yīng)用中未使用的類迫悠、字段挟冠、方法和屬性于购，包括自帶代碼庫中的未使用項（這使其成為以變通方式解決 64k 引用限制的有用工具）。ProGuard 還可優(yōu)化字節(jié)碼知染，移除未使用的代碼指令肋僧，以及用短名稱混淆其余的類、字段和方法控淡∠臃停混淆過的代碼可令您的 APK 難以被逆向工程，這在應(yīng)用使用許可驗證等安全敏感性功能時特別有用掺炭。

資源壓縮通過適用于 Gradle 的 Android 插件提供辫诅，該插件會移除封裝應(yīng)用中未使用的資源，包括代碼庫中未使用的資源竹伸。它可與代碼壓縮發(fā)揮協(xié)同效應(yīng)泥栖，使得在移除未使用的代碼后，任何不再被引用的資源也能安全地移除勋篓。

壓縮代碼

要通過 ProGuard 啟用代碼壓縮吧享，請在 build.gradle 文件內(nèi)相應(yīng)的構(gòu)建類型中添加 minifyEnabled true

請注意，代碼壓縮會拖慢構(gòu)建速度譬嚣，因此您應(yīng)該盡可能避免在調(diào)試構(gòu)建中使用钢颂。

例如，下面這段來自 build.gradle 文件的代碼用于為發(fā)布構(gòu)建啟用代碼壓縮：

android {
    buildTypes {
        release {
            minifyEnabled true
            proguardFiles getDefaultProguardFile('proguard-android.txt'),
                    'proguard-rules.pro'
        }
    }
    ...
}

注：Android Studio 會在使用 Instant Run 時停用 ProGuard拜银。如果您需要為增量式構(gòu)建壓縮代碼殊鞭，請嘗試試用 Gradle 壓縮器。

除了 minifyEnabled 屬性外尼桶，還有用于定義 ProGuard 規(guī)則的 proguardFiles 屬性：

• getDefaultProguardFile('proguard-android.txt') 方法可從 Android SDK tools/proguard/ 文件夾獲取默認的 ProGuard 設(shè)置操灿。

  提示：要想做進一步的代碼壓縮，請嘗試使用位于同一位置的 proguard-android-optimize.txt 文件泵督。它包括相同的 ProGuard 規(guī)則趾盐，但還包括其他在字節(jié)碼一級（方法內(nèi)和方法間）執(zhí)行分析的優(yōu)化，以進一步減小 APK 大小和幫助提高其運行速度小腊。

• proguard-rules.pro 文件用于添加自定義 ProGuard 規(guī)則救鲤。默認情況下，該文件位于模塊根目錄（build.gradle 文件旁）秩冈。

要添加更多各構(gòu)建變體專用的 ProGuard 規(guī)則本缠，請在相應(yīng)的 productFlavor 代碼塊中再添加一個 proguardFiles 屬性。例如入问，以下 Gradle 文件會向 flavor2 產(chǎn)品定制添加 flavor2-rules.pro〉で拢現(xiàn)在 flavor2 使用所有三個 ProGuard 規(guī)則，因為還應(yīng)用了來自 release 代碼塊的規(guī)則芬失。

android {
    ...
    buildTypes {
        release {
            minifyEnabled true
            proguardFiles getDefaultProguardFile('proguard-android.txt'),
                   'proguard-rules.pro'
        }
    }
    productFlavors {
        flavor1 {
        }
        flavor2 {
            proguardFile 'flavor2-rules.pro'
        }
    }
}

每次構(gòu)建時 ProGuard 都會輸出下列文件：

dump.txt

說明 APK 中所有類文件的內(nèi)部結(jié)構(gòu)卷仑。

mapping.txt

提供原始與混淆過的類、方法和字段名稱之間的轉(zhuǎn)換麸折。

seeds.txt

列出未進行混淆的類和成員锡凝。

usage.txt

列出從 APK 移除的代碼。

這些文件保存在 <module-name>/build/outputs/mapping/release/ 中垢啼。

自定義要保留的代碼

對于某些情況窜锯，默認 ProGuard 配置文件 (proguard-android.txt) 足以滿足需要，ProGuard 會移除所有（并且只會移除）未使用的代碼芭析。不過锚扎，ProGuard 難以對許多情況進行正確分析，可能會移除應(yīng)用真正需要的代碼馁启。舉例來說驾孔，它可能錯誤移除代碼的情況包括：

• 當(dāng)應(yīng)用引用的類只來自 AndroidManifest.xml 文件時
• 當(dāng)應(yīng)用調(diào)用的方法來自 Java 原生接口 (JNI) 時
• 當(dāng)應(yīng)用在運行時（例如使用反射或自檢）操作代碼時

測試應(yīng)用應(yīng)該能夠發(fā)現(xiàn)因不當(dāng)移除的代碼而導(dǎo)致的錯誤芍秆，但您也可以通過查看 <module-name>/build/outputs/mapping/release/ 中保存的 usage.txt 輸出文件來檢查移除了哪些代碼。

要修正錯誤并強制 ProGuard 保留特定代碼翠勉，請在 ProGuard 配置文件中添加一行 -keep 代碼妖啥。例如：

-keep public class MyClass

或者，您可以向您想保留的代碼添加 @Keep 注解对碌。在類上添加 @Keep 可原樣保留整個類荆虱。在方法或字段上添加它可完整保留方法/字段（及其名稱）以及類名稱。請注意朽们，只有在使用注解支持庫時怀读，才能使用此注解。

在使用 -keep 選項時骑脱，有許多事項需要考慮菜枷；如需了解有關(guān)自定義配置文件的詳細信息，請閱讀 ProGuard 手冊叁丧。問題排查一章概述了您可能會在混淆代碼時遇到的其他常見問題犁跪。

解碼混淆過的堆疊追蹤

在 ProGuard 壓縮代碼后，讀取堆疊追蹤變得困難（即使并非不可行）歹袁，因為方法名稱經(jīng)過了混淆處理坷衍。幸運的是，ProGuard 每次運行時都會創(chuàng)建一個 mapping.txt 文件条舔，其中顯示了與混淆過的名稱對應(yīng)的原始類名稱枫耳、方法名稱和字段名稱。ProGuard 將該文件保存在應(yīng)用的 <module-name>/build/outputs/mapping/release/ 目錄中孟抗。

請注意迁杨，您每次使用 ProGuard 創(chuàng)建發(fā)布構(gòu)建時都會覆蓋 mapping.txt 文件，因此您每次發(fā)布新版本時都必須小心地保存一個副本凄硼。通過為每個發(fā)布構(gòu)建保留一個 mapping.txt 文件副本铅协，您就可以在用戶提交的已混淆堆疊追蹤來自舊版本應(yīng)用時對問題進行調(diào)試。

在 Google Play 上發(fā)布應(yīng)用時摊沉，您可以上傳每個 APK 版本的 mapping.txt 文件狐史。Google Play 將根據(jù)用戶報告的問題對收到的堆疊追蹤進行去混淆處理，以便您在 Google Play Developer Console 中進行檢查说墨。如需了解詳細信息骏全，請參閱幫助中心有關(guān)如何對崩潰堆疊追蹤進行去混淆處理的文章。

要自行將混淆過的堆疊追蹤轉(zhuǎn)換成可讀的堆疊追蹤尼斧，請使用 retrace 腳本（在 Windows 上為 retrace.bat姜贡；在 Mac/Linux 上為 retrace.sh）。它位于 <sdk-root>/tools/proguard/ 目錄中棺棵。該腳本利用 mapping.txt 文件和您的堆疊追蹤生成新的可讀堆疊追蹤楼咳。使用 retrace 工具的語法如下：

retrace.bat|retrace.sh [-verbose] mapping.txt [<stacktrace_file>]

例如：

retrace.bat -verbose mapping.txt obfuscated_trace.txt

如果您不指定堆疊追蹤文件熄捍，retrace 工具會從標(biāo)準(zhǔn)輸入讀取。

通過 Instant Run 啟用代碼壓縮

如果代碼壓縮在您增量構(gòu)建應(yīng)用時非常重要母怜，請嘗試適用于 Gradle 的 Android 插件內(nèi)置的試用代碼壓縮器余耽。與 ProGuard 不同，此壓縮器支持 Instant Run糙申。

您也可以使用與 ProGuard 相同的配置文件來配置 Android 插件壓縮器宾添。但是船惨，Android 插件壓縮器不會對您的代碼進行混淆處理或優(yōu)化柜裸，它只會刪除未使用的代碼。因此粱锐，您應(yīng)該僅將其用于調(diào)試構(gòu)建疙挺，并為發(fā)布構(gòu)建啟用 ProGuard，以便對發(fā)布 APK 的代碼進行混淆處理和優(yōu)化怜浅。

要啟用 Android 插件壓縮器铐然，只需在 "debug" 構(gòu)建類型中將 useProguard 設(shè)置為 false（并保留 minifyEnabled 設(shè)置 true）：

android {
    buildTypes {
        debug {
            minifyEnabled true
            useProguard false
            proguardFiles getDefaultProguardFile('proguard-android.txt'),
                    'proguard-rules.pro'
        }
        release {
            minifyEnabled true
            proguardFiles getDefaultProguardFile('proguard-android.txt'),
                    'proguard-rules.pro'
        }
    }
}

注：如果 Android 插件壓縮器最初刪除了某個方法，但您之后更改了代碼恶座，使該方法可訪問搀暑，Instant Run 會將其視為結(jié)構(gòu)代碼更改并執(zhí)行冷交換。

壓縮資源

資源壓縮只與代碼壓縮協(xié)同工作跨琳。代碼壓縮器移除所有未使用的代碼后自点，資源壓縮器便可確定應(yīng)用仍然使用的資源。這在您添加包含資源的代碼庫時體現(xiàn)得尤為明顯 - 您必須移除未使用的庫代碼脉让，使庫資源變?yōu)槲匆觅Y源桂敛，才能通過資源壓縮器將它們移除。

要啟用資源壓縮溅潜，請在 build.gradle 文件中將 shrinkResources 屬性設(shè)置為 true（在用于代碼壓縮的 minifyEnabled 旁邊）术唬。例如：

android {
    ...
    buildTypes {
        release {
            shrinkResources true
            minifyEnabled true
            proguardFiles getDefaultProguardFile('proguard-android.txt'),
                    'proguard-rules.pro'
        }
    }
}

如果您尚未使用代碼壓縮用途的 minifyEnabled 構(gòu)建應(yīng)用，請先嘗試使用它滚澜，然后再啟用 shrinkResources粗仓，因為您可能需要編輯 proguard-rules.pro 文件以保留動態(tài)創(chuàng)建或調(diào)用的類或方法，然后再開始移除資源设捐。

注：資源壓縮器目前不會移除 values/ 文件夾中定義的資源（例如字符串潦牛、尺寸、樣式和顏色）挡育。這是因為 Android 資源打包工具 (AAPT) 不允許 Gradle 插件為資源指定預(yù)定義版本巴碗。

自定義要保留的資源

如果您有想要保留或舍棄的特定資源，請在您的項目中創(chuàng)建一個包含 <resources> 標(biāo)記的 XML 文件即寒，并在 tools:keep 屬性中指定每個要保留的資源橡淆，在 tools:discard 屬性中指定每個要舍棄的資源召噩。這兩個屬性都接受逗號分隔的資源名稱列表。您可以使用星號字符作為通配符逸爵。

<?xml version="1.0" encoding="utf-8"?>
<resources xmlns:tools="http://schemas.android.com/tools"
    tools:keep="@layout/l_used*_c,@layout/l_used_a,@layout/l_used_b*"
    tools:discard="@layout/unused2" />

將該文件保存在項目資源中具滴，例如，保存在 res/raw/keep.xml师倔。構(gòu)建不會將該文件打包到 APK 之中构韵。

指定要舍棄的資源可能看似愚蠢，因為您本可將它們刪除趋艘，但在使用構(gòu)建變體時疲恢，這樣做可能很有用。例如瓷胧，如果您明知給定資源表面上會在代碼中使用（并因此不會被壓縮器移除）显拳，但實際不會用于給定構(gòu)建變體，就可以將所有資源放入公用項目目錄搓萧，然后為每個構(gòu)建變體創(chuàng)建一個不同的 keep.xml 文件杂数。構(gòu)建工具也可能無法根據(jù)需要正確識別資源，這是因為編譯器會添加內(nèi)聯(lián)資源 ID瘸洛，而資源分析器可能不知道真正引用的資源和恰巧具有相同值的代碼中的整數(shù)值之間的差別揍移。

啟用嚴格引用檢查

正常情況下，資源壓縮器可準(zhǔn)確判定系統(tǒng)是否使用了資源反肋。不過那伐，如果您的代碼調(diào)用 Resources.getIdentifier()（或您的任何庫進行了這一調(diào)用 - AppCompat 庫會執(zhí)行該調(diào)用），這就表示您的代碼將根據(jù)動態(tài)生成的字符串查詢資源名稱囚玫。當(dāng)您執(zhí)行這一調(diào)用時喧锦，默認情況下資源壓縮器會采取防御性行為，將所有具有匹配名稱格式的資源標(biāo)記為可能已使用抓督，無法移除燃少。

例如，以下代碼會使所有帶 img_ 前綴的資源標(biāo)記為已使用铃在。

String name = String.format("img_%1d", angle + 1);
res = getResources().getIdentifier(name, "drawable", getPackageName());

資源壓縮器還會瀏覽代碼以及各種 res/raw/ 資源中的所有字符串常量阵具，尋找格式類似于 file:///android_res/drawable//ic_plus_anim_016.png 的資源網(wǎng)址。如果它找到與其類似的字符串定铜，或找到其他看似可用來構(gòu)建與其類似的網(wǎng)址的字符串阳液，則不會將它們移除。

這些是默認情況下啟用的安全壓縮模式的示例揣炕。但您可以停用這一“有備無患”處理方式帘皿，并指定資源壓縮器只保留其確定已使用的資源。要執(zhí)行此操作畸陡，請在 keep.xml 文件中將 shrinkMode 設(shè)置為 strict鹰溜，如下

<?xml version="1.0" encoding="utf-8"?>
<resources xmlns:tools="http://schemas.android.com/tools"
    tools:shrinkMode="strict" />

如果您確已啟用嚴格壓縮模式虽填，并且代碼也引用了包含動態(tài)生成字符串的資源（如上所示），則必須利用 tools:keep 屬性手動保留這些資源曹动。

移除未使用的備用資源

Gradle 資源壓縮器只會移除未被您的應(yīng)用代碼引用的資源斋日，這意味著它不會移除用于不同設(shè)備配置的備用資源。必要時墓陈，您可以使用 Android Gradle 插件的 resConfigs 屬性來移除您的應(yīng)用不需要的備用資源文件恶守。

例如，如果您使用的庫包含語言資源（例如使用的是 AppCompat 或 Google Play 服務(wù)）贡必，則 APK 將包括這些庫中消息的所有已翻譯語言字符串兔港，無論應(yīng)用的其余部分是否翻譯為同一語言。如果您想只保留應(yīng)用正式支持的語言赊级，則可以利用 resConfig 屬性指定這些語言押框。系統(tǒng)會移除未指定語言的所有資源岔绸。

下面這段代碼展示了如何將語言資源限定為僅支持英語和法語：

android {
    defaultConfig {
        ...
        resConfigs "en", "fr"
    }
}

同理理逊，您也可以利用 APK 拆分為不同設(shè)備構(gòu)建不同的 APK，自定義在 APK 中包括的屏幕密度或 ABI 資源盒揉。

合并重復(fù)資源

默認情況下晋被，Gradle 還會合并同名資源，例如可能位于不同資源文件夾中的同名可繪制對象刚盈。這一行為不受 shrinkResources 屬性控制羡洛，也無法停用，因為在有多個資源匹配代碼查詢的名稱時藕漱，有必要利用這一行為來避免錯誤欲侮。

只有在兩個或更多個文件具有完全相同的資源名稱、類型和限定符時肋联，才會進行資源合并威蕉。Gradle 會在重復(fù)項中選擇其視為最佳選擇的文件（根據(jù)下述優(yōu)先順序），并只將這一個資源傳遞給 AAPT橄仍，以供在 APK 文件中分發(fā)韧涨。

Gradle 會在下列位置尋找重復(fù)資源：

• 與主源集關(guān)聯(lián)的主資源，一般位于 src/main/res/ 中侮繁。
• 變體疊加虑粥，來自構(gòu)建類型和構(gòu)建風(fēng)味。
• 庫項目依賴項宪哩。

Gradle 會按以下級聯(lián)優(yōu)先順序合并重復(fù)資源：

依賴項 → 主資源 → 構(gòu)建風(fēng)味 → 構(gòu)建類型

例如娩贷，如果某個重復(fù)資源同時出現(xiàn)在主資源和構(gòu)建風(fēng)味中，Gradle 會選擇構(gòu)建風(fēng)味中的重復(fù)資源锁孟。

如果完全相同的資源出現(xiàn)在同一源集中彬祖，Gradle 無法合并它們但荤，并且會發(fā)出資源合并錯誤。如果您在 build.gradle 文件的 sourceSet 屬性中定義了多個源集涧至，則可能會發(fā)生這種情況腹躁，例如，如果 src/main/res/ 和 src/main/res2/ 包含完全相同的資源南蓬，就可能會發(fā)生這種情況纺非。

排查資源壓縮問題

當(dāng)您壓縮資源時，Gradle Console 會顯示它從應(yīng)用軟件包中移除的資源的摘要赘方。例如：

:android:shrinkDebugResources
Removed unused resources: Binary resource data reduced from 2570KB to 1711KB: Removed 33%
:android:validateDebugSigning

Gradle 還會在 <module-name>/build/outputs/mapping/release/（ProGuard 輸出文件所在的文件夾）中創(chuàng)建一個名為 resources.txt 的診斷文件烧颖。該文件包括諸如哪些資源引用了其他資源以及使用或移除了哪些資源等詳情。

例如窄陡，要了解您的 APK 為何仍包含 @drawable/ic_plus_anim_016炕淮，請打開 resources.txt 文件并搜索該文件名。您可能會發(fā)現(xiàn)跳夭，有其他資源引用了它涂圆，如下所示：

16:25:48.005 [QUIET] [system.out] @drawable/add_schedule_fab_icon_anim : reachable=true
16:25:48.009 [QUIET] [system.out]     @drawable/ic_plus_anim_016

現(xiàn)在您需要了解為何 @drawable/add_schedule_fab_icon_anim 可以訪問 - 如果您向上搜索，就會發(fā)現(xiàn)“The root reachable resources are:”之下列有該資源币叹。這意味著存在對 add_schedule_fab_icon_anim 的代碼引用（即在可訪問代碼中找到了其 R.drawable ID）润歉。

如果您使用的不是嚴格檢查，則存在看似可用于為動態(tài)加載資源構(gòu)建資源名稱的字符串常量時颈抚，可將資源 ID 標(biāo)記為可訪問踩衩。在這種情況下，如果您在構(gòu)建輸出中搜索資源名稱贩汉，可能會找到類似下面這樣的消息：

10:32:50.590 [QUIET] [system.out] Marking drawable:ic_plus_anim_016:2130837506
    used because it format-string matches string pool constant ic_plus_anim_%1$d.

如果您看到一個這樣的字符串驱富，并且您能確定該字符串未用于動態(tài)加載給定資源，就可以按照有關(guān)如何自定義要保留的資源部分中所述利用 tools:discard 屬性通知構(gòu)建系統(tǒng)將它移除匹舞。