บันทึกประจำรุ่นของปลั๊กอิน Android Gradle 8.6

ระบบบิลด์ของ Android Studio อิงตาม Gradle และ Android Gradle ปลั๊กอิน เพิ่มคุณลักษณะหลายอย่างสำหรับการสร้างแอปพลิเคชัน Android โดยเฉพาะ แม้ว่า โดยทั่วไปแล้ว ปลั๊กอิน Android Gradle (AGP) จะอัปเดตในขั้นตอนการล็อกด้วย Android Studio, ปลั๊กอิน (และส่วนอื่นๆ ของระบบ Gradle) สามารถทำงานเป็นอิสระจาก Android Studio และอัปเดตแยกกัน

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

หากต้องการดูสิ่งที่แก้ไขแล้วในปลั๊กอิน Android Gradle เวอร์ชันนี้ โปรดดู ปัญหาที่ปิดไปแล้ว

หากต้องการดูข้อมูลสรุประดับสูงเกี่ยวกับการเปลี่ยนแปลงที่กำลังจะเกิดขึ้นใน Android Gradle โปรดดู Android แผนกลยุทธ์ปลั๊กอิน Gradle

หากต้องการทราบรายละเอียดเกี่ยวกับวิธีกำหนดค่าบิลด์ของ Android ด้วย Gradle โปรดดูหน้าต่อไปนี้

• กำหนดค่าบิลด์
• ข้อมูลอ้างอิง DSL สำหรับปลั๊กอิน Android Gradle
• เอกสารอ้างอิง DSL ของ Gradle
• คู่มือผู้ใช้เกี่ยวกับประสิทธิภาพ Gradle

สำหรับข้อมูลเพิ่มเติมเกี่ยวกับระบบบิลด์ Gradle โปรดดูที่ คู่มือผู้ใช้ Gradle

อัปเดตปลั๊กอิน Android Gradle

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

คุณสามารถระบุเวอร์ชันของปลั๊กอินใน ไฟล์ > โครงการ โครงสร้าง > เมนูโปรเจ็กต์ใน Android Studio หรือ ไฟล์ build.gradle.kts ระดับบนสุด เวอร์ชันปลั๊กอินจะใช้กับ โมดูลทั้งหมดที่สร้างขึ้นในโปรเจ็กต์ Android Studio ดังกล่าว ชุดตัวอย่างต่อไปนี้ ปลั๊กอินไปยังเวอร์ชัน 8.6.0 จาก build.gradle.kts ไฟล์:

plugins {
    id("com.android.application") version "8.6.0" apply false
    id("com.android.library") version "8.6.0" apply false
    id("org.jetbrains.kotlin.android") version "2.0.20" apply false
}

plugins {
    id 'com.android.application' version '8.6.0' apply false
    id 'com.android.library' version '8.6.0' apply false
    id 'org.jetbrains.kotlin.android' version '2.0.20' apply false
}

ข้อควรระวัง: คุณไม่ควรใช้ทรัพยากร Dependency แบบไดนามิกในเวอร์ชัน ตัวเลข เช่น 'com.android.tools.build:gradle:8.6.+' การใช้ฟีเจอร์นี้อาจทำให้อัปเดตเวอร์ชันที่ไม่คาดคิดและเกิดปัญหา กำลังแก้ปัญหาความแตกต่างของเวอร์ชัน

หากยังไม่ได้ดาวน์โหลดปลั๊กอินเวอร์ชันที่ระบุ Gradle จะดาวน์โหลดปลั๊กอินนั้น ครั้งต่อไปที่คุณสร้างโปรเจ็กต์หรือคลิกไฟล์ > ซิงค์โปรเจ็กต์กับไฟล์ Gradle จากแถบเมนูของ Android Studio

อัปเดต Gradle

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

ตารางต่อไปนี้แสดงเวอร์ชันของ Gradle ที่จำเป็นสำหรับแต่ละเวอร์ชัน ของปลั๊กอิน Android Gradle เพื่อประสิทธิภาพที่ดีที่สุด คุณควร ใช้ทั้ง Gradle และปลั๊กอินเวอร์ชันล่าสุดที่เป็นไปได้

คุณระบุเวอร์ชัน Gradle ได้ในไฟล์ > โครงสร้างของโครงการ > เมนูโปรเจ็กต์ใน Android Studio, หรืออัปเดตเวอร์ชัน Gradle โดยใช้บรรทัดคำสั่ง วิธีที่แนะนำคือการใช้ Wrapper ของ Gradle เครื่องมือบรรทัดคำสั่ง ซึ่งอัปเดตสคริปต์ gradlew ดังต่อไปนี้ ตัวอย่าง ตั้งค่าเวอร์ชัน Gradle เป็น 8.6 โดยใช้ Wrapper ของ Gradle โปรดทราบว่าคุณต้องเรียกใช้คำสั่งนี้สองครั้งเพื่ออัปเกรดทั้ง Gradle และ Gradle Wrapper เอง (สำหรับข้อมูลเพิ่มเติม โปรดดู การอัปเกรด Wrapper ของ Gradle)

gradle wrapper --gradle-version 8.6

แต่อาจล้มเหลวในบางกรณี เช่น หากคุณเพิ่งอัปเดต AGP และข้อความไม่สอดคล้องกับเวอร์ชัน Gradle ปัจจุบันอีก ในกรณีนี้ คุณต้องแก้ไขการอ้างอิงการกระจาย Gradle ใน gradle/wrapper/gradle-wrapper.properties ไฟล์ ดังต่อไปนี้ ตัวอย่าง ตั้งค่าเวอร์ชัน Gradle เป็น 8.6 ใน gradle-wrapper.properties ไฟล์

...
distributionUrl = https\://services.gradle.org/distributions/gradle-8.6-bin.zip
...

Android Gradle ความเข้ากันได้กับปลั๊กอินและ Android Studio

ระบบบิลด์ของ Android Studio อิงตาม Gradle และ Android Gradle ปลั๊กอิน (AGP) เพิ่มคุณลักษณะหลายอย่างสำหรับการสร้างแอป Android โดยเฉพาะ ตารางต่อไปนี้แสดงรายการ AGP เวอร์ชันที่จำเป็นสำหรับแต่ละเวอร์ชันของ Android Studio

สำหรับข้อมูลว่ามีอะไรใหม่ในปลั๊กอิน Android Gradle โปรดดูที่ บันทึกประจำรุ่นของปลั๊กอิน Android Gradle

เวอร์ชันขั้นต่ำของเครื่องมือสำหรับระดับ API ของ Android

Android Studio และ AGP เวอร์ชันขั้นต่ำที่รองรับ API ที่เฉพาะเจาะจง ใช้ Android Studio หรือ AGP เวอร์ชันต่ำกว่าที่ targetSdk หรือ compileSdk ของโปรเจ็กต์อาจทำให้เกิดปัญหาที่ไม่คาดคิด พ ขอแนะนำให้ใช้ Android Studio และ AGP เวอร์ชันตัวอย่างล่าสุดในการทำงาน โปรเจ็กต์ที่กำหนดเป้าหมายเป็นระบบปฏิบัติการ Android เวอร์ชันตัวอย่าง คุณสามารถ ติดตั้ง เวอร์ชันตัวอย่างของ Android Studio ควบคู่กับเวอร์ชันเสถียร

เวอร์ชันขั้นต่ำของ Android Studio และ AGP มีดังนี้

การเปลี่ยนแปลงการกำหนดเวอร์ชัน (พฤศจิกายน 2020)

เรากำลังอัปเดตหมายเลขเวอร์ชันสำหรับปลั๊กอิน Android Gradle (AGP) เป็นเวอร์ชันอื่นๆ ใกล้เคียงกับเครื่องมือสร้าง Gradle พื้นฐาน

การเปลี่ยนแปลงที่สำคัญมีดังนี้

• ขณะนี้ AGP จะใช้การกำหนดเวอร์ชันทางความหมาย และการเปลี่ยนแปลงที่ส่งผลกับส่วนอื่นในระบบจะ ที่กำหนดเป้าหมายสำหรับ การเปิดตัวครั้งสำคัญ

• AGP จะออกเวอร์ชันหลัก 1 เวอร์ชันต่อปี ซึ่งสอดคล้องกับ Gradle เวอร์ชันหลัก

• รุ่นหลังจาก AGP 4.2 จะเป็นเวอร์ชัน 7.0 และจะต้องมีการอัปเกรด เป็น Gradle เวอร์ชัน 7.x. AGP ที่สำคัญทุกรุ่นจะต้องมี ในเครื่องมือ Gradle ที่เกี่ยวข้อง

• เราจะเลิกใช้งาน API ล่วงหน้าประมาณ 1 ปี โดย ฟังก์ชันทดแทนที่พร้อมใช้งาน ควบคู่กันไป API ที่เลิกใช้งานแล้ว จะถูกนำออกประมาณ 1 ปีให้หลังระหว่างการเข้าร่วมโปรแกรม อัปเดต

ความเข้ากันได้

ระดับ API สูงสุดที่ปลั๊กอิน Android Gradle 8.6 รองรับคือ API ระดับ 34 ข้อมูลอื่นๆ เกี่ยวกับความเข้ากันได้มีดังนี้