ระบบบิลด์ของ 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 ไฟล์:
Kotlin
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 ขั้นต่ำที่จำเป็น |
|---|---|
| 8.5 | 8.7 |
| 8.4 | 8.6 |
| 8.3 | 8.4 |
| 8.2 | 8.2 |
| 8.1 | 8.0 |
| 8.0 | 8.0 |
| 7.4 | 7.5 |
เวอร์ชันเก่า
| เวอร์ชันปลั๊กอิน | เวอร์ชัน Gradle ที่ต้องระบุ |
|---|---|
| 7.3 | 7.4 |
| 7.2 | 7.3.3 |
| 7.1 | 7.2 |
| 7.0 | 7.0 |
| 4.2.0 ขึ้นไป | 6.7.1 |
| 4.1.0 ขึ้นไป | 6.5 ขึ้นไป |
| 4.0.0 ขึ้นไป | 6.1.1 ขึ้นไป |
| 3.6.0 - 3.6.4 | 5.6.4 ขึ้นไป |
| 3.5.0 - 3.5.4 | 5.4.1 ขึ้นไป |
| 3.4.0 - 3.4.3 | 5.1.1 ขึ้นไป |
| 3.3.0 - 3.3.3 | 4.10.1 ขึ้นไป |
| 3.2.0 - 3.2.1 | 4.6 ขึ้นไป |
| 3.1.0 ขึ้นไป | 4.4 ขึ้นไป |
| 3.0.0 ขึ้นไป | 4.1 ขึ้นไป |
| 2.3.0 ขึ้นไป | 3.3 ขึ้นไป |
| 2.1.3 - 2.2.3 | 2.14.1 - 3.5 |
| 2.0.0 - 2.1.2 | 2.10 - 2.13 |
| 1.5.0 | 2.2.1 - 2.13 |
| 1.2.0 - 1.3.1 | 2.2.1 - 2.9 |
| 1.0.0 - 1.1.3 | 2.2.1 - 2.3 |
คุณระบุเวอร์ชัน 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 Studio | เวอร์ชัน AGP ที่จำเป็น |
|---|---|
| แมลงเต่าทอง | 1.2.2024 | 3.2-8.7 |
| เปิดตัวฟีเจอร์โคอาล่า | 2.1.2024 | 3.2-8.6 |
| โคอาลา | 1.1.2024 | 3.2-8.5 |
| แมงกะพรุน | 1.3.2023 | 3.2-8.4 |
| อีกัวน่า | 1.2.2023 | 3.2-8.3 |
| เม่น | 1.1.2023 | 3.2-8.2 |
| ยีราฟ 1.3.2022 | 3.2-8.1 |
| ฟลามิงโก | 1.2.2022 | 3.2-8.0 |
เวอร์ชันเก่า
| เวอร์ชันของ Android Studio | เวอร์ชัน AGP ที่จำเป็น |
|---|---|
| ปลาไหลไฟฟ้า | 1.1.2022 | 3.2-7.4 |
| โลมา | 1.3.2021 | 3.2-7.3 |
| ชิปมังก์ | 1.2.2021 | 3.2-7.2 |
| ผึ้งบัมเบิลบี | 1.1.2021 | 3.2-7.1 |
| หมาจิ้งจอกอาร์กติก | 1.3.2020 | 3.1-7.0 |
สำหรับข้อมูลว่ามีอะไรใหม่ในปลั๊กอิน Android Gradle โปรดดูที่ บันทึกประจำรุ่นของปลั๊กอิน Android Gradle
เวอร์ชันขั้นต่ำของเครื่องมือสำหรับระดับ API ของ Android
Android Studio และ AGP เวอร์ชันขั้นต่ำที่รองรับ API ที่เฉพาะเจาะจง
ใช้ Android Studio หรือ AGP เวอร์ชันต่ำกว่าที่
targetSdk หรือ compileSdk ของโปรเจ็กต์อาจทำให้เกิดปัญหาที่ไม่คาดคิด พ
ขอแนะนำให้ใช้ Android Studio และ AGP เวอร์ชันตัวอย่างล่าสุดในการทำงาน
โปรเจ็กต์ที่กำหนดเป้าหมายเป็นระบบปฏิบัติการ Android เวอร์ชันตัวอย่าง คุณสามารถ
ติดตั้ง
เวอร์ชันตัวอย่างของ Android Studio ควบคู่กับเวอร์ชันเสถียร
เวอร์ชันขั้นต่ำของ Android Studio และ AGP มีดังนี้
| ระดับ API | เวอร์ชัน Android Studio ขั้นต่ำ | เวอร์ชัน AGP ขั้นต่ำ |
|---|---|---|
| ดูตัวอย่าง VanillaIceCream | แมงกะพรุน | 1.3.2023 | 8.4 |
| 34 | เม่น | 1.1.2023 | 8.1.1 |
| 33 | ฟลามิงโก | 1.2.2022 | 7.2 |
การเปลี่ยนแปลงการกำหนดเวอร์ชัน (พฤศจิกายน 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 ข้อมูลอื่นๆ เกี่ยวกับความเข้ากันได้มีดังนี้