ปลั๊กอิน Android Gradle 8.1.0 (กรกฎาคม 2023)

ปลั๊กอิน Android Gradle 8.1.0 เป็นเวอร์ชันสำคัญที่มีฟีเจอร์ใหม่ๆ มากมาย ฟีเจอร์และการปรับปรุงต่างๆ

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

Kotlin DSL เป็นค่าเริ่มต้นสำหรับการกำหนดค่าบิลด์

ตอนนี้โปรเจ็กต์ใหม่ใช้ Kotlin DSL (build.gradle.kts) โดยค่าเริ่มต้นสําหรับบิลด์ การกำหนดค่า ฟีเจอร์นี้จะมอบประสบการณ์การตัดต่อที่ดีกว่า Groovy DSL (build.gradle) ที่มีการไฮไลต์ไวยากรณ์ การเติมโค้ด และการไปยัง ประกาศ โปรดทราบว่าหากใช้ AGP 8.1 และ Kotlin DSL สำหรับบิลด์ คุณควรใช้ Gradle 8.1 เพื่อประสบการณ์การใช้งานที่ดีที่สุด หากต้องการทราบข้อมูลเพิ่มเติม โปรดดูคำแนะนำในการย้ายข้อมูล Kotlin DSL

การสนับสนุนภาษาต่อแอปโดยอัตโนมัติ

ตั้งแต่ Android Studio Giraffe Canary 7 และ AGP 8.1.0-alpha07 คุณจะทำสิ่งต่อไปนี้ได้ กำหนดค่าแอปของคุณให้รองรับภาษาของแต่ละแอป การตั้งค่าเริ่มต้นโดยอัตโนมัติ อิงตาม ทรัพยากรของโปรเจ็กต์, ปลั๊กอิน Android Gradle สร้างไฟล์ LocaleConfig และเพิ่มการอ้างอิงไปยังไฟล์นี้ในไฟล์ Manifest สุดท้าย คุณจึงไม่ต้อง ด้วยตนเองก็ได้ AGP ใช้ทรัพยากรในโฟลเดอร์ res ของโมดูลแอป และทรัพยากร Dependency ของโมดูลไลบรารีทั้งหมดเพื่อกําหนดภาษาที่จะรวมไว้ในไฟล์ LocaleConfig

โปรดทราบว่าฟีเจอร์ภาษาที่ใช้ในแอปอัตโนมัติรองรับแอปที่ใช้ Android 13 (API ระดับ 33) ขึ้นไป หากต้องการใช้ฟีเจอร์นี้ คุณต้องตั้งค่า compileSdkVersion ถึง 33 ขึ้นไป วิธีกำหนดค่ากำหนดภาษาของแต่ละแอป สำหรับ Android เวอร์ชันก่อนหน้า คุณยังต้อง ใช้ API และเครื่องมือเลือกภาษาในแอป

หากต้องการเปิดใช้การรองรับภาษาต่อแอปโดยอัตโนมัติ ให้ระบุภาษาเริ่มต้นดังนี้

1. ในโฟลเดอร์ res ของโมดูลแอป ให้สร้างไฟล์ใหม่ชื่อ resources.properties

2. ในไฟล์ resources.properties ให้ตั้งค่าภาษาเริ่มต้นด้วย ป้ายกำกับ unqualifiedResLocale ในการสร้างชื่อภาษา ให้รวม รหัสภาษาที่มีสคริปต์และรหัสภูมิภาคซึ่งไม่บังคับ โดยคั่นแต่ละรายการ ด้วยเครื่องหมายขีดกลาง:

   • ภาษา: ใช้ตัวอักษร 2 หรือ 3 ตัว ISO 639-1 โค้ด
   • สคริปต์ (ไม่บังคับ): ใช้ ISO 15924
   • ภูมิภาค (ไม่บังคับ): ใช้ตัวอักษร 2 ตัว ISO 3166-1-alpha-2 หรือรหัส 3 หลัก UN_M.49 โค้ด

   ตัวอย่างเช่น หากภาษาเริ่มต้นเป็นอังกฤษแบบอเมริกัน

       unqualifiedResLocale=en-US
       

AGP จะเพิ่มภาษาเริ่มต้นนี้และภาษา ภูมิภาคอื่น ที่คุณระบุไว้ โดยใช้ไดเรกทอรี values-* ในโฟลเดอร์ res ไปยังส่วน LocaleConfig ที่สร้างขึ้นโดยอัตโนมัติ

การรองรับภาษาต่อแอปโดยอัตโนมัติจะปิดไว้โดยค่าเริ่มต้น หากต้องการเปิดฟีเจอร์ ใช้การตั้งค่า generateLocaleConfig ในบล็อก androidResources {} ของ ไฟล์ build.gradle.kts ระดับโมดูล (build.gradle ไฟล์หากคุณใช้ น่าสนใจ):

android {
  androidResources {
    generateLocaleConfig = true
  }
}

android {
  androidResources {
    generateLocaleConfig true
  }
}

Android Lint มีไบต์โค้ดที่กำหนดเป้าหมายเป็น JVM 17

ตั้งแต่ AGP 8.1.0-alpha04 เป็นต้นไป Android Lint มีไบต์โค้ดที่กำหนดเป้าหมายเป็น JVM 17. ถ้าคุณเขียนการตรวจสอบ Lint แบบกำหนดเอง คุณจะต้องคอมไพล์ด้วย JDK 17 ขึ้นไป และระบุ jvmTarget = '17' ในตัวเลือกคอมไพเลอร์ Kotlin

หากต้องการเรียนรู้เพิ่มเติมเกี่ยวกับเครื่องมือ Lint โปรดดูที่ ปรับปรุงโค้ดโดยใช้ Lint ตรวจสอบ

ย้ายการตั้งค่าการบีบอัดไลบรารีแบบเนทีฟไปยัง DSL แล้ว

เริ่มตั้งแต่ AGP 8.1.0-alpha10 คุณจะได้รับคำเตือนหากไม่กำหนดค่า การบีบอัดไลบรารีแบบเนทีฟโดยใช้ DSL แทนไฟล์ Manifest คำแนะนำต่อไปนี้อธิบายวิธีอัปเดตการกำหนดค่าเพื่อใช้ DSL ถึง รับความช่วยเหลือในการอัปเดตเหล่านี้ ใช้ AGP Upgrade Assistant (เครื่องมือ > AGP Upgrade Assistant)

หากต้องการใช้ไลบรารีเนทีฟที่ไม่ได้บีบอัด ให้นำ android::extractNativeLibs ออก จากไฟล์ Manifest และเพิ่มโค้ดต่อไปนี้ในระดับโมดูล build.gradle.kts ไฟล์ (build.gradle ไฟล์หากคุณใช้ Groovy):

android {
  packagingOptions {
    jniLibs {
      useLegacyPackaging = false
    }
  }
}

android {
  packagingOptions {
    jniLibs {
      useLegacyPackaging false
    }
  }
}

แฟล็กบิลด์ทดลอง

รายการเหล่านี้เป็นแฟล็กทดลองสำหรับการกำหนดค่าบิลด์ที่พร้อมใช้งานใน AGP 8.1