ทำตามแนวทางปฏิบัติแนะนำ

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

รูปแบบที่ดีในกฎการเก็บ

กฎการเก็บที่กำหนดไว้อย่างดีจะมีความเฉพาะเจาะจงมากที่สุดเท่าที่จะเป็นไปได้

  • สำหรับการระบุคลาส ให้ระบุคลาสเฉพาะ คลาสฐาน หรือ คลาสที่มีคำอธิบายประกอบเสมอหากเป็นไปได้ ดังตัวอย่างต่อไปนี้

    -keepclassmembers class com.example.MyClass {
      void someSpecificMethod();
    }
    
    -keepclassmembers ** extends com.example.MyBaseClass {
      void someSpecificMethod();
    }
    
    -keepclassmembers @com.example.MyAnnotation class ** {
      void someSpecificMethod();
    }
    
  • ควรประกาศข้อกำหนดของสมาชิกทุกครั้งที่เป็นไปได้ และอ้างอิงเฉพาะส่วนของคลาสที่ต้องเก็บไว้เพื่อให้แอปทำงานได้ ขอแนะนำว่าไม่ควรใช้กฎกับทั้งชั้นเรียนโดยการกำหนดขอบเขตสมาชิกที่ไม่บังคับเป็น { *; } เว้นแต่จะจำเป็นอย่างยิ่ง

    -keepclassmembers com.example.MyClass {
      void someSpecificMethod();
      void @com.example.MyAnnotation *;
    }
    

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

-keepclassmembers class com.example.pkg.** { *; }

สิ่งที่ควรหลีกเลี่ยง

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

  • หลีกเลี่ยงการใช้ตัวดำเนินการผกผัน ! ในกฎการเก็บรักษา เนื่องจากคุณอาจใช้กฎกับเกือบทุกคลาสในแอปพลิเคชันโดยไม่ตั้งใจ
  • อย่าใช้กฎการเก็บรักษาทั่วทั้งแพ็กเกจ เช่น -keep class com.example.pkg.** { *; } ระยะยาว ซึ่งใช้ชั่วคราวเพื่อหลีกเลี่ยงปัญหาเมื่อ กำหนดค่า R8 ได้ ดูข้อมูลเพิ่มเติมได้ที่จำกัดขอบเขตการเพิ่มประสิทธิภาพ โดยทั่วไปแล้ว ให้ระมัดระวังการใช้ไวลด์การ์ด และตรวจสอบว่าคุณเก็บเฉพาะโค้ดที่จำเป็นเท่านั้น

หากทำตามกฎเหล่านี้ไม่ได้ คุณอาจใช้การสะท้อนแบบปลายเปิดมากเกินไป และควรหลีกเลี่ยงการสะท้อนหรือหลีกเลี่ยงการใช้ไลบรารีที่ใช้การสะท้อน (ดูกรณีศึกษาของ Gson)