ปลั๊กอิน Android Gradle 3.6.0 (กุมภาพันธ์ 2020)
ปลั๊กอิน Android เวอร์ชันนี้ต้องใช้สิ่งต่อไปนี้
| เวอร์ชันขั้นต่ำ | เวอร์ชันเริ่มต้น | หมายเหตุ | |
|---|---|---|---|
| Gradle | 5.6.4 | 5.6.4 | ดูข้อมูลเพิ่มเติมได้ที่การอัปเดต Gradle |
| เครื่องมือสร้าง SDK | 28.0.3 | 28.0.3 | ติดตั้งหรือกำหนดค่าเครื่องมือสร้าง SDK |
การอัปเดตเล็กน้อยนี้รองรับความเข้ากันได้กับการตั้งค่าและฟีเจอร์เริ่มต้นใหม่สำหรับระดับการมองเห็นแพ็กเกจใน Android 11
ดูรายละเอียดได้ที่บันทึกประจำรุ่น 4.0.1
ฟีเจอร์ใหม่
ปลั๊กอิน Android Gradle เวอร์ชันนี้มีฟีเจอร์ใหม่ต่อไปนี้
ดูการเชื่อมโยง
การเชื่อมโยงข้อมูลพร็อพเพอร์ตี้ช่วยให้คอมไพล์ได้อย่างปลอดภัยเมื่ออ้างอิงพร็อพเพอร์ตี้ในโค้ด ตอนนี้คุณสามารถแทนที่ findViewById() ด้วยการอ้างอิงคลาสการเชื่อมโยงที่สร้างขึ้นโดยอัตโนมัติได้แล้ว หากต้องการเริ่มใช้การเชื่อมโยงมุมมอง ให้ใส่ข้อมูลต่อไปนี้ในไฟล์ build.gradle ของแต่ละโมดูล
android { viewBinding.enabled = true }
android { viewBinding.enabled = true }
ดูข้อมูลเพิ่มเติมได้ที่เอกสารประกอบเกี่ยวกับการเชื่อมโยงมุมมอง
การรองรับปลั๊กอิน Maven Publish
ปลั๊กอิน Android Gradle รองรับปลั๊กอิน Maven Publish Gradle ซึ่งช่วยให้คุณเผยแพร่อาร์ติแฟกต์บิลด์ไปยังที่เก็บ Apache Maven ได้ ปลั๊กอิน Android Gradle จะสร้างคอมโพเนนต์สำหรับอาร์ติแฟกต์ตัวแปรบิลด์แต่ละรายการในแอปหรือโมดูลไลบรารีที่คุณใช้เพื่อปรับแต่งการเผยแพร่ไปยังที่เก็บ Maven ได้
ดูข้อมูลเพิ่มเติมได้ที่หน้าเกี่ยวกับวิธีใช้ปลั๊กอิน Maven Publish
เครื่องมือการสร้างแพ็กเกจเริ่มต้นใหม่
เมื่อสร้างแอปเวอร์ชันแก้ไขข้อบกพร่อง ปลั๊กอินจะใช้เครื่องมือแพ็กเกจใหม่ที่เรียกว่า zipflinger เพื่อสร้าง APK เครื่องมือใหม่นี้จะช่วยปรับปรุงความเร็วในการสร้าง หากเครื่องมือแพ็กเกจใหม่ไม่ทำงานตามที่คาดไว้ โปรดรายงานข้อบกพร่อง คุณเปลี่ยนกลับไปใช้เครื่องมือแพ็กเกจแบบเก่าได้โดยใส่ข้อมูลต่อไปนี้ในไฟล์ gradle.properties
android.useNewApkCreator=false
การระบุแหล่งที่มาของบิลด์แบบเนทีฟ
ตอนนี้คุณสามารถกำหนดระยะเวลาที่ Clang ใช้ในการสร้างและลิงก์ไฟล์ C/C++ แต่ละไฟล์ในโปรเจ็กต์ได้แล้ว Gradle สามารถแสดงผลการติดตาม Chrome ที่มีการประทับเวลาสำหรับเหตุการณ์คอมไพเลอร์เหล่านี้ เพื่อให้คุณเข้าใจเวลาที่ต้องใช้ในการสร้างโปรเจ็กต์ได้ดียิ่งขึ้น หากต้องการแสดงผลไฟล์การระบุแหล่งที่มาของบิลด์นี้ ให้ทำดังนี้
-
เพิ่มแฟล็ก
-Pandroid.enableProfileJson=trueเมื่อเรียกใช้บิลด์ Gradle เช่นgradlew assembleDebug -Pandroid.enableProfileJson=true -
เปิดเบราว์เซอร์ Chrome แล้วพิมพ์
chrome://tracingในแถบค้นหา -
คลิกปุ่มโหลด แล้วไปที่
<var>project-root</var>/build/android-profileเพื่อค้นหาไฟล์ ไฟล์มีชื่อว่าprofile-<var>timestamp</var>.json.gz
คุณดูข้อมูลการระบุแหล่งที่มาของบิลด์แบบเนทีฟได้ที่บริเวณด้านบนของโปรแกรมดู

การเปลี่ยนแปลงพฤติกรรม
เมื่อใช้ปลั๊กอินเวอร์ชันนี้ คุณอาจพบการเปลี่ยนแปลงลักษณะการทำงานต่อไปนี้
ไลบรารีแบบเนทีฟที่แพ็กเกจแบบไม่บีบอัดโดยค่าเริ่มต้น
เมื่อคุณสร้างแอป ปลั๊กอินจะตั้งค่า extractNativeLibs เป็น "false" โดยค่าเริ่มต้น กล่าวคือ ไลบรารีแบบเนทีฟของคุณมีการจัดแนวหน้าและแพ็กเกจแบบไม่บีบอัด แม้ว่าวิธีนี้จะส่งผลให้ขนาดที่อัปโหลดใหญ่ขึ้น แต่ผู้ใช้จะได้รับประโยชน์ต่อไปนี้
- ขนาดการติดตั้งแอปเล็กลงเนื่องจากแพลตฟอร์มสามารถเข้าถึงไลบรารีแบบเนทีฟได้โดยตรงจาก APK ที่ติดตั้ง โดยไม่ต้องสร้างสำเนาของไลบรารี
- ขนาดการดาวน์โหลดที่เล็กลงเนื่องจากการบีบอัดของ Play Store มักจะดีกว่าเมื่อคุณรวมไลบรารีแบบเนทีฟที่ไม่ได้บีบอัดไว้ใน APK หรือ Android App Bundle
หากต้องการให้ปลั๊กอิน Android Gradle บีบอัดไลบรารีแบบเนทีฟแทน ให้ใส่ข้อมูลต่อไปนี้ในไฟล์ Manifest ของแอป
<application
android:extractNativeLibs="true"
... >
</application>
หมายเหตุ: แอตทริบิวต์ไฟล์ Manifest extractNativeLibs ถูกแทนที่ด้วยตัวเลือก DSL useLegacyPackaging ดูข้อมูลเพิ่มเติมได้ที่บันทึกประจำรุ่นใช้ DSL เพื่อแพ็กเกจไลบรารีแบบเนทีฟที่บีบอัด
เวอร์ชัน NDK เริ่มต้น
หากคุณดาวน์โหลด NDK หลายเวอร์ชัน ตอนนี้ปลั๊กอิน Android Gradle จะเลือกเวอร์ชันเริ่มต้นเพื่อใช้ในการคอมไพล์ไฟล์ซอร์สโค้ด
ก่อนหน้านี้ ปลั๊กอินจะเลือก NDK เวอร์ชันล่าสุดที่ดาวน์โหลด
ใช้พร็อพเพอร์ตี้ android.ndkVersion ในไฟล์ build.gradle ของโมดูลเพื่อลบล้างค่าเริ่มต้นที่ปลั๊กอินเลือกไว้
การสร้างคลาส R ที่ง่ายขึ้น
ปลั๊กอิน Android Gradle ช่วยลดความซับซ้อนของคลาสพาธการคอมไพล์โดยสร้างคลาส R เพียงคลาสเดียวสำหรับโมดูลไลบรารีแต่ละโมดูลในโปรเจ็กต์ และแชร์คลาส R เหล่านั้นกับทรัพยากร Dependency ของโมดูลอื่นๆ การเพิ่มประสิทธิภาพนี้จะช่วยให้บิลด์เร็วขึ้น แต่คุณต้องคำนึงถึงสิ่งต่อไปนี้
- เนื่องจากคอมไพเลอร์แชร์คลาส R กับทรัพยากร Dependency ของโมดูลอัปสตรีม โมดูลแต่ละรายการในโปรเจ็กต์จึงต้องใช้ชื่อแพ็กเกจที่ไม่ซ้ำกัน
- ระดับการเข้าถึงคลาส R ของไลบรารีไปยังทรัพยากร Dependency อื่นๆ ของโปรเจ็กต์จะกำหนดโดยการกำหนดค่าที่ใช้เพื่อรวมไลบรารีเป็นทรัพยากร Dependency ตัวอย่างเช่น หากไลบรารี A มีไลบรารี B เป็นทรัพยากร Dependency ของ "api" ไลบรารี A และไลบรารีอื่นๆ ที่ขึ้นอยู่กับไลบรารี A จะมีสิทธิ์เข้าถึงคลาส R ของไลบรารี B อย่างไรก็ตาม ไลบรารีอื่นๆ อาจไม่มีสิทธิ์เข้าถึงคลาส R ของไลบรารี B หากไลบรารี A ใช้การกำหนดค่าทรัพยากร Dependency
implementationดูข้อมูลเพิ่มเติมได้ที่บทความเกี่ยวกับการกำหนดค่าทรัพยากร Dependency
นำทรัพยากรที่ไม่มีอยู่ในการกำหนดค่าเริ่มต้นออก
สำหรับโมดูลไลบรารี หากคุณรวมทรัพยากรสำหรับภาษาที่ไม่ได้รวมไว้ในชุดทรัพยากรเริ่มต้น (เช่น หากคุณรวม hello_world เป็นทรัพยากรสตริงใน /values-es/strings.xml แต่ไม่ได้กำหนดทรัพยากรนั้นใน /values/strings.xml) ปลั๊กอิน Android Gradle จะไม่รวมทรัพยากรนั้นอีกต่อไปเมื่อคอมไพล์โปรเจ็กต์ การเปลี่ยนแปลงลักษณะการทำงานนี้ควรส่งผลให้มีข้อยกเว้นรันไทม์ Resource Not Found น้อยลงและความเร็วในการบิลด์ดีขึ้น
ตอนนี้ D8 จะปฏิบัติตามนโยบายการเก็บรักษา CLASS สำหรับคำอธิบายประกอบ
เมื่อคอมไพล์แอป ตอนนี้ D8 จะพิจารณาเมื่อคำอธิบายประกอบใช้นโยบายการเก็บรักษา CLASS และคำอธิบายประกอบเหล่านั้นจะใช้งานไม่ได้อีกต่อไปที่รันไทม์ ลักษณะการทำงานนี้ยังเกิดขึ้นเมื่อตั้งค่า SDK เป้าหมายของแอปเป็น API ระดับ 23 ซึ่งก่อนหน้านี้อนุญาตให้เข้าถึงคำอธิบายประกอบเหล่านี้ระหว่างรันไทม์เมื่อคอมไพล์แอปโดยใช้ปลั๊กอิน Android Gradle และ D8 เวอร์ชันเก่า
การเปลี่ยนแปลงลักษณะการทำงานอื่นๆ
-
aaptOptions.noCompressไม่คำนึงถึงตัวพิมพ์เล็กและตัวพิมพ์ใหญ่อีกต่อไปในทุกแพลตฟอร์ม (ทั้ง APK และแพ็กเกจ) และจะใช้เส้นทางที่ใช้อักขระตัวพิมพ์ใหญ่ -
ตอนนี้การเชื่อมโยงข้อมูลจะเป็นแบบเพิ่มขึ้นทีละน้อยโดยค่าเริ่มต้น ดูข้อมูลเพิ่มเติมได้ที่ปัญหา #110061530
-
ตอนนี้ Unit Test ทั้งหมด รวมถึง Unit Test ของ Roboelectric สามารถแคชได้อย่างสมบูรณ์แล้ว ดูข้อมูลเพิ่มเติมได้ที่ปัญหา #115873047
แก้ไขข้อบกพร่อง
ปลั๊กอิน Android Gradle เวอร์ชันนี้มีการแก้ไขข้อบกพร่องต่อไปนี้
- ตอนนี้ระบบรองรับการทำ Unit Test ของ Robolectric ในโมดูลไลบรารีที่ใช้การเชื่อมโยงข้อมูลแล้ว ดูข้อมูลเพิ่มเติมได้ที่ปัญหา #126775542
- ตอนนี้คุณสามารถเรียกใช้
connectedAndroidTestงานในหลายโมดูลได้ขณะที่เปิดใช้โหมดการดำเนินการพร้อมกันของ Gradle
ปัญหาที่ทราบแล้ว
ส่วนนี้จะอธิบายปัญหาที่ทราบซึ่งมีอยู่ในปลั๊กอิน Android Gradle 3.6.0
ประสิทธิภาพการทำงานของ Android Lint ช้า
Android Lint อาจใช้เวลานานกว่ามากในการดำเนินการให้เสร็จสมบูรณ์ในบางโปรเจ็กต์เนื่องจากการถดถอยในโครงสร้างพื้นฐานการแยกวิเคราะห์ ซึ่งส่งผลให้การคำนวณประเภทที่อนุมานสำหรับ Lambda ในโครงสร้างโค้ดบางอย่างช้าลง
ปัญหานี้ได้รับการรายงานเป็นข้อบกพร่องใน IDEA และจะได้รับการแก้ไขในปลั๊กอิน Android Gradle 4.0
ไม่มีคลาส Manifest {:#agp-missing-manifest}
หากแอปกำหนดสิทธิ์ที่กำหนดเองในไฟล์ Manifest โดยทั่วไปแล้วปลั๊กอิน Android Gradle จะสร้างคลาส Manifest.java ที่มีสิทธิ์ที่กำหนดเองเป็นค่าคงที่สตริง ปลั๊กอินจะรวมคลาสนี้ไว้กับแอปของคุณ เพื่อให้คุณอ้างอิงสิทธิ์เหล่านั้นได้ง่ายขึ้นขณะรันไทม์
การสร้างคลาสไฟล์ Manifest เสียหายในปลั๊กอิน Android Gradle 3.6.0
หากคุณสร้างแอปด้วยปลั๊กอินเวอร์ชันนี้และแอปอ้างอิงคลาสไฟล์ Manifest คุณอาจเห็นข้อยกเว้น ClassNotFoundException หากต้องการแก้ไขปัญหานี้ ให้ดำเนินการอย่างใดอย่างหนึ่งต่อไปนี้
-
อ้างอิงสิทธิ์ที่กำหนดเองตามชื่อที่สมบูรณ์ในตัวเอง เช่น
"com.example.myapp.permission.DEADLY_ACTIVITY" -
กำหนดค่าคงที่ของคุณเอง ดังที่แสดงด้านล่าง
public final class CustomPermissions { public static final class permission { public static final String DEADLY_ACTIVITY="com.example.myapp.permission.DEADLY_ACTIVITY"; } }