เพิ่มตัวเลือกส่วนกลาง

R8 มีตัวเลือกส่วนกลางที่แก้ไขการเพิ่มประสิทธิภาพของ R8 ทั่วทั้งแอปหรือส่งผลต่อกฎการเก็บทุกรายการ ตัวเลือกเหล่านี้จะได้รับการเก็บไว้ในไฟล์ proguard-rules.pro พร้อมกับกฎการเก็บรักษา ตัวเลือกส่วนกลางเหล่านี้บางตัวเลือกจะกำหนดค่าการเพิ่มประสิทธิภาพเพิ่มเติม บางตัวเลือกจะปิดการเพิ่มประสิทธิภาพบางด้าน

ตัวเลือกส่วนกลางสำหรับการเพิ่มประสิทธิภาพเพิ่มเติม

ตัวเลือกส่วนกลางต่อไปนี้ช่วยให้เพิ่มประสิทธิภาพได้เพิ่มเติม

• -repackageclasses [<optional-package-name>]: จัดแพ็กเกจคลาสใหม่เป็นแพ็กเกจเดียวเพื่อลดขนาดแอป หากไม่ได้ระบุชื่อแพ็กเกจที่ไม่บังคับ ระบบจะย้ายคลาสไปยังแพ็กเกจเริ่มต้นที่ไม่มีชื่อ นี่คือ การตั้งค่าที่แนะนำสำหรับแอปเนื่องจากจะทำให้ไฟล์ DEX มีขนาดเล็กลงโดย ละเว้นคำนำหน้าแพ็กเกจจากชื่อคลาส
• -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 แต่การเก็บรักษาแอตทริบิวต์เหล่านี้อาจเป็นประโยชน์หากจำเป็นในกรณีต่างๆ เช่น การทำ Reflection สำหรับรายการแอตทริบิวต์ที่คุณสามารถระบุ โปรดดูที่แอตทริบิวต์ที่ต้องเก็บ

แอตทริบิวต์ที่ต้องเก็บ

แอตทริบิวต์คือข้อมูลเพิ่มเติมที่แนบมากับส่วนต่างๆ ของโค้ด แอตทริบิวต์จะจัดเก็บข้อมูล เช่น คำอธิบายประกอบและลายเซ็นทั่วไปจากโค้ดของคุณ

การทำ Reflection บางอย่างต้องเก็บบางแอตทริบิวต์ไว้เพื่อให้ดำเนินการได้สำเร็จ เช่น

• เมื่อเข้าถึงโครงสร้างคลาสภายในหรือภายนอกโดยใช้ 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 ไว้

แอตทริบิวต์ที่ต้องเก็บเพิ่มเติม

คุณระบุแอตทริบิวต์เพิ่มเติมที่จะเก็บไว้ได้ แต่ไม่จำเป็นสำหรับสถานการณ์การเข้าถึงผ่าน reflection หรือ JNI ส่วนใหญ่ อย่างไรก็ตาม คุณอาจยังคงใช้บางส่วนของ รายการเหล่านี้บ่อยครั้งขณะเพิ่มประสิทธิภาพไลบรารี