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

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

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

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

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

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

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

android skills add agp-9-upgrade

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

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

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

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

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

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

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

อัปเดต Gradle

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

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

คุณระบุเวอร์ชัน 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 Gradle ได้ที่บันทึกประจำรุ่นของปลั๊กอิน Android Gradle

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

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

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