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

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

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

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

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

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

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

android skills add --skill agp-9-upgrade

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

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

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

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

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

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

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

อัปเดต Gradle

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

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

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

gradle wrapper --gradle-version 9.5.0

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

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

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

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

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

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

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

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