ปลั๊กอิน Android Gradle 4.2.0 (มีนาคม 2021)
ความเข้ากันได้
| เวอร์ชันขั้นต่ำ | เวอร์ชันเริ่มต้น | หมายเหตุ | |
|---|---|---|---|
| Gradle | 6.7.1 | ไม่มี | ดูข้อมูลเพิ่มเติมได้ที่การอัปเดต Gradle |
| เครื่องมือสร้าง SDK | 30.0.2 | 30.0.2 | ติดตั้งหรือกำหนดค่าเครื่องมือสร้าง SDK |
| NDK | ไม่มี | 21.4.7075529 | ติดตั้งหรือกำหนดค่า NDK เวอร์ชันอื่น |
ฟีเจอร์ใหม่
ปลั๊กอิน Android Gradle เวอร์ชันนี้มีฟีเจอร์ใหม่ดังต่อไปนี้
ภาษา Java เวอร์ชัน 8 โดยค่าเริ่มต้น
ตั้งแต่เวอร์ชัน 4.2 เป็นต้นไป AGP จะใช้ระดับภาษา Java 8 โดยค่าเริ่มต้น Java 8 ให้สิทธิ์เข้าถึงฟีเจอร์ภาษาใหม่ๆ มากมาย ซึ่งรวมถึงนิพจน์ Lambda, การอ้างอิงเมธอด และเมธอดอินเทอร์เฟซแบบคงที่ ดูรายการฟีเจอร์ที่รองรับทั้งหมดได้ในเอกสารประกอบของ Java 8
หากต้องการคงลักษณะการทำงานเดิมไว้ ให้ระบุ Java 7 อย่างชัดเจนในไฟล์ build.gradle.kts หรือ build.gradle ระดับโมดูล ดังนี้
// build.gradle
android {
...
compileOptions {
sourceCompatibility JavaVersion.VERSION_1_7
targetCompatibility JavaVersion.VERSION_1_7
}
// For Kotlin projects, compile to Java 6 instead of 7
kotlinOptions {
jvmTarget = "1.6"
}
}// build.gradle.kts
android {
...
compileOptions {
sourceCompatibility = JavaVersion.VERSION_1_7
targetCompatibility = JavaVersion.VERSION_1_7
}
// For Kotlin projects, compile to Java 6 instead of 7
kotlinOptions {
jvmTarget = "1.6"
}
}คอมไพเลอร์ทรัพยากร JVM ใหม่
คอมไพเลอร์ทรัพยากร JVM ใหม่ในปลั๊กอิน Android Gradle 4.2 จะแทนที่บางส่วนของคอมไพเลอร์ทรัพยากร AAPT2 ซึ่งอาจปรับปรุงประสิทธิภาพการบิลด์ โดยเฉพาะในเครื่อง Windows คอมไพเลอร์ทรัพยากร JVM ใหม่จะเปิดใช้โดยค่าเริ่มต้น
ตอนนี้รองรับการรับรอง v3 และ v4 แล้ว
ตอนนี้ปลั๊กอิน Android Gradle 4.2 รองรับรูปแบบการรับรอง APK v3 และ APK v4 แล้ว
หากต้องการเปิดใช้รูปแบบใดรูปแบบหนึ่งหรือทั้ง 2 รูปแบบในบิลด์ ให้เพิ่มพร็อพเพอร์ตี้ต่อไปนี้ลงในไฟล์ build.gradle หรือ build.gradle.kts ระดับโมดูล
// build.gradle
android {
...
signingConfigs {
config {
...
enableV3Signing true
enableV4Signing true
}
}
}// build.gradle.kts
android {
...
signingConfigs {
config {
...
enableV3Signing = true
enableV4Signing = true
}
}
}การรับรอง APK v4 ช่วยให้คุณติดตั้งใช้งาน APK ขนาดใหญ่ได้อย่างรวดเร็วโดยใช้การติดตั้ง APK แบบเพิ่มทีละส่วนของ ADB ใน Android 11 แฟล็กใหม่นี้จะดูแลขั้นตอนการรับรอง APK ในกระบวนการทำให้ใช้งานได้
กำหนดค่า App Signing ต่อตัวแปร
ตอนนี้คุณสามารถเปิดหรือปิดใช้ App Signing ในปลั๊กอิน Android Gradle ต่อตัวแปรได้แล้ว
ตัวอย่างนี้แสดงวิธีตั้งค่า App Signing ต่อตัวแปรโดยใช้เมธอด onVariants() ใน Kotlin หรือ Groovy
androidComponents {
onVariants(selector().withName("fooDebug")) {
signingConfig {
enableV1Signing false
enableV2Signing true
}
}
}
พร็อพเพอร์ตี้ Gradle ใหม่
android.native.buildOutput
เพื่อลดความยุ่งเหยิงในเอาต์พุตบิลด์ AGP 4.2 จะกรองข้อความจากบิลด์ C/C++ ที่ใช้ CMake และ ndk-build โดยแสดงเฉพาะเอาต์พุตคอมไพเลอร์ C/C++ โดยค่าเริ่มต้น ก่อนหน้านี้ ระบบจะสร้างบรรทัดเอาต์พุตสำหรับทุกไฟล์ที่สร้างขึ้น ซึ่งส่งผลให้มีข้อความแสดงข้อมูลจำนวนมาก
หากต้องการดูเอาต์พุต C/C++ ทั้งหมด ให้ตั้งค่าพร็อพเพอร์ตี้ Gradle ใหม่ android.native.buildOutput เป็น verbose
คุณตั้งค่าพร็อพเพอร์ตี้นี้ได้ในไฟล์ gradle.properties หรือผ่านบรรทัดคำสั่ง
gradle.properties
android.native.buildOutput=verbose
บรรทัดคำสั่ง
-Pandroid.native.buildOutput=verbose
ค่าเริ่มต้นของพร็อพเพอร์ตี้นี้คือ quiet
การเปลี่ยนแปลงลักษณะการทำงานของไฟล์ gradle.properties
ตั้งแต่ AGP 4.2 เป็นต้นไป คุณจะลบล้างพร็อพเพอร์ตี้ Gradle จากโปรเจ็กต์ย่อยไม่ได้อีกต่อไป กล่าวคือ หากคุณประกาศพร็อพเพอร์ตี้ในไฟล์ gradle.properties ในโปรเจ็กต์ย่อยแทนที่จะเป็นโปรเจ็กต์รูท ระบบจะไม่สนใจพร็อพเพอร์ตี้นั้น
ตัวอย่างเช่น ในรุ่นก่อนหน้า AGP จะอ่านค่าจาก <var>projectDir</var>/gradle.properties, <var>projectDir</var>/app/gradle.properties, <var>projectDir</var>/library/gradle.properties ฯลฯ สำหรับโมดูลแอป หากมีพร็อพเพอร์ตี้ Gradle เดียวกันทั้งใน <var>projectDir</var>/gradle.properties และ <var>projectDir</var>/app/gradle.properties ค่าจาก <var>projectDir</var>/app/gradle.properties จะมีลำดับความสำคัญเหนือกว่า
ใน AGP 4.2 ลักษณะการทำงานนี้มีการเปลี่ยนแปลง และ AGP จะไม่โหลดค่าจาก gradle.properties ในโปรเจ็กต์ย่อย (เช่น <var>projectDir</var>/app/gradle.properties) การเปลี่ยนแปลงนี้สอดคล้องกับลักษณะการทำงานใหม่ของ Gradle และรองรับการแคชการกำหนดค่า
ดูข้อมูลเพิ่มเติมเกี่ยวกับการตั้งค่าในไฟล์ gradle.properties ได้ที่เอกสารประกอบของ Gradle
การเปลี่ยนแปลงความเข้ากันได้และการกำหนดค่า Gradle
เมื่อทำงานใน Android Studio เครื่องมือสร้าง Gradle จะใช้ JDK ที่มาพร้อมกับ Studio ในรุ่นก่อนหน้า JDK 8 จะรวมมากับ Studio แต่ในเวอร์ชัน 4.2 จะรวม JDK 11 ไว้แทน เมื่อใช้ JDK ที่รวมมาใหม่เพื่อเรียกใช้ Gradle อาจส่งผลให้เกิดความไม่เข้ากันหรือส่งผลต่อประสิทธิภาพของ JVM เนื่องจากการเปลี่ยนแปลงใน Garbage Collector ปัญหาเหล่านี้มีคำอธิบายอยู่ด้านล่าง
หมายเหตุ: แม้ว่าเราจะแนะนำให้เรียกใช้ Gradle ด้วย JDK 11 แต่คุณสามารถเปลี่ยน JDK ที่ใช้เรียกใช้ Gradle ได้ในกล่องโต้ตอบโครงสร้างโปรเจ็กต์ การเปลี่ยนการตั้งค่านี้จะเปลี่ยนเฉพาะ JDK ที่ใช้เรียกใช้ Gradle และจะไม่เปลี่ยน JDK ที่ใช้เรียกใช้ Studio เอง
ความเข้ากันได้ของ Studio กับปลั๊กอิน Android Gradle (AGP)
Android Studio 4.2 สามารถเปิดโปรเจ็กต์ที่ใช้ AGP 3.1 ขึ้นไปได้ หาก AGP ใช้ Gradle 4.8.1 ขึ้นไป ดูข้อมูลเพิ่มเติมเกี่ยวกับความเข้ากันได้ของ Gradle ได้ที่อัปเดต Gradle
การเพิ่มประสิทธิภาพบิลด์ Gradle สำหรับ JDK 11
การอัปเดตเป็น JDK 11 นี้ส่งผลต่อการกำหนดค่าเริ่มต้นของ JVM Garbage Collector เนื่องจาก JDK 8 ใช้ Parallel Garbage Collector ขณะที่ JDK 11 ใช้ G1 Garbage Collector
เราขอแนะนำให้ทดสอบบิลด์ Gradle ด้วย Garbage Collector แบบขนานเพื่อปรับปรุงประสิทธิภาพของบิลด์ ใน gradle.properties ให้ตั้งค่าต่อไปนี้
org.gradle.jvmargs=-XX:+UseParallelGCหากมีตัวเลือกอื่นที่ตั้งค่าไว้แล้วในช่องนี้ ให้เพิ่มตัวเลือกใหม่ดังนี้
org.gradle.jvmargs=-Xmx1536m -XX:+UseParallelGCหากต้องการวัดความเร็วในการสร้างด้วยการกำหนดค่าต่างๆ โปรดดูสร้างโปรไฟล์บิลด์
ไฟล์ DEX ที่ไม่ได้บีบอัดใน APK เมื่อ minSdk = 28 ขึ้นไป
ตอนนี้ AGP จะแพ็กไฟล์ DEX ที่ไม่บีบอัดใน APK โดยค่าเริ่มต้นเมื่อ minSdk = 28 ขึ้นไป ซึ่งจะทำให้ขนาด APK เพิ่มขึ้น แต่จะส่งผลให้ขนาดการติดตั้งในอุปกรณ์เล็กลง และขนาดการดาวน์โหลดจะใกล้เคียงกัน
หากต้องการบังคับให้ AGP แพ็กเกจไฟล์ DEX ที่บีบอัดแทน คุณสามารถเพิ่มโค้ดต่อไปนี้ลงในไฟล์ build.gradle
android {
packagingOptions {
dex {
useLegacyPackaging true
}
}
}
ใช้ DSL เพื่อแพ็กเกจไลบรารี C/C++ ที่บีบอัด
เราขอแนะนำให้แพ็กเกจไลบรารี C/C++ ในรูปแบบที่ไม่มีการบีบอัด เนื่องจากจะส่งผลให้ขนาดการติดตั้งแอปเล็กลง ขนาดการดาวน์โหลดแอปเล็กลง และผู้ใช้โหลดแอปได้เร็วขึ้น อย่างไรก็ตาม หากต้องการให้ปลั๊กอิน Android Gradle จัดแพ็กเกจไลบรารี C/C++ ที่บีบอัดเมื่อสร้างแอป ให้ตั้งค่า useLegacyPackaging เป็น true ในไฟล์ build.gradle ของแอป ดังนี้
android {
packagingOptions {
jniLibs {
useLegacyPackaging true
}
}
}
แฟล็ก useLegacyPackaging จะแทนที่แอตทริบิวต์ไฟล์ Manifest extractNativeLibs ดูข้อมูลเบื้องหลังเพิ่มเติมได้ที่บันทึกประจำรุ่นไลบรารีแบบเนทีฟที่แพ็กเกจโดยไม่มีการบีบอัดโดยค่าเริ่มต้น