การเพิ่มประสิทธิภาพสำหรับผู้เขียนคลัง

ในฐานะผู้เขียนไลบรารี คุณต้องตรวจสอบว่านักพัฒนาแอปสามารถรวมไลบรารีของคุณเข้ากับแอปของตนได้อย่างง่ายดาย ขณะเดียวกันก็รักษาประสบการณ์ของผู้ใช้ปลายทางที่มีคุณภาพสูงไว้ได้ ซึ่งหมายความว่าไลบรารีของคุณต้องเข้ากันได้กับการเพิ่มประสิทธิภาพ Android (R8) โดยที่นักพัฒนาแอปไม่ต้องตั้งค่าเพิ่มเติม หรือระบุไว้ในเอกสารประกอบว่าไลบรารีอาจไม่เหมาะสำหรับการใช้งานใน Android ไลบรารีที่ออกแบบมาเพื่อใช้ใน Android ต้องไม่ขัดขวางการเพิ่มประสิทธิภาพแอปที่สำคัญและต้องเป็นไปตามข้อกำหนดการเพิ่มประสิทธิภาพเพิ่มเติม

เอกสารประกอบนี้มีเป้าหมายเป็นนักพัฒนาไลบรารีที่เผยแพร่แล้ว แต่อาจเป็นประโยชน์สำหรับนักพัฒนาโมดูลไลบรารีภายในในแอปขนาดใหญ่ที่แยกเป็นโมดูลด้วย

หากคุณเป็นนักพัฒนาแอปและต้องการดูข้อมูลเกี่ยวกับการเพิ่มประสิทธิภาพแอป Android โปรดดูหัวข้อเปิดใช้การเพิ่มประสิทธิภาพแอป หากต้องการดูข้อมูลเกี่ยวกับไลบรารีที่เหมาะสมที่จะใช้ โปรดดูหัวข้อเลือกไลบรารีอย่างชาญฉลาด

ทำความเข้าใจประเภทของกฎการเก็บรักษา

กฎการเก็บรักษาที่คุณมีในคลังมี 2 ประเภทที่แตกต่างกัน ได้แก่

  • กฎการเก็บรักษาของผู้ใช้ต้องระบุกฎที่เก็บสิ่งที่ไลบรารีสะท้อนถึง หากไลบรารีใช้การสะท้อนหรือ JNI เพื่อเรียกใช้โค้ดของตนเองหรือโค้ดที่แอปไคลเอ็นต์กำหนด กฎเหล่านี้จะต้องอธิบายโค้ดที่ต้องเก็บไว้ ไลบรารีควรจัดแพ็กเกจกฎการเก็บรักษาของผู้ใช้ ซึ่งใช้รูปแบบเดียวกับกฎการเก็บรักษาของแอป กฎเหล่านี้จะรวมอยู่ในอาร์ติแฟกต์ไลบรารี (AAR หรือ JAR) และจะถูกใช้โดยอัตโนมัติในระหว่างการเพิ่มประสิทธิภาพแอป Android เมื่อมีการใช้ไลบรารี กฎเหล่านี้จะได้รับการเก็บไว้ในไฟล์ที่ระบุด้วยพร็อพเพอร์ตี้ consumerProguardFiles ในไฟล์ build.gradle.kts (หรือ build.gradle) ดูข้อมูลเพิ่มเติมได้ที่เขียนกฎการเก็บรักษาของผู้บริโภค
  • ระบบจะใช้กฎการเก็บรักษาบิลด์ไลบรารีเมื่อสร้างไลบรารี คุณจำเป็นต้องใช้ก็ต่อเมื่อตัดสินใจที่จะเพิ่มประสิทธิภาพไลบรารีบางส่วนในเวลาบิลด์เท่านั้น โดยต้องป้องกันไม่ให้มีการนำ API สาธารณะของไลบรารีออก ไม่เช่นนั้น API สาธารณะจะไม่ปรากฏในการเผยแพร่ไลบรารี ซึ่งหมายความว่านักพัฒนาแอปจะใช้ไลบรารีไม่ได้ กฎเหล่านี้จะได้รับการเก็บไว้ในไฟล์ที่ระบุด้วยพร็อพเพอร์ตี้ proguardFiles ในไฟล์ build.gradle.kts (หรือ build.gradle) ดูข้อมูลเพิ่มเติมได้ที่เพิ่มประสิทธิภาพบิลด์ไลบรารี AAR

ข้อกำหนดและหลักเกณฑ์ในการเพิ่มประสิทธิภาพ

การกำหนดค่า R8 ในไลบรารีส่งผลกระทบต่อขนาดไบนารีสุดท้ายและประสิทธิภาพของแอปที่ใช้ไลบรารีนั้น นอกเหนือจากแนวทางปฏิบัติแนะนำทั่วไปเกี่ยวกับกฎการเก็บรักษาแล้ว ผู้เขียนไลบรารีต้องปฏิบัติตามข้อกำหนดเฉพาะและพิจารณาหลักเกณฑ์เพิ่มเติมด้วย

ปฏิบัติตามข้อกำหนดในการเพิ่มประสิทธิภาพ

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

  • ไม่มีกฎการเก็บรักษาแบบกว้างหรือแบบทั้งแพ็กเกจ: ไลบรารีของคุณต้องไม่มีกฎการเก็บรักษาแบบกว้างที่เก็บโค้ดส่วนใหญ่ไว้ในไลบรารีของคุณหรือในไลบรารีอื่น กฎการเก็บรักษาแบบกว้างอาจแก้ปัญหาข้อขัดข้องได้ในระยะสั้น แต่จะทำให้ขนาดแอปทั้งหมดที่ใช้ไลบรารีของคุณเพิ่มขึ้น

    อย่าใส่กฎการเก็บรักษาทั้งแพ็กเกจ (เช่น -keep class com.mylibrary.** {*; }) สำหรับแพ็กเกจในไลบรารีของคุณหรือไลบรารีอื่นๆ ที่อ้างอิง กฎดังกล่าวจะจำกัดการเพิ่มประสิทธิภาพสำหรับแพ็กเกจเหล่านี้ในแอปทั้งหมดที่ใช้ไลบรารีของคุณ

    อย่าใส่กฎการเก็บแบบกว้างสำหรับทรัพยากร Dependency ของบุคคลที่สามที่ไลบรารีของคุณใช้ (เช่น -keep public class com.google.android.gms.** { *; }) ไลบรารีภายนอกจำนวนมากมีกฎการเก็บของผู้บริโภคของตนเองอยู่แล้ว การใช้กฎทั้งแพ็กเกจจะแทนที่กฎเหล่านั้นและบังคับให้ R8 เก็บโค้ดทรัพยากร Dependency ที่ไม่มีการอ้างอิงไว้ทั่วทั้งแอปพลิเคชัน

  • ไม่มีกฎส่วนกลางที่ไม่เหมาะสม: อย่าใช้ตัวเลือกส่วนกลาง เช่น -dontobfuscate หรือ -allowaccessmodification

  • ใช้ Codegen แทนการใช้ Reflection เมื่อเป็นไปได้: เมื่อเป็นไปได้ ให้ใช้การสร้างโค้ด (Codegen) แทนการใช้ Reflection Codegen และการสะท้อนเป็นแนวทางที่ใช้กันทั่วไปเพื่อหลีกเลี่ยงโค้ด Boilerplate เมื่อเขียนโปรแกรม แต่ Codegen เข้ากันได้กับเครื่องมือเพิ่มประสิทธิภาพแอปอย่าง R8 มากกว่า

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

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

    ไลบรารีสมัยใหม่จำนวนมากใช้ Codegen แทนการสะท้อน ดู KSP สำหรับจุดแรกเข้าทั่วไปที่ Room, Hilt และอื่นๆ อีกมากมายใช้

  • รองรับโหมดเต็มรูปแบบของ R8: ไลบรารีไม่ควรขัดข้องเมื่อเปิดใช้โหมดเต็มรูปแบบของ R8 โหมดเต็มรูปแบบของ R8 เป็นโหมดที่แนะนำให้ใช้ R8 และเป็นโหมดเริ่มต้นตั้งแต่ AGP 8.0 ซึ่งมีความเสถียรในปี 2023 หากไลบรารีขัดข้องภายใต้ R8 วิธีแก้ปัญหาคือระบุจุดแรกเข้าของ Reflection หรือ JNI ที่เฉพาะเจาะจง แล้วเพิ่มกฎที่กำหนดเป้าหมาย ไม่ใช่เก็บทั้งแพ็กเกจไว้ หากต้องการสร้างกฎที่กำหนดเป้าหมายจากคำอธิบายประกอบในจุดแรกเข้าเหล่านี้ ให้ใช้ Jetpack Keep

คำแนะนำเพิ่มเติม

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

  • อย่าใช้ -repackageclasses ในไฟล์กฎการเก็บรักษาของผู้ใช้ของไลบรารี ระบบจะผสานกฎการเก็บของผู้บริโภคเข้ากับการกำหนดค่า R8 ของทุกแอปที่ใช้ไลบรารีของคุณ ดังนั้นตัวเลือกส่วนกลางนี้จึงมีผลกับทั้งแอปและลบล้างการตั้งค่าการจัดแพ็กเกจใหม่ของนักพัฒนาแอปเอง โดยค่าเริ่มต้น ตั้งแต่ AGP 9.0 เป็นต้นไป การเผยแพร่ไลบรารีจะดำเนินการไม่สำเร็จหากกฎการเก็บรักษาของผู้บริโภคมีตัวเลือกส่วนกลาง ดูข้อมูลเพิ่มเติมได้ที่บันทึกประจำรุ่นของ AGP 9.0

    หากต้องการเพิ่มประสิทธิภาพบิลด์ไลบรารี คุณสามารถใช้ -repackageclasses กับชื่อแพ็กเกจภายใน เช่น <your.library.package>.internal ในไฟล์กฎการเก็บรักษาบิลด์ของไลบรารีแทนได้ ซึ่งจะช่วยเพิ่มประสิทธิภาพของไลบรารีในแอปที่ไม่ได้เพิ่มประสิทธิภาพ แต่โดยทั่วไปแล้วไม่จำเป็นเนื่องจากแอปควรได้รับการเพิ่มประสิทธิภาพด้วย

  • ประกาศแอตทริบิวต์ทั้งหมดที่จำเป็นสำหรับไลบรารีเพื่อให้ทำงานในไฟล์กฎการเก็บรักษาของไลบรารี แม้ว่าอาจมีการทับซ้อนกับแอตทริบิวต์ที่กำหนดไว้ใน proguard-android-optimize.txt ก็ตาม

  • หากคุณต้องการแอตทริบิวต์ต่อไปนี้ในการเผยแพร่ไลบรารี ให้เก็บแอตทริบิวต์เหล่านั้นไว้ในไฟล์กฎการเก็บรักษาบิลด์ของไลบรารี และไม่ใช่ในไฟล์กฎการเก็บรักษาของผู้ใช้ไลบรารี

    • AnnotationDefault
    • EnclosingMethod
    • Exceptions
    • InnerClasses
    • RuntimeInvisibleAnnotations
    • RuntimeInvisibleParameterAnnotations
    • RuntimeInvisibleTypeAnnotations
    • RuntimeVisibleAnnotations
    • RuntimeVisibleParameterAnnotations
    • RuntimeVisibleTypeAnnotations
    • Signature
  • ผู้เขียนไลบรารีควรเก็บแอตทริบิวต์ RuntimeVisibleAnnotations ไว้ในกฎการเก็บรักษาของผู้ใช้หากใช้คำอธิบายประกอบในรันไทม์

  • ผู้เขียนไลบรารีไม่ควรใช้ตัวเลือกส่วนกลางต่อไปนี้ในกฎการเก็บรักษาของผู้ใช้ ตัวเลือกเหล่านี้จะกำหนดค่าบิลด์ R8 ทั้งหมดของแอป เช่นเดียวกับ -repackageclasses แทนที่จะกำหนดค่าเฉพาะโค้ดของไลบรารี ดังนั้นโปรดปล่อยให้นักพัฒนาแอปเป็นผู้ดำเนินการ

    • -include
    • -basedirectory
    • -injars
    • -outjars
    • -libraryjars
    • -repackageclasses
    • -flattenpackagehierarchy
    • -allowaccessmodification
    • -renamesourcefileattribute
    • -ignorewarnings
    • -addconfigurationdebugging
    • -printconfiguration
    • -printmapping
    • -printusage
    • -printseeds
    • -applymapping
    • -obfuscationdictionary
    • -classobfuscationdictionary
    • -packageobfuscationdictionary

กรณีที่การสะท้อนแสงเป็นเรื่องปกติ

หากต้องใช้การสะท้อน คุณควรสะท้อนไปยังรายการใดรายการหนึ่งต่อไปนี้เท่านั้น

  • ประเภทการกำหนดเป้าหมายที่เฉพาะเจาะจง (ผู้ติดตั้งอินเทอร์เฟซหรือคลาสย่อยที่เฉพาะเจาะจง)
  • โค้ดที่ใช้คำอธิบายประกอบรันไทม์ที่เฉพาะเจาะจง

การใช้การสะท้อนในลักษณะนี้จะจำกัดต้นทุนรันไทม์ และช่วยให้เขียนกฎการเก็บรักษาผู้บริโภคที่กำหนดเป้าหมายได้

การใช้ Reflection ที่เฉพาะเจาะจงและตรงเป้าหมายนี้เป็นรูปแบบที่คุณเห็นได้ทั้งในเฟรมเวิร์ก Android (เช่น เมื่อขยายกิจกรรม, มุมมอง และ Drawable) และไลบรารี AndroidX (เช่น เมื่อสร้าง WorkManager ListenableWorkers หรือ RoomDatabases) ในทางตรงกันข้าม การใช้ Reflection แบบปลายเปิดของ Gson ไม่เหมาะสำหรับการใช้งานในแอป Android

ความเข้าใจผิดที่พบบ่อย

ความเข้าใจผิดที่พบบ่อยบางประการอาจทำให้คุณกำหนดค่า R8 ไม่ถูกต้อง ซึ่งรวมถึงแอปต่อไปนี้ด้วย

  • ความเข้าใจผิดเกี่ยวกับการเพิ่มประสิทธิภาพของ R8: การเพิ่มประสิทธิภาพของ R8 ไม่ได้จำกัดอยู่เพียงการปรับให้ยากต่อการอ่าน (Obfuscation) เท่านั้น แต่ยังรวมถึงการลดขนาดโค้ดและการเพิ่มประสิทธิภาพเชิงตรรกะด้วยเทคนิคการรวมเมธอด (Method Inlining) และการรวมคลาส (Class Merging) ด้วย ดูข้อมูลเพิ่มเติมได้ที่ภาพรวมการเพิ่มประสิทธิภาพ R8

  • การข้ามการเพิ่มประสิทธิภาพไลบรารีที่สร้างความสับสน: ข้อผิดพลาดที่พบบ่อยคือการละเว้นไลบรารีจากการเพิ่มประสิทธิภาพ เนื่องจากไลบรารีได้รับการเพิ่มประสิทธิภาพหรือสร้างความสับสนเมื่อคอมไพล์เป็น AAR (Android Archive) หรือ JAR (Java Archive) การเพิ่มประสิทธิภาพระหว่างเวลาบิลด์ไลบรารีมีจำกัด และแอปของคุณไม่ควรปิดใช้การเพิ่มประสิทธิภาพของไลบรารีโดยรวมไว้ในกฎการเก็บรักษา ดูข้อมูลเพิ่มเติมได้ที่เพิ่มประสิทธิภาพบิลด์ไลบรารี AAR

  • ความเข้าใจที่ไม่ถูกต้องเกี่ยวกับตัวเลือก -keep กฎ -keep จะป้องกันไม่ให้ R8 เรียกใช้การเพิ่มประสิทธิภาพใดๆ ดูข้อมูลเพิ่มเติมได้ที่หัวข้อเลือกตัวเลือกการเก็บรักษาที่เหมาะสม

ตรวจสอบคุณภาพของกฎการเก็บรักษาของผู้ใช้ปลายทาง

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

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

กำหนดค่าแพ็กเกจกฎ

เพื่อให้แน่ใจว่าระบบใช้กฎการเก็บรักษาของผู้บริโภคอย่างถูกต้อง คุณต้องจัดแพ็กเกจกฎเหล่านั้นอย่างเหมาะสมตามรูปแบบไลบรารีของคุณ

หากคุณใช้ Jetpack Keep เพื่อประกาศการใช้การสะท้อนและ JNI ของไลบรารี ปลั๊กอิน Gradle ของไลบรารีจะแพ็กเกจกฎที่สร้างขึ้นเป็นกฎการเก็บรักษาของผู้บริโภคให้คุณได้

ไลบรารี AAR

หากต้องการเพิ่มกฎผู้ใช้สำหรับไลบรารี AAR ให้ใช้ตัวเลือก consumerProguardFiles ในสคริปต์บิลด์ของโมดูลไลบรารี Android ดูข้อมูลเพิ่มเติมได้ที่คำแนะนำในการสร้างโมดูลไลบรารี

Kotlin

android {
    defaultConfig {
        consumerProguardFiles("consumer-proguard-rules.pro")
    }
    ...
}

ดึงดูด

android {
    defaultConfig {
        consumerProguardFiles 'consumer-proguard-rules.pro'
    }
    ...
}

ไลบรารี JAR

หากต้องการรวมกฎเข้ากับไลบรารี Kotlin หรือ Java ที่จัดส่งเป็น JAR ให้ใส่ไฟล์กฎในไดเรกทอรี META-INF/proguard/ ของ JAR สุดท้าย โดยใช้ชื่อไฟล์ใดก็ได้ ตัวอย่างเช่น หากโค้ดของคุณอยู่ใน <libraryroot>/src/main/kotlin ให้ใส่ไฟล์กฎของผู้ใช้ที่ <libraryroot>/src/main/resources/META-INF/proguard/consumer-proguard-rules.pro และกฎจะรวมอยู่ในตำแหน่งที่ถูกต้องใน JAR เอาต์พุต

ยืนยันว่า JAR สุดท้ายรวมกฎอย่างถูกต้องโดยตรวจสอบว่ากฎอยู่ในไดเรกทอรี META-INF/proguard

เพิ่มประสิทธิภาพบิลด์ไลบรารี AAR (ขั้นสูง)

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

หากยังต้องการเพิ่มประสิทธิภาพไลบรารีในเวลาบิลด์ ปลั๊กอิน Android Gradle จะรองรับการดำเนินการนี้

Kotlin

android {
    buildTypes {
        release {
            isMinifyEnabled = true
            proguardFiles(
                getDefaultProguardFile("proguard-android-optimize.txt"),
                "proguard-rules.pro"
            )
        }
        configureEach {
            consumerProguardFiles("consumer-rules.pro")
        }
    }
}

ดึงดูด

android {
    buildTypes {
        release {
            minifyEnabled true
            proguardFiles
                getDefaultProguardFile('proguard-android-optimize.txt'),
                'proguard-rules.pro'
        }
        configureEach {
            consumerProguardFiles "consumer-rules.pro"
        }
    }
}

โปรดทราบว่าลักษณะการทำงานของ proguardFiles แตกต่างจาก consumerProguardFiles อย่างมาก ดังนี้

  • proguardFiles จะใช้ในเวลาบิลด์ โดยมักใช้ร่วมกับ getDefaultProguardFile("proguard-android-optimize.txt") เพื่อกำหนดว่าควรเก็บส่วนใดของไลบรารีไว้ระหว่างการบิลด์ไลบรารี อย่างน้อยที่สุด นี่คือ API สาธารณะของคุณ
  • ในทางตรงกันข้าม consumerProguardFiles จะรวมอยู่ในไลบรารีเพื่อส่งผลต่อการเพิ่มประสิทธิภาพที่จะเกิดขึ้นในภายหลัง ระหว่างการสร้างแอปที่ใช้ไลบรารีของคุณ

ตัวอย่างเช่น หากไลบรารีใช้การสะท้อนเพื่อสร้างคลาสภายใน คุณอาจต้องกำหนดกฎการเก็บทั้งใน proguardFiles และ consumerProguardFiles

หากคุณใช้ -repackageclasses ในบิลด์ของไลบรารี ให้จัดแพ็กเกจคลาสใหม่เป็นแพ็กเกจย่อยภายในแพ็กเกจของไลบรารี เช่น ใช้ -repackageclasses 'com.example.mylibrary.internal' แทน -repackageclasses 'internal'

รองรับ R8 เวอร์ชันต่างๆ (ขั้นสูง)

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

หากต้องการระบุกฎ R8 ที่กำหนดเป้าหมาย คุณต้องรวมกฎเหล่านั้นไว้ในไดเรกทอรี META-INF/com.android.tools ภายใน classes.jar ของ AAR หรือในไดเรกทอรี META-INF/com.android.tools ของ JAR

In an AAR library:
    proguard.txt (legacy location, the file name must be "proguard.txt")
    classes.jar
    └── META-INF
        └── com.android.tools (location of targeted R8 rules)
            ├── r8-from-<X>-upto-<Y>/<R8-rule-files>
            └── ... (more directories with the same name format)

In a JAR library:
    META-INF
    ├── proguard/<ProGuard-rule-files> (legacy location)
    └── com.android.tools (location of targeted R8 rules)
        ├── r8-from-<X>-upto-<Y>/<R8-rule-files>
        └── ... (more directories with the same name format)

ในไดเรกทอรี META-INF/com.android.tools อาจมีไดเรกทอรีย่อยหลายรายการที่มีชื่อในรูปแบบ r8-from-<X>-upto-<Y> เพื่อระบุว่ากฎเขียนขึ้นสำหรับ R8 เวอร์ชันใด ไดเรกทอรีย่อยแต่ละรายการมีไฟล์ที่มีกฎ R8 ได้อย่างน้อย 1 ไฟล์ โดยมีชื่อและนามสกุลไฟล์ใดก็ได้

โปรดทราบว่าส่วน -from-<X> และ -upto-<Y> เป็นส่วนที่ไม่บังคับ เวอร์ชัน <Y> เป็นเวอร์ชันพิเศษ และช่วงเวอร์ชันมักจะต่อเนื่องกัน แต่อาจทับซ้อนกันได้ด้วย

เช่น r8, r8-upto-8.0.0, r8-from-8.0.0-upto-8.2.0 และ r8-from-8.2.0 เป็นชื่อไดเรกทอรีที่แสดงชุดกฎ R8 ที่กำหนดเป้าหมาย กฎในไดเรกทอรี r8 สามารถใช้ได้กับ R8 ทุกเวอร์ชัน R8 สามารถใช้กฎในไดเรกทอรี r8-from-8.0.0-upto-8.2.0 ได้ตั้งแต่เวอร์ชัน 8.0.0 ขึ้นไป แต่ไม่รวมเวอร์ชัน 8.2.0

ปลั๊กอิน Android Gradle จะใช้ข้อมูลดังกล่าวเพื่อเลือกกฎทั้งหมดที่เวอร์ชัน R8 ปัจจุบันใช้ได้ หากไลบรารีไม่ได้ระบุกฎ R8 ที่กำหนดเป้าหมาย ปลั๊กอิน Android Gradle จะเลือกกฎจากตำแหน่งเดิม (proguard.txt สำหรับ AAR หรือ META-INF/proguard/<ProGuard-rule-files> สำหรับ JAR)