บันทึกประจำรุ่นสำหรับตัวอย่างปลั๊กอิน Android Gradle

หน้านี้มีบันทึกประจำรุ่นสำหรับการเปิดตัว Android Gradle Plugin (AGP) เวอร์ชันตัวอย่าง

ปลั๊กอิน Android Gradle 9.0

ปลั๊กอิน Android Gradle 9.0 เป็น AGP เวอร์ชันหลักรุ่นใหม่ และมีการเปลี่ยนแปลง API และ ลักษณะการทำงาน

หากต้องการอัปเดตเป็นปลั๊กอิน Android Gradle 9.0.0-alpha04 ให้ใช้ Android Gradle plugin Upgrade Assistant ใน Android Studio Narwhal 4 Feature Drop | 2025.1.4

ผู้ช่วยการอัปเกรด AGP จะช่วยรักษาลักษณะการทำงานที่มีอยู่เมื่ออัปเกรดโปรเจ็กต์ในกรณีที่เหมาะสม ซึ่งจะช่วยให้คุณอัปเกรดโปรเจ็กต์เพื่อใช้ AGP 9.0 ได้ แม้ว่าคุณจะยังไม่พร้อมที่จะใช้ค่าเริ่มต้นใหม่ทั้งหมดใน AGP 9.0 ก็ตาม

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

ระดับ API สูงสุดของ Android ที่ปลั๊กอิน Android Gradle 9.0.0-alpha04 รองรับคือระดับ API 36

ปลั๊กอิน Android Gradle 9.0.0-alpha04 ต้องใช้ Gradle 9.0.0

ตอนนี้การติดตั้งใช้งาน DSL ภายในและ API ของตัวแปรที่เลิกใช้งานแล้วต้องมีการเลือกใช้อย่างชัดเจน

ตอนนี้ปลั๊กอิน Android Gradle มีพื้นผิว API ที่กำหนดไว้แล้ว โดยมี API ที่รองรับ ซึ่งกำหนดไว้ในcom.android.tools.build:gradle-apiอาร์ติแฟกต์ Maven

เพื่อความเข้ากันได้กับปลั๊กอินไบนารีและสคริปต์บิลด์ที่มีอยู่ การใช้งาน DSL ก่อนหน้าซึ่งมีมาก่อน API ที่กำหนดไว้จะยังคงแสดงโดยค่าเริ่มต้นใน AGP 8.13 และต่ำกว่า ซึ่งจะช่วยให้โค้ดในปลั๊กอิน Gradle และสคริปต์บิลด์เข้าถึงได้ทั้งรายละเอียดการใช้งานภายในของ DSL รวมถึง API android.applicationVariants, android.libraryVariants, android.testVariants และ android.unitTestVariants ที่เลิกใช้งานแล้ว ซึ่ง จะถูกนำออกในปี 2026 ใน AGP 10

เพื่อทำให้การเปลี่ยนผ่านนี้ชัดเจนยิ่งขึ้น ทั้ง API ของตัวแปรเดิม และ DSL ภายในจะเข้าถึงไม่ได้โดยค่าเริ่มต้น Android Gradle ปลั๊กอิน 9.0.0-alpha04

คุณเลือกกลับมาใช้ API ที่เลิกใช้งานแล้วได้โดยการตั้งค่า android.newDsl=false ใน gradle.properties

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

Kotlin ในตัว

ปลั๊กอิน Android Gradle 9 มีการรองรับในตัวสำหรับการคอมไพล์ Kotlin ซึ่งจะแทนที่ปลั๊กอิน Kotlin ที่ใช้แยกกัน ซึ่งจะช่วยลดความซับซ้อน ในการผสานรวมกับ AGP โดยหลีกเลี่ยงการใช้ API ที่เลิกใช้งานแล้ว และปรับปรุงประสิทธิภาพในบางกรณี

ปลั๊กอิน Android Gradle 9 มีทรัพยากร Dependency รันไทม์ในปลั๊กอิน Kotlin Gradle 2.2.0 ซึ่งเป็นเวอร์ชันขั้นต่ำที่จำเป็นสำหรับการรองรับ Kotlin ในตัว

คุณเลือกไม่ใช้ Kotlin ในตัวได้โดยการตั้งค่า android.builtInKotlin=false หากเลือกไม่ใช้และยังต้องใช้ปลั๊กอิน Kotlin Gradle เวอร์ชันเก่า คุณสามารถบังคับลดเวอร์ชันได้

buildscript {
    dependencies {
        classpath("org.jetbrains.kotlin:kotlin-gradle-plugin") {
            version { strictly("2.0.0") } // or another version that you want to use
        }
    }
}

การเปลี่ยนแปลงลักษณะการทำงาน

ปลั๊กอิน Android Gradle 9.0 มีลักษณะการทํางานใหม่ดังนี้

AGP 9.0 มีการอัปเดตค่าเริ่มต้นของพร็อพเพอร์ตี้ Gradle ต่อไปนี้ ซึ่งจะช่วยให้คุณเลือกที่จะคงลักษณะการทำงานของ AGP 8.13 ไว้เมื่ออัปเกรดได้

android {
  buildFeatures {
    shaders = true
  }
}

ฟีเจอร์ที่นำออกแล้ว

ปลั๊กอิน Android Gradle 9.0 จะนำฟังก์ชันต่อไปนี้ออก

• การรองรับแอป Wear OS ที่ฝัง
  AGP 9.0 จะนำการรองรับการฝังแอป Wear OS ออก ซึ่ง Play ไม่รองรับอีกต่อไป ซึ่งรวมถึงการนำwearAppการกำหนดค่าและ AndroidSourceSet.wearAppConfigurationName DSL ออก ดูวิธีเผยแพร่แอปไปยัง Wear OS ได้ที่หัวข้อเผยแพร่ไปยัง Wear OS
• androidDependencies และsourceSetsรายงานงาน

DSL ที่เปลี่ยนแปลง

ปลั๊กอิน Android Gradle 9.0 มีการเปลี่ยนแปลง DSL ที่ส่งผลกับส่วนอื่นดังนี้

• นำการกำหนดพารามิเตอร์ของ CommonExtension ออกแล้ว

  การเปลี่ยนแปลงที่ทําให้เกิดข้อขัดข้องนี้เป็นเพียงการเปลี่ยนแปลงระดับแหล่งที่มาเพื่อช่วยหลีกเลี่ยงการเปลี่ยนแปลงที่ทําให้เกิดข้อขัดข้องระดับแหล่งที่มาในอนาคต แต่ก็หมายความว่าต้องย้ายเมธอดบล็อกจาก CommonExtension ไปยัง ApplicationExtension, LibraryExension, DynamicFeatureExtension และ TestExtension

  เมื่ออัปเกรดโปรเจ็กต์เป็น AGP 9.0 ให้ปรับโครงสร้างโค้ดปลั๊กอิน Gradle ซึ่งใช้พารามิเตอร์หรือเมธอดบล็อกเหล่านั้น ตัวอย่างเช่น ระบบจะอัปเดตปลั๊กอินต่อไปนี้เพื่อนำพารามิเตอร์ประเภทออกและไม่ใช้เมธอดบล็อกที่นำออก

  AGP 8.13

  val commonExtension: CommonExtension<*, *, *, *, *, *> =
          extensions.getByType(CommonExtension::class)
  commonExtension.apply {
      defaultConfig {
          minSdk {
              version = release(28)
          }
      }
  }
  

  AGP 9.0

  val commonExtension: CommonExtension =
          extensions.getByType(CommonExtension::class)
  commonExtension.apply {
      defaultConfig.apply {
          minSdk {
              version = release(28)
          }
      }
  }
  

  สำหรับปลั๊กอินที่กำหนดเป้าหมายเป็น AGP เวอร์ชันต่างๆ การใช้ตัวรับโดยตรง จะเข้ากันได้แบบไบนารีกับ AGP เวอร์ชันที่ต่ำกว่า 9.0

DSL ที่นำออกแล้ว

ปลั๊กอิน Android Gradle 9.0 จะนำสิ่งต่อไปนี้ออก

• AndroidSourceSet.jni เนื่องจากใช้งานไม่ได้

• AndroidSourceSet.wearAppConfigurationName เนื่องจากเกี่ยวข้องกับ การนำการรองรับแอป Wear OS แบบฝังออก

• BuildType.isRenderscriptDebuggable เนื่องจากใช้งานไม่ได้

• ComponentBuilder.enabled โดยจะแทนที่ด้วย ComponentBuilder.enable

• DependencyVariantSelection โดยจะแทนที่ด้วย DependencySelection ซึ่งแสดงเป็น kotlin.android

• Installation.installOptions(String) โดยจะแทนที่ด้วย พร็อพเพอร์ตี้ที่เปลี่ยนแปลงได้ของ Installation.installOptions

• VariantBuilder.targetSdk และ targetSdkPreview เนื่องจากไม่มีความหมายในคลัง โปรดใช้ GeneratesApkBuilder.targetSdk หรือ GeneratesApkBuilder.targetSdkPreview แทน

• บล็อก PostProcessing ที่อยู่ในขั้นทดลองแต่ไม่เคยมีเสถียรภาพ

• ProductFlavor.setDimension ซึ่งถูกแทนที่ด้วยพร็อพเพอร์ตี้ dimension

• LanguageSplitOptions ซึ่งมีประโยชน์เฉพาะสำหรับ Google Play Instant ซึ่งเลิกใช้งานแล้ว

• Variant.unitTest เนื่องจากใช้กับปลั๊กอิน com.android.test ไม่ได้ unitTest พร้อมใช้งานในประเภทย่อยของ VariantBuilder ที่ขยาย HasUnitTest

• VariantBuilder.enableUnitTest เนื่องจากใช้กับปลั๊กอิน com.android.test ไม่ได้ enableUnitTest พร้อมใช้งานในประเภทย่อยของ VariantBuilder ที่ขยาย HasUnitTestBuilder

• เราจะนำ VariantBuilder.unitTestEnabled ออกเพื่อใช้ enableUnitTest ที่มีชื่อ สอดคล้องกัน มากขึ้นในVariantBuilderประเภทย่อย ที่ขยาย HasUnitTestBuilder

พร็อพเพอร์ตี้ Gradle ที่นำออก

เดิมทีเราได้เพิ่มพร็อพเพอร์ตี้ Gradle ต่อไปนี้เป็นวิธีปิดใช้ฟีเจอร์ที่เปิดใช้โดยค่าเริ่มต้นทั่วโลก

ฟีเจอร์เหล่านี้ปิดใช้งานอยู่โดยค่าเริ่มต้นตั้งแต่ AGP 8.0 หรือต่ำกว่า เปิดใช้ ฟีเจอร์เหล่านี้ในโปรเจ็กต์ย่อยที่ใช้ฟีเจอร์เหล่านี้เท่านั้นเพื่อการสร้างที่มีประสิทธิภาพมากขึ้น

android {
  buildFeatures {
    aidl = true
  }
}

android {
  buildFeatures {
    renderScript = true
  }
}

API ที่นำออก

ปลั๊กอิน Android Gradle 9.0 จะนำสิ่งต่อไปนี้ออก

• BaseExtension.registerTransform API ที่เลิกใช้งานและปิดใช้แล้ว ซึ่ง ยังคงมีไว้เพื่ออนุญาตให้คอมไพล์กับ AGP เวอร์ชันล่าสุดขณะ กำหนดเป้าหมายการทำงานบน AGP 4.2 หรือต่ำกว่า

พร็อพเพอร์ตี้ Gradle ที่บังคับใช้

AGP 9.0 จะแสดงข้อผิดพลาดหากคุณตั้งค่าพร็อพเพอร์ตี้ Gradle ต่อไปนี้

ผู้ช่วยอัปเกรดปลั๊กอิน Android Gradle จะไม่อัปเกรดโปรเจ็กต์เป็น AGP 9.0 ที่ใช้พร็อพเพอร์ตี้เหล่านี้