新增全域選項

R8 提供全域選項，可修改整個應用程式的 R8 最佳化作業，或影響每項保留規則。這些選項會與保留規則一起維護在 proguard-rules.pro 檔案中。部分全域選項可設定額外最佳化功能，其他選項則可關閉最佳化的特定層面。

全域選項，可進一步最佳化

下列全域選項可啟用額外最佳化功能：

• -repackageclasses [<optional-package-name>]：將類別重新封裝到單一指定套件中，進一步縮減應用程式大小。如果您未提供選用的套件名稱，系統會將類別移至空白的預設套件。這是應用程式的建議設定。
• -allowaccessmodification：允許 R8 變更 (通常是擴大) 類別、欄位和方法的瀏覽權限，以執行更廣泛的最佳化。使用 proguard-android-optimize.txt 時會啟用。自 Android Gradle 外掛程式 (AGP) 8.2 起，如果您在完整模式下使用 R8，這就是預設設定。

以下是啟用額外最佳化的設定範例：

-repackageclasses
-allowaccessmodification

限制最佳化的全域選項

您可以透過下列全域選項關閉應用程式最佳化的特定功能，這在調整保留規則或首次啟用 R8 時很有幫助。

• -dontoptimize：防止程式碼最佳化，例如方法內嵌。這個選項可用於開發期間，但不應在正式版建構中使用。
• -dontshrink：防止移除未參照的程式碼和程式碼最佳化。這個選項可用於開發期間，但不應在正式版建構中使用。
• -dontobfuscate：防止縮短類別和方法的名稱。在偵錯期間關閉混淆處理功能，有助於輕鬆解讀堆疊追蹤記錄。這個選項可用於開發期間，但不應在正式版建構中使用。
• -keepattributes <attributes>：接受以半形逗號分隔的屬性清單，這些屬性應保留。如果沒有使用預設的 proguard-android-optimize.txt，R8 會移除所有屬性，包括 RuntimeVisibleAnnotations 和 Signature，但如果需要保留這些屬性 (例如用於反射)，這項功能就很有幫助。如需可指定的屬性清單，請參閱「保留屬性」。

保留屬性

屬性是附加至程式碼不同部分的額外資訊。屬性會儲存來自程式碼的註解和一般簽章等資訊。

某些反射作業需要保留特定屬性，才能順利執行。例如：

• 使用 getEnclosingMethod() 或 getDeclaredClasses() 存取內部或外部類別結構時，需要 EnclosingMethod 和 InnerClasses 屬性。
• 使用 getTypeParameters() 存取泛型簽章時，需要 Signature 屬性。

• 使用 getAnnotation() 存取註解時，需要 RuntimeVisibleAnnotations 屬性。

常見必要屬性

使用預設 ProGuard 檔案 (proguard-android-optimize.txt 或 proguard-android.txt) 時，Android Gradle 外掛程式 (AGP) 會保留下列屬性。請注意，部分屬性需要較新版本的 AGP：

對於使用 proguard-android-optimize.txt 的應用程式，在大多數情況下，AGP 定義的保留規則就已足夠。不過，如果您要為程式庫編寫程式碼，即使這些屬性已定義於這個清單中，也應在程式庫的消費者保留規則中指定程式庫所需的所有屬性。這樣一來，即使開發人員決定不加入 proguard-android-optimize.txt，您的程式庫也能確保穩定運作。

其他保留屬性

您可以指定要保留的其他屬性，但對於絕大多數的反射或 JNI 存取情境而言，這些屬性並非必要。不過，在最佳化程式庫時，您可能仍會頻繁使用其中一些項目。