เกี่ยวกับปลั๊กอิน Android Gradle

ระบบบิลด์ของ Android Studio อิงตาม Gradle และปลั๊กอิน Android Gradle จะเพิ่มฟีเจอร์หลายอย่างที่เฉพาะเจาะจงสำหรับการสร้างแอป Android

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

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

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

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

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

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

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

Kotlin

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

ดึงดูด

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

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

อัปเดต Gradle

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

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

เวอร์ชันปลั๊กอินเวอร์ชัน Gradle ขั้นต่ำที่จำเป็น
9.59.6.0
9.49.6.0
9.39.5.0
9.29.4.1
9.19.3.1
9.09.1.0
8.138.13
8.128.13
8.118.13
8.108.11.1
8.98.11.1
8.88.10.2
8.78.9
8.68.7
8.58.7
8.48.6
8.38.4
8.28.2
8.18.0
8.08.0

เวอร์ชันก่อนหน้า

เวอร์ชันปลั๊กอินเวอร์ชัน Gradle ที่จำเป็น
7.47.5
7.37.4
7.27.3.3
7.17.2
7.07.0
4.2.0 ขึ้นไป6.7.1
4.1.0 ขึ้นไป6.5+
4.0.0 ขึ้นไป6.1.1 ขึ้นไป
3.6.0 - 3.6.45.6.4 ขึ้นไป
3.5.0 - 3.5.45.4.1 ขึ้นไป
3.4.0 - 3.4.35.1.1 ขึ้นไป
3.3.0 - 3.3.34.10.1 ขึ้นไป
3.2.0 - 3.2.14.6+
3.1.0 ขึ้นไป4.4+
3.0.0 ขึ้นไป4.1+
2.3.0 ขึ้นไป3.3+
2.1.3 - 2.2.32.14.1 - 3.5
2.0.0 - 2.1.22.10 - 2.13
1.5.02.2.1 - 2.13
1.2.0 - 1.3.12.2.1 - 2.9
1.0.0 - 1.1.32.2.1 - 2.3

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

gradle wrapper --gradle-version 9.6.0

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

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

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

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

เวอร์ชัน Android Studio เวอร์ชัน AGP ที่จำเป็น
Rabbit 2 | 2026.2.2 7.1-9.5
Rabbit 1 | 2026.2.1 7.1-9.4
Quail 4 | 2026.1.4 7.1-9.4
Quail 3 | 2026.1.3 7.1-9.3
Quail 2 | 2026.1.2 7.1-9.3
Quail 1 | 2026.1.1 7.1-9.2
Panda 4 | 2025.3.4 7.1-9.2
Panda 3 | 2025.3.3 7.0-9.1
Panda 2 | 2025.3.2 7.0-9.1
Panda 1 | 2025.3.1 7.0-9.0
การอัปเดตฟีเจอร์ใหม่ของ Otter 3 | 2025.2.3 4.2-9.0
การอัปเดตฟีเจอร์ใหม่ของ Otter 2 | 2025.2.2 4.1-8.13
Otter | 2025.2.1 4.0-8.13
ฟีเจอร์ใหม่จาก Narwhal 4 | 2025.1.4 4.0-8.13
การอัปเดตฟีเจอร์ใหม่ของ Narwhal 3 | 2025.1.3 4.0-8.13
การอัปเดตฟีเจอร์ Narwhal | 2025.1.2 4.0-8.12
Narwhal | 2025.1.1 3.2-8.11
การอัปเดตฟีเจอร์ใหม่ Meerkat | 2024.3.2 3.2-8.10
Meerkat | 2024.3.1 3.2-8.9

เวอร์ชันเก่า

เวอร์ชัน Android Studio เวอร์ชัน AGP ที่จำเป็น
การอัปเดตฟีเจอร์ใหม่ Ladybug | 2024.2.2 3.2-8.8
Ladybug | 2024.2.1 3.2-8.7
การอัปเดตฟีเจอร์ใหม่ Koala | 2.1.2024 3.2-8.6
Koala | 2024.1.1 3.2-8.5
Jellyfish | 2023.3.1 3.2-8.4
Iguana | 2023.2.1 3.2-8.3
Hedgehog | 2023.1.1 3.2-8.2
Giraffe | 2022.3.1 3.2-8.1
Flamingo | 2022.2.1 3.2-8.0
Electric Eel | 2022.1.1 3.2-7.4
Dolphin | 2021.3.1 3.2-7.3
Chipmunk | 2021.2.1 3.2-7.2
Bumblebee | 2021.1.1 3.2-7.1
Arctic Fox | 2020.3.1 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 ขั้นต่ำ
37.0 Panda 3 | 2025.3.3 Patch 1 9.1.1
36.1 การอัปเดตฟีเจอร์ใหม่ของ Narwhal 3 | 2025.1.3 8.13.0
36 Meerkat | 2024.3.1 Patch 1 8.9.1
35 การอัปเดตฟีเจอร์ใหม่ Koala | 2024.2.1 8.6.0
34 Hedgehog | 2023.1.1 8.1.1
33 Flamingo | 2022.2.1 7.2