縮減、模糊處理及最佳化應用程式

如要盡可能提高應用程式的大小和速度，請使用 isMinifyEnabled = true 將發布子版本最佳化及壓縮。

這樣做會啟用「縮減」，藉此移除未使用的程式碼和資源；「模糊處理」會縮短應用程式類別和成員的名稱；「最佳化」則採取更積極的策略，進一步縮減應用程式大小並提升應用程式效能。本頁將說明 R8 如何為專案執行這些編譯時間工作，以及如何自訂這類工作。

使用 Android Gradle 外掛程式 3.4.0 以上版本建構專案時，這個外掛程式將不再使用 ProGuard 執行編譯時間程式碼最佳化作業。不過，外掛程式會與 R8 編譯器搭配運作，以處理下列編譯時間工作：

• 程式碼縮減 (或搖樹)：偵測並安全地從應用程式及其程式庫依附元件中移除未使用的類別、欄位、方法和屬性 (使其成為解決 64k 參照上限的寶貴工具)。例如，如果您只使用程式庫依附元件中的幾個 API，則縮減可以識別應用程式未使用的程式庫程式碼，並僅從應用程式中刪除該程式碼。詳情請參閱如何縮減程式碼。
• 資源縮減：從封裝應用程式中移除未使用的資源，包括應用程式程式庫依附元件中未使用的資源。這個程式碼會與程式碼縮減的方式搭配使用，這樣只要移除未使用的程式碼，所有參照的資源都能安全移除。詳情請參閱如何縮減資源一節。
• 最佳化：檢查及重新編寫程式碼，以提高執行階段效能，並進一步縮減應用程式 DEX 檔案的大小。這麼做可將程式碼的執行階段效能提升最多 30%，大幅改善啟動和影格時間。例如，如果 R8 偵測到特定 if/else 陳述式的 else {} 分支從未被擷取，R8 就會移除 else {} 分支版本的程式碼。詳情請參閱程式碼最佳化一節。
• 模糊處理 (或 ID 壓縮)：可縮短類別和成員的名稱，進而縮減 DEX 檔案大小。詳情請參閱「如何對程式碼進行模糊處理」一節。

建構應用程式的發布版本時，R8 可以設定成執行上述編譯時間工作。您也可以透過 ProGuard 規則檔案停用特定工作或自訂 R8 的行為。事實上，R8 適用於所有現有的 ProGuard 規則檔案，因此更新 Android Gradle 外掛程式並不需要變更現有規則。

啟用縮減、模糊處理和最佳化功能

使用 Android Studio 3.4 或 Android Gradle 外掛程式 3.4.0 以上版本時，R8 是預設編譯器，可將專案的 Java 位元碼轉換為在 Android 平台上執行的 DEX 格式。不過，當您使用 Android Studio 建立新專案時，系統預設會啟用縮減、模糊化和程式碼最佳化功能。這是因為這些編譯時間最佳化可增加專案的建構時間，如果您未充分自訂要保留的程式碼，可能會導致錯誤。

因此，建議您在建構最終的應用程式版本時，啟用這些編譯時間工作，再進行發布。如要啟用縮減、模糊處理和最佳化的功能，請在專案層級建構指令碼中加入以下內容。

android {
    buildTypes {
        getByName("release") {
            // Enables code shrinking, obfuscation, and optimization for only
            // your project's release build type. Make sure to use a build
            // variant with `isDebuggable=false`.
            isMinifyEnabled = true

            // Enables resource shrinking, which is performed by the
            // Android Gradle plugin.
            isShrinkResources = true

            proguardFiles(
                // Includes the default ProGuard rules files that are packaged with
                // the Android Gradle plugin. To learn more, go to the section about
                // R8 configuration files.
                getDefaultProguardFile("proguard-android-optimize.txt"),

                // Includes a local, custom Proguard rules file
                "proguard-rules.pro"
            )
        }
    }
    ...
}

android {
    buildTypes {
        release {
            // Enables code shrinking, obfuscation, and optimization for only
            // your project's release build type. Make sure to use a build
            // variant with `debuggable false`.
            minifyEnabled true

            // Enables resource shrinking, which is performed by the
            // Android Gradle plugin.
            shrinkResources true

            // Includes the default ProGuard rules files that are packaged with
            // the Android Gradle plugin. To learn more, go to the section about
            // R8 configuration files.
            proguardFiles getDefaultProguardFile(
                    'proguard-android-optimize.txt'),
                    'proguard-rules.pro'
        }
    }
    ...
}

R8 設定檔

R8 會使用 ProGuard 規則檔案修改預設行為，並進一步瞭解應用程式的結構，例如做為應用程式程式碼進入點的類別。雖然您可以修改部分規則檔案，但部分規則可能是由編譯時間工具 (例如 AAPT2) 或從應用程式的程式庫依附元件沿用而來。下表說明 R8 使用的 ProGuard 規則檔案來源。

將 minifyEnabled 屬性設為 true 時，R8 會結合上述所有可用來源的規則。請注意使用 R8 進行疑難排解時，由於其他編譯時間依附元件 (例如程式庫依附元件) 可能導致您無法對 R8 行為進行任何變更。

如要輸出 R8 建構您的專案適用的所有規則，請在模組的 proguard-rules.pro 檔案中加入下列內容：

// You can specify any path and filename.
-printconfiguration ~/tmp/full-r8-config.txt

新增其他設定

使用 Android Studio 建立新專案或模組時，IDE 會建立 <module-dir>/proguard-rules.pro 檔案，以納入自己的規則。您也可以在模組建構指令碼的 proguardFiles 屬性中加入其他規則，以納入其他檔案的其他規則。

例如，您可以在對應的 productFlavor 區塊中加入另一個 proguardFiles 屬性，以新增特定於每個建構變化版本的規則。下列 Gradle 檔案會新增 flavor2-rules.pro 至 flavor2 變種版本。現在 flavor2 會使用三個 ProGuard 規則，因為系統會套用 release 區塊中的規則。

此外，您也可以新增 testProguardFiles 屬性，指定僅包含在測試 APK 中的 ProGuard 檔案清單：

android {
    ...
    buildTypes {
        getByName("release") {
            isMinifyEnabled = true
            proguardFiles(
                getDefaultProguardFile("proguard-android-optimize.txt"),
                // List additional ProGuard rules for the given build type here. By default,
                // Android Studio creates and includes an empty rules file for you (located
                // at the root directory of each module).
                "proguard-rules.pro"
            )
            testProguardFiles(
                // The proguard files listed here are included in the
                // test APK only.
                "test-proguard-rules.pro"
            )
        }
    }
    flavorDimensions.add("version")
    productFlavors {
        create("flavor1") {
            ...
        }
        create("flavor2") {
            proguardFile("flavor2-rules.pro")
        }
    }
}

android {
    ...
    buildTypes {
        release {
            minifyEnabled true
            proguardFiles
                getDefaultProguardFile('proguard-android-optimize.txt'),
                // List additional ProGuard rules for the given build type here. By default,
                // Android Studio creates and includes an empty rules file for you (located
                // at the root directory of each module).
                'proguard-rules.pro'
            testProguardFiles
                // The proguard files listed here are included in the
                // test APK only.
                'test-proguard-rules.pro'
        }
    }
    flavorDimensions "version"
    productFlavors {
        flavor1 {
            ...
        }
        flavor2 {
            proguardFile 'flavor2-rules.pro'
        }
    }
}

縮減程式碼

在預設情況下，如果您將 minifyEnabled 屬性設為 true，即可啟用使用 R8 的程式碼縮減。

程式碼縮減 (也稱為搖樹) 是指移除執行階段不需要 R8 判定的程式碼的程序。例如，如果您的應用程式含有許多程式庫依附元件，但僅使用了一小部分功能，那麼這項程序可以大幅縮減應用程式的大小。

如要縮減應用程式的程式碼，R8 會先根據合併的設定檔組合判定應用程式程式碼中的所有進入點。這些進入點包括 Android 平台用於開啟應用程式活動或服務的所有類別。從每個進入點開始，R8 會檢查應用程式的程式碼，以建構應用程式在執行階段中可能存取的所有方法、成員變數和其他類別。未連接至該圖表的程式碼會被視為無法連上，且可能會從應用程式中移除。

圖 1 顯示執行階段程式庫依附元件的應用程式。在檢查應用程式的程式碼時，R8 判定可從 MainActivity.class 進入點連線至 foo()、faz() 和 bar() 方法。不過，應用程式從未在執行階段使用 OkayApi.class 類別或 baz() 方法，而且在縮減應用程式時，R8 則會移除該程式碼。

圖 1. 在編譯期間，R8 會根據專案的合併保留規則建構圖形，判斷無法存取的程式碼。

R8 會在專案的 R8 設定檔中，透過 -keep 規則決定進入點。也就是說，保留規則指定 R8 縮減應用程式時不應捨棄的類別，且 R8 會將這些類別視為應用程式的可能進入點。Android Gradle 外掛程式和 AAPT2 會自動產生大多數應用程式專案所需的保留規則，例如應用程式的活動、檢視畫面和服務。不過，如果您需要用額外的保留規則來自訂此預設行為，請參閱自訂要保留的程式碼一節。

如果您只是想縮減應用程式資源的大小，請直接閱讀「如何縮減資源」一節。

請注意，如果程式庫專案遭到縮減，則仰賴該程式庫的應用程式會包含縮減程式庫類別。如果程式庫 APK 中缺少類別，您可能需要調整程式庫保留規則。如果要以 AAR 格式建構並發布程式庫，程式庫的本機 JAR 檔案會依附於 AAR 檔案中「縮減」。

自訂要保留的程式碼

在大多數情況下，預設的 ProGuard 規則檔案 (proguard-android- optimize.txt) 足以讓 R8 移除未使用的程式碼。不過，在某些情況下，R8 可能無法正確分析，而且可能會移除應用程式的實際程式碼。以下列舉一些錯誤移除程式碼的範例：

• 應用程式從 Java Native Interface (JNI) 呼叫方法時
• 應用程式在執行階段查詢程式碼 (例如使用反射)

測試應用程式應能找出因不當移除程式碼而引發的任何錯誤，但您也可以產生已移除的程式碼報表，檢查已移除的程式碼。

如要修正錯誤並強制 R8 保留特定程式碼，請在 ProGuard 規則檔案中加入 -keep 程式碼行。舉例來說：

-keep public class MyClass

或者，您也可以在想保留的程式碼中加入 @Keep 註解。在類別中新增 @Keep 後，整個類別都會保持原樣；在方法或欄位中新增該類別時，方法/欄位 (及其名稱) 和類別名稱都會完整保留。請注意，只有使用 AndroidX 註解程式庫，且加入已隨附於 Android Gradle 外掛程式的 ProGuard 規則檔案時，您才能使用該註解，例如相關說明請參閱啟用縮減功能一節。

使用 -keep 選項時，您需要考量許多因素；如要進一步瞭解如何自訂規則檔案，請參閱 ProGuard 手冊。疑難排解部分概略說明程式碼移除時可能會遇到的其他常見問題。

刪除原生資料庫

根據預設，系統會在應用程式的發布子版本中去除原生程式碼程式庫。這項移除作業包括移除應用程式使用的任何原生資料庫中的符號表格和偵錯資訊。移除原生程式碼程式庫可大幅縮減大小；然而，由於缺少資訊 (例如類別和函式名稱)，Google Play 管理中心無法診斷當機情形。

原生程式碼支援

Google Play 管理中心會報告 Android Vitals 下方的原生程式碼發生錯誤事件。只需執行幾個步驟，即可為應用程式產生並上傳原生偵錯符號檔案。這個檔案可在 Android Vitals 中啟用符號化的原生當機堆疊追蹤 (包括類別和函式名稱)，協助您在實際工作環境中對應用程式進行偵錯。這些步驟取決於專案中使用的 Android Gradle 外掛程式版本，以及專案的建構輸出內容。

Android Gradle 外掛程式 4.1 以上版本

如果您在專案中建構 Android App Bundle，可以自動加入原生偵錯符號檔。如要在發布版本中加入這個檔案，請將以下內容新增至應用程式的 build.gradle.kts 檔案：

android.buildTypes.release.ndk.debugSymbolLevel = { SYMBOL_TABLE | FULL }

請從下列清單中選取偵錯符號級別：

• 使用 SYMBOL_TABLE 取得 Play 管理中心符號化堆疊追蹤中的函式名稱。這個級別支援「空值標記」。
• 使用 FULL 在 Play 管理中心的符號化堆疊追蹤中取得函式名稱、檔案和行數。

如果您在專案中建構 APK，請使用先前顯示的 build.gradle.kts 建構設定，分別產生原生偵錯符號檔案。手動將原生偵錯符號檔案上傳至 Google Play 管理中心。在建構程序中，Android Gradle 外掛程式會在下列專案位置輸出這個檔案：

app/build/outputs/native-debug-symbols/variant-name/native-debug-symbols.zip

Android Gradle 外掛程式 4.0 以下版本 (以及其他建構系統)

在建構程序中，Android Gradle 外掛程式會在專案目錄中保留未移除的程式庫副本。這個目錄結構與下列內容相似：

app/build/intermediates/cmake/universal/release/obj/
├── armeabi-v7a/
│   ├── libgameengine.so
│   ├── libothercode.so
│   └── libvideocodec.so
├── arm64-v8a/
│   ├── libgameengine.so
│   ├── libothercode.so
│   └── libvideocodec.so
├── x86/
│   ├── libgameengine.so
│   ├── libothercode.so
│   └── libvideocodec.so
└── x86_64/
    ├── libgameengine.so
    ├── libothercode.so
    └── libvideocodec.so

1. 壓縮以下目錄的內容：

   cd app/build/intermediates/cmake/universal/release/obj
   zip -r symbols.zip .
   

2. 手動上傳 symbols.zip 檔案至 Google Play 管理中心。

縮減資源

資源縮減功能僅適用於程式碼縮減。程式碼縮減器移除所有未使用的程式碼後，資源縮減器就能識別應用程式仍在使用的資源。如果您新增包含資源的程式碼庫，這個方法就更顯而易見。您必須移除未使用的程式庫程式碼，如此才能避免程式庫資源參照，進而由資源縮減器移除。

如要啟用資源縮減功能，請在建構指令碼中將 shrinkResources 屬性設為 true (以及用於程式碼縮減的 minifyEnabled)。舉例來說：

android {
    ...
    buildTypes {
        getByName("release") {
            isShrinkResources = true
            isMinifyEnabled = true
            proguardFiles(
                getDefaultProguardFile("proguard-android.txt"),
                "proguard-rules.pro"
            )
        }
    }
}

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

如果您尚未使用 minifyEnabled 建構應用程式來縮減程式碼，請先啟用 shrinkResources，因為您可能需要編輯 proguard-rules.pro 檔案才能保留在開始移除資源之前動態建立或叫用的類別或方法。

自訂要保留的資源

如要保留或捨棄特定資源，請在專案中使用建立帶有 <resources> 標記的 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 中。建構作業不會將這個檔案封裝至應用程式中。

指定應捨棄的資源似乎毫無用處，因為您可以進行刪除，但這在建構變化版本中很實用。舉例來說，您可以將所有資源放入通用專案目錄，然後如果您知道程式碼中正在使用特定資源 (而非由縮減器移除)，為每個建構變化版本建立不同的 keep.xml 檔案，但您確定該資源實際上不會用於指定的建構變化版本。另一個可能的原因是，編譯器會視需要以內嵌方式新增資源 ID，而資源分析器可能無法得知實際參照資源與程式碼中整數值之間的差異，但程式碼中卻有相同的值。

啟用嚴格參考資料檢查功能

一般而言，資源縮減器能夠準確判斷資源是否被使用。不過，如果您的程式碼會呼叫 Resources.getIdentifier() (或是您的任何程式庫，則使用 AppCompat 程式庫)，代表您的程式碼是根據動態產生的字串查詢資源名稱。這樣做時，資源縮減器預設會穩定運作，並將所有具有相符名稱格式的資源標示為可能使用且無法移除。

例如，下列程式碼會讓所有具有 img_ 前置字串的資源標示為使用中。

val name = String.format("img_%1d", angle + 1)
val res = resources.getIdentifier(name, "drawable", packageName)

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 類似的格式網址。如果我們發現這類字串可用來建立這類網址，就不會將其移除。

以下為預設啟用的安全縮減模式。但是，您可以關閉這項「防患於未然」控制代碼，並且指定資源縮減器僅保留特定資源。方法是在 keep.xml 檔案中將 shrinkMode 設為 strict，如下所示：

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

如果您確實啟用嚴格縮減模式，且程式碼也參照了動態產生字串的資源 (如上所示)，則必須使用 tools:keep 屬性手動保留這些資源。

移除未使用的替代資源

Gradle 資源縮減器只會移除應用程式程式碼參照的資源，因此不會移除不同裝置設定的 替代資源。如有需要，您可以使用 Android Gradle 外掛程式的 resConfigs 屬性，移除應用程式不需要的其他資源檔案。

例如，如果您使用的程式庫包含語言資源 (例如 AppCompat 或 Google Play 服務)，則您的應用程式會包含這些程式庫中訊息的所有翻譯語言字串，無論您的應用程序的其餘部分是否被翻譯成相同的語言。如果您只想保留應用程式官方支援的語言，可以使用 resConfig 屬性指定。系統會移除任何未指定語言的資源。

下列程式碼片段說明如何將語言資源限制為英文和法文：

android {
    defaultConfig {
        ...
        resourceConfigurations.addAll(listOf("en", "fr"))
    }
}

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

使用 Android App Bundle 格式發布應用程式時，根據預設，只有應用程式安裝在使用者裝置上設定的語言。同樣地，只有與裝置的螢幕密度匹配的資源，以及與裝置的 ABI 匹配的原生資料庫才包含在下載作業中。詳情請參閱 Android App Bundle 設定的相關說明。

如果舊版應用程式使用 APK 發布 (2021 年 8 月前建立)，您可以透過建構多個 APK (每個 APK 針對不同的裝置設定)，以自訂要包含在 APK 中的螢幕密度或 ABI 資源。

合併重複的資源

根據預設，Gradle 也會合併名稱相同的資源，例如可能位於不同資源資料夾中的同名可繪項目。這個行為不受 shrinkResources 屬性控管，而且無法停用，因為如果有多個資源符合您的程式碼查詢名稱，就必須避免這些錯誤。

只有在兩個以上的檔案共用相同的資源名稱、類型和限定詞時，系統才會合併資源。Gradle 會選取要做為重複項目的最佳選擇檔案 (根據下方所述的優先順序順序)，並只向 AAPT 傳遞一項資源，以便在最終成果中發布。

Gradle 會在下列位置尋找重複的資源：

• 與主要來源集相關聯的主要資源，通常位於 src/main/res/。
• 子類疊加層，來自建構類型和建構版本。
• 程式庫專案依附元件。

Gradle 會根據下列優先順序合併重複的資源：

依附元件 → 主要 → 版本版本 → 建構類型

例如，如果主要資源和建構版本出現在重複的資源，Gradle 會選取建構版本中的資源。

如果相同的資源出現在相同的來源集中，Gradle 就無法合併資源，且會發出資源合併錯誤。如果在 build.gradle.kts 檔案的 sourceSet 屬性中定義了多個來源集，例如 src/main/res/ 和 src/main/res2/ 都含有相同的資源，就會發生這種情況。

模糊處理程式碼

模糊處理的目的是縮短應用程式類別、方法和欄位名稱，藉此縮減應用程式的大小。以下是使用 R8 進行模糊處理的範例：

androidx.appcompat.app.ActionBarDrawerToggle$DelegateProvider -> a.a.a.b:
androidx.appcompat.app.AlertController -> androidx.appcompat.app.AlertController:
    android.content.Context mContext -> a
    int mListItemLayout -> O
    int mViewSpacingRight -> l
    android.widget.Button mButtonNeutral -> w
    int mMultiChoiceItemLayout -> M
    boolean mShowTitle -> P
    int mViewSpacingLeft -> j
    int mButtonPanelSideLayout -> K

雖然模糊化不會移除應用程式中的程式碼，但在具有索引的許多類別、方法和欄位的 DEX 檔案的應用程式中可以看到顯著的大小節省。不過，由於程式碼會重新命名程式碼的不同部分，因此某些工作 (例如檢查堆疊追蹤) 需要額外工具。如要瞭解模糊處理後的堆疊追蹤，請參閱「如何解碼模糊化的堆疊追蹤」一節。

此外，如果您的程式碼必須使用可預測的應用程式方法和類別命名，例如使用反射時，請將這些簽名視為進入點，並為其指定保留規則，如「自訂要保留的程式碼」一節中所述。這些保留規則會指示 R8 將程式碼保留在應用程式的最終 DEX 中，同時保留原本的命名。

解碼模糊化的堆疊追蹤

在 R8 模糊處理程式碼後，由於類別和方法的名稱可能已變更，因此瞭解堆疊追蹤並不容易。如要取得原始堆疊追蹤，請重新追蹤堆疊追蹤。

程式碼最佳化

為了進一步最佳化應用程式，R8 會更深入地檢查程式碼，移除未使用的程式碼，或盡可能重新編寫程式碼，讓應用程式變得較不複雜。以下是這類最佳化的幾個範例：

• 如果您的程式碼從未取得特定 if/else 陳述式的 else {} 分支版本，R8 可能會移除 else {} 分支版本的程式碼。
• 如果程式碼只在少數幾個位置呼叫方法，R8 可能會移除該方法，並內嵌在幾個呼叫網站中。
• 如果 R8 判定某個類別只有一個專屬子類別，而該類別本身並未執行個體化 (例如，僅由單一具體實作類別使用的抽象基本類別)，則 R8 可以結合這兩個類別，並從應用程式中移除一個類別。
• 詳情請參閱 Jake Wharton 撰寫的 R8 最佳化網誌文章。

R8 不允許停用或啟用離散最佳化，或是修改最佳化的行為。事實上，R8 會忽略任何嘗試修改預設最佳化項目的 ProGuard 規則，例如 -optimizations 和 -optimizationpasses。此限制非常重要，因為 R8 會持續改善，因此維護標準的標準行為有助 Android 團隊輕鬆排解問題，並解決您可能遇到的問題。

請注意，啟用最佳化功能會變更應用程式的堆疊追蹤。舉例來說，內嵌會移除堆疊框架。如要瞭解如何取得原始堆疊追蹤，請參閱「撤銷」一節。

對執行階段效能的影響

如果啟用縮減、模糊化和最佳化功能，R8 將改善程式碼的執行階段效能 (包括 UI 執行緒上的啟動和影格時間) 最高達 30%。如果停用上述任一項功能，R8 使用的最佳化設定就會大幅受限。

如果已啟用 R8，您也應建立啟動設定檔，進一步改善啟動效能。

啟用更積極的最佳化功能

R8 包含一組額外的最佳化設定 (稱為「完整模式」)，這與 ProGuard 的運作方式不同。自 Android Gradle 外掛程式 8.0.0 版起，系統預設會啟用這些最佳化功能。

您可以在專案的 gradle.properties 檔案中加入以下內容，停用這些額外的最佳化功能：

android.enableR8.fullMode=false

由於額外的最佳化作業讓 R8 與 ProGuard 的運作方式不同，因此如果您使用專為 ProGuard 設計的規則，可能需要加入額外的 ProGuard 規則，以避免執行階段問題。例如，假設您的程式碼透過 Java Reflection API 參照類別。當「不」使用「完整模式」時，R8 會假設您打算在執行階段檢查及操控該類別的物件 (即使程式碼實際上不存在)，並自動保留類別及其靜態初始化器。

不過，使用「完整模式」時，R8 不會假設這個假設，如果 R8 要求程式碼絕不會在執行階段使用類別，就會從應用程式的最終 DEX 中移除類別。也就是說，如要保留類別及其靜態初始化器，您必須在規則檔案中加入 Keep 規則，以完成此動作。

如果您在使用 R8 的「完整模式」時遇到任何問題，請參閱 R8 常見問題頁面提供的可能解決方案。如果無法解決問題，請報告錯誤。

反向堆疊追蹤

R8 處理的程式碼變更了多種方式，可能導致堆疊追蹤難以理解，因為堆疊追蹤不會完全對應到原始碼。例如在未保留偵錯資訊的情況下變更行數。原因可能出在內嵌和大綱等最佳化做法。其中最大的貢獻者就是模糊處理，因為就連類別和方法都會變更名稱。

如要復原原始堆疊追蹤，R8 提供重新追蹤指令列工具，此工具隨附指令列工具套件。

為了支援應用程式的堆疊追蹤反向追蹤功能，建議您在模組的 proguard-rules.pro 檔案中加入以下規則，確保建構作業保留了足夠的資訊以重新追蹤：

-keepattributes LineNumberTable,SourceFile
-renamesourcefileattribute SourceFile

LineNumberTable 屬性會保留方法中的位置資訊，讓這些位置顯示在堆疊追蹤中。SourceFile 屬性可確保所有潛在的執行階段實際輸出位置資訊。-renamesourcefileattribute 指令會將堆疊追蹤中的來源檔案名稱設為僅包含 SourceFile。進行反向追蹤時，不需要實際的原始來源檔案名稱，因為對應檔案包含原始來源檔案。

R8 每次執行時都會建立 mapping.txt 檔案，其中包含將堆疊追蹤對應回原始堆疊追蹤所需的資訊。Android Studio 會將檔案儲存在 <module-name>/build/outputs/mapping/<build-type>/ 目錄中。

在 Google Play 發布應用程式時，您可以上傳各個應用程式版本的 mapping.txt 檔案。使用 Android App Bundle 發布時，這個檔案會自動納入應用程式套件內容中。接著，Google Play 會重新追蹤傳入的堆疊追蹤，追蹤使用者回報的問題，方便您在 Play 管理中心查看。詳情請參閱如何針對當機時的堆疊追蹤去模糊化相關說明中心文章。

使用 R8 進行疑難排解

本節說明使用 R8 啟用縮減、模糊處理和最佳化時，疑難排解的一些策略。如果下方未列出您的問題，另請參閱 R8 常見問題頁面和 ProGuard 的疑難排解指南。

產生已移除 (或保留) 程式碼的報表

為協助您排解某些 R8 問題，建議您查看 R8 從應用程式中移除的所有程式碼報表。對於要產生這份報告的每個模組，請將 -printusage <output-dir>/usage.txt 加入自訂規則檔案。當您啟用 R8 並建構應用程式時，R8 會使用您指定的路徑和檔案名稱輸出報表。程式碼移除後，看起來會像這樣：

androidx.drawerlayout.R$attr
androidx.vectordrawable.R
androidx.appcompat.app.AppCompatDelegateImpl
    public void setSupportActionBar(androidx.appcompat.widget.Toolbar)
    public boolean hasWindowFeature(int)
    public void setHandleNativeActionModesEnabled(boolean)
    android.view.ViewGroup getSubDecor()
    public void setLocalNightMode(int)
    final androidx.appcompat.app.AppCompatDelegateImpl$AutoNightModeManager getAutoNightModeManager()
    public final androidx.appcompat.app.ActionBarDrawerToggle$Delegate getDrawerToggleDelegate()
    private static final boolean DEBUG
    private static final java.lang.String KEY_LOCAL_NIGHT_MODE
    static final java.lang.String EXCEPTION_HANDLER_MESSAGE_SUFFIX
...

但如果您想查看 R8 根據專案的保留規則決定的進入點報表，請在自訂規則檔案中加入 -printseeds <output-dir>/seeds.txt。當您啟用 R8 並建構應用程式時，R8 會使用您指定的路徑和檔案名稱輸出報表。保留進入點的報表看起來會像這樣：

com.example.myapplication.MainActivity
androidx.appcompat.R$layout: int abc_action_menu_item_layout
androidx.appcompat.R$attr: int activityChooserViewStyle
androidx.appcompat.R$styleable: int MenuItem_android_id
androidx.appcompat.R$styleable: int[] CoordinatorLayout_Layout
androidx.lifecycle.FullLifecycleObserverAdapter
...

資源縮減疑難排解

縮減資源時，「Build」 視窗會顯示已從應用程式移除的資源摘要 (您需要先按一下視窗左側的「Toggle view」，才能顯示 Gradle 的詳細文字輸出內容)。舉例來說：

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

Gradle 也會在 <module-name>/build/outputs/mapping/release/ 中建立名為 resources.txt 的診斷檔案 (與 ProGuard 的輸出檔案位於同一個資料夾)。這個檔案內含哪些資源會參照其他資源，以及如何運用或移除資源。

例如，如要找出 @drawable/ic_plus_anim_016 仍在應用程式中的原因，請開啟 resources.txt 檔案並搜尋檔案名稱。您可能會發現，它從其他資源中進行了參照，如下所示：

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

您現在需要知道 @drawable/add_schedule_fab_icon_anim 可以存取的原因，如果您向上搜尋，就會看到資源列於「The root 連上 resources are:」下方。這表示 add_schedule_fab_icon_anim 有程式碼參照 (也就是說，可在可連接的程式碼中找到其 R.drawable ID)。

如果您並未使用嚴格檢查，若有字串常數可用來建立動態載入資源的資源名稱常數，就可以將資源 ID 標示為可連項目。在這種情況下，如果您搜尋資源名稱的建構輸出內容，可能會看到如下的訊息：

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.

如果您看到其中一個字串，而且確定該字串並未用於動態載入指定資源，您可以使用 tools:discard 屬性通知建構系統將其移除，如「自訂要保留的資源」一節所述。