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

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

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

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

• -repackageclasses [<optional-package-name>]: จัดแพ็กเกจคลาสใหม่เป็นแพ็กเกจเดียวเพื่อลดขนาดแอป หากไม่ได้ระบุชื่อแพ็กเกจที่ไม่บังคับ ระบบจะย้ายคลาสไปยังแพ็กเกจที่ไม่มีชื่อ (ค่าเริ่มต้น) นี่คือ การตั้งค่าที่แนะนำสำหรับแอป เนื่องจากจะทำให้ไฟล์ DEX มีขนาดเล็กลงโดย ละเว้นคำนำหน้าแพ็กเกจจากชื่อคลาส ตั้งแต่ปลั๊กอิน Android Gradle (AGP) 9.1 เป็นต้นไป การกำหนดค่านี้จะเป็นค่าเริ่มต้นสำหรับแอป หากต้องการเลือกไม่ใช้การเพิ่มประสิทธิภาพนี้ ให้ใช้ -dontrepackage
• -allowaccessmodification: อนุญาตให้ R8 เปลี่ยน (โดยปกติคือขยาย) ระดับการเข้าถึงของคลาส ฟิลด์ และเมธอดเพื่อทำการเพิ่มประสิทธิภาพที่ครอบคลุมมากขึ้น เปิดใช้เมื่อใช้ proguard-android-optimize.txt ตั้งแต่ปลั๊กอิน Android Gradle (AGP) 8.2 เป็นต้นมา การกำหนดค่านี้จะเป็นค่าเริ่มต้นหากคุณเปิดใช้การเพิ่มประสิทธิภาพ แบบเต็มด้วย R8
• -processkotlinnullchecks [level]: อนุญาตให้ R8 เปลี่ยนการตรวจสอบค่า Null ของ Kotlin Intrinsics เป็นเพียงการนำข้อความแสดงข้อผิดพลาดออกหรือนำ การตรวจสอบค่า Null ที่ชัดเจนออกทั้งหมด
  ค่า level ที่เรียงจากอ่อนที่สุดไปแรงที่สุดจะมีผลดังนี้
  • keep จะไม่เปลี่ยนแปลงการตรวจสอบ
  • remove_message เขียนการเรียกใช้แต่ละเมธอดตรวจสอบใหม่เป็นการเรียกใช้getClass() ในอาร์กิวเมนต์แรกของการเรียกใช้ (ซึ่งจะยังคงการตรวจสอบ ค่าว่างไว้ แต่ไม่มีข้อความใดๆ)
  • remove จะนำการตรวจสอบออกโดยสมบูรณ์
    โดยค่าเริ่มต้น R8 จะใช้ remove_message การระบุ -processkotlinnullchecks จะลบล้างการระบุนั้น หากระบุหลายครั้ง ระบบจะใช้ค่าที่เข้มงวดที่สุด
    -processkotlinnullchecks รองรับตั้งแต่ AGP 9.0.0

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

-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 ส่วนใหญ่ อย่างไรก็ตาม คุณอาจยังคงใช้บางส่วนของ รายการเหล่านี้บ่อยครั้งขณะเพิ่มประสิทธิภาพไลบรารี