ปลั๊กอิน Android Gradle 8.0.0 (เมษายน 2023)

ปลั๊กอิน Android Gradle 8.0.0 เป็นรุ่นหลักที่มีฟีเจอร์และการปรับปรุงใหม่ๆ มากมาย

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

การเผยแพร่แพตช์

ต่อไปนี้เป็นรายการการเผยแพร่แพตช์สำหรับปลั๊กอิน Android Gradle เวอร์ชัน 8.0

ปลั๊กอิน Android Gradle 8.0.2 (พฤษภาคม 2023)

ดูรายการข้อบกพร่องที่แก้ไขแล้วใน AGP 8.0.2 ได้ที่ปัญหาที่ปิดแล้วของ Android Studio 2022.2.1

ปลั๊กอิน Android Gradle 8.0.1 (พฤษภาคม 2023)

การอัปเดตเล็กน้อยนี้มีการแก้ไขข้อบกพร่องต่อไปนี้

การเปลี่ยนแปลงที่ทำให้เกิดข้อขัดข้อง: ต้องระบุเนมสเปซในสคริปต์การสร้างระดับโมดูล

คุณต้องตั้งค่าเนมสเปซในไฟล์ build.gradle.kts ระดับโมดูล ไม่ใช่ไฟล์ Manifest คุณเริ่มใช้พร็อพเพอร์ตี้ DSL ของ namespace ได้ตั้งแต่ AGP 7.3 เป็นต้นไป โปรดดูข้อมูลเพิ่มเติมที่หัวข้อตั้งค่าเนมสเปซ

เมื่อย้ายข้อมูลไปยัง DSL เนมสเปซ โปรดระวังปัญหาต่อไปนี้

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

ดูข้อมูลเพิ่มเติมได้ที่ ความคิดเห็น #19 ของปัญหา #191813691

การเปลี่ยนแปลงที่ส่งผลต่อเวอร์ชันเก่า: ค่าเริ่มต้นของตัวเลือกการสร้าง

ตั้งแต่ AGP 8.0 เป็นต้นไป ค่าเริ่มต้นของ Flag เหล่านี้มีการเปลี่ยนแปลงเพื่อปรับปรุงประสิทธิภาพการสร้าง หากต้องการความช่วยเหลือในการปรับโค้ดให้รองรับการเปลี่ยนแปลงบางอย่างเหล่านี้ ให้ใช้เครื่องมือช่วยอัปเกรด AGP (เครื่องมือ > เครื่องมือช่วยอัปเกรด AGP) ผู้ช่วยการอัปเกรดจะแนะนำคุณเกี่ยวกับการอัปเดตโค้ดให้รองรับลักษณะการทำงานแบบใหม่หรือการตั้งค่า Flag เพื่อเก็บรักษาลักษณะการทำงานแบบเดิม

การเปลี่ยนแปลงที่ส่งผลกับส่วนอื่นในระบบ: ค่าตัวเลือกการสร้างที่บังคับใช้

ตั้งแต่ AGP 8.0 เป็นต้นไป คุณจะเปลี่ยนค่าของ Flag เหล่านี้ไม่ได้อีกต่อไป หากคุณระบุค่าเหล่านั้นในไฟล์ gradle.properties ระบบจะไม่สนใจค่าดังกล่าวและ AGP จะพิมพ์คําเตือน

Flag เวอร์ชันเสถียรใหม่สําหรับโปรไฟล์การเรียกใช้

AGP มี Flag ใหม่ android.settings.executionProfile ใช้ Flag นี้เพื่อลบล้างโปรไฟล์การเรียกใช้เริ่มต้นจาก SettingsExtension ดูข้อมูลเพิ่มเติมได้ที่เอกสารประกอบเกี่ยวกับปลั๊กอินการตั้งค่า

หากต้องการดูตัวอย่าง Flag ทดลอง โปรดดูบันทึกประจำรุ่นเวอร์ชันตัวอย่าง

ไม่รองรับการกําหนดพร็อพเพอร์ตี้แบบเลื่อนเวลาของ Kotlin

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

หมวดหมู่งานของเครื่องมือวิเคราะห์บิลด์

ตั้งแต่ Android Studio Flamingo เป็นต้นไป เครื่องมือวิเคราะห์การสร้างจะมีมุมมองเริ่มต้นใหม่สำหรับงานที่มีผลต่อระยะเวลาการสร้าง หากโปรเจ็กต์ใช้ AGP 8.0 ขึ้นไป เครื่องมือวิเคราะห์การสร้างจะจัดกลุ่มงานตามหมวดหมู่แทนที่จะแสดงทีละรายการ เช่น ระบบจะจัดกลุ่มงานสำหรับทรัพยากร Android, Kotlin หรือ Dexing ไว้ด้วยกัน แล้วจัดเรียงตามระยะเวลาการสร้าง วิธีนี้ช่วยให้ทราบได้ง่ายว่าหมวดหมู่ใดส่งผลต่อเวลาสร้างมากที่สุด การขยายแต่ละหมวดหมู่จะแสดงรายการงานที่เกี่ยวข้อง หากต้องการแสดงงานทีละรายการโดยไม่มีการจัดกลุ่ม ให้ใช้เมนูแบบเลื่อนลงจัดกลุ่มตาม

ปลั๊กอินการตั้งค่าใหม่

AGP 8.0.0-alpha09 เปิดตัวปลั๊กอินการตั้งค่าใหม่ ปลั๊กอินการตั้งค่าช่วยให้คุณรวมการกําหนดค่าส่วนกลาง (การกําหนดค่าที่ใช้กับโมดูลทั้งหมด) ไว้ในที่เดียวได้ คุณจึงไม่ต้องคัดลอกและวางการกําหนดค่าในหลายโมดูล นอกจากนี้ คุณยังใช้ปลั๊กอินการตั้งค่าเพื่อสร้างโปรไฟล์การเรียกใช้ของเครื่องมือ หรือวิธีการต่างๆ ในการใช้งานเครื่องมือ และเปลี่ยนไปใช้โปรไฟล์อื่นได้

หากต้องการใช้ปลั๊กอินการตั้งค่า ให้ใช้ปลั๊กอินในไฟล์ settings.gradle โดยทำดังนี้

apply plugin 'com.android.settings'

รวมศูนย์การกําหนดค่าส่วนกลาง

หากต้องการกําหนดค่าการกําหนดค่าส่วนกลาง ให้ใช้บล็อก android ใหม่ในไฟล์ settings.gradle ตัวอย่างเช่น

android {
  compileSdk 31
  minSdk 28
  ...
}

โปรไฟล์การเรียกใช้เครื่องมือ

ปลั๊กอินการตั้งค่ายังช่วยให้คุณสร้างโปรไฟล์การเรียกใช้สําหรับเครื่องมือบางรายการได้ด้วย โปรไฟล์การเรียกใช้จะกําหนดวิธีเรียกใช้เครื่องมือ โดยคุณเลือกโปรไฟล์การเรียกใช้ที่แตกต่างกันได้ ทั้งนี้ขึ้นอยู่กับสภาพแวดล้อม ในโปรไฟล์การเรียกใช้ คุณสามารถกําหนดอาร์กิวเมนต์ JVM สําหรับเครื่องมือและกำหนดค่าให้ทํางานในกระบวนการแยกต่างหาก ปัจจุบันรองรับเฉพาะเครื่องมือ R8 เท่านั้น

สร้างโปรไฟล์การเรียกใช้และตั้งค่าโปรไฟล์การเรียกใช้เริ่มต้นในไฟล์ settings.gradle ดังที่แสดงในตัวอย่างต่อไปนี้

android {
  execution {
    profiles {
      high {
        r8 {
          jvmOptions += ["-Xms2048m", "-Xmx8192m", "-XX:+HeapDumpOnOutOfMemoryError"]
          runInSeparateProcess true
        }
      }
      low {
        r8 {
          jvmOptions += ["-Xms256m", "-Xmx2048m", "-XX:+HeapDumpOnOutOfMemoryError"]
          runInSeparateProcess true
        }
      }
      ci {
        r8.runInSeparateProcess false
      }
    }
    defaultProfile "low"
  }
}

หากต้องการลบล้างโปรไฟล์เริ่มต้น ให้เลือกโปรไฟล์อื่นโดยใช้พร็อพเพอร์ตี้ android.experimental.settings.executionProfile ในไฟล์ gradle.properties ดังนี้

android.experimental.settings.executionProfile=high

คุณยังตั้งค่าพร็อพเพอร์ตี้นี้โดยใช้บรรทัดคำสั่งได้ด้วย ซึ่งจะช่วยให้คุณตั้งค่าเวิร์กโฟลว์ต่างๆ ได้ ตัวอย่างเช่น หากคุณมีเวิร์กโฟลว์การผสานรวมอย่างต่อเนื่อง คุณสามารถใช้บรรทัดคำสั่งเพื่อเปลี่ยนโปรไฟล์การเรียกใช้โดยไม่ต้องเปลี่ยนไฟล์ settings.gradle

./gradlew assembleRelease \
  -Pandroid.experimental.settings.executionProfile=ci

ต้องใช้ JDK 17 เพื่อเรียกใช้ AGP 8.0

เมื่อใช้ Android Gradle Plugin 8.0 เพื่อสร้างแอป คุณต้องใช้ JDK 17 เพื่อเรียกใช้ Gradle Android Studio Flamingo จะรวม JDK 17 และกำหนดค่า Gradle ให้ใช้โดยค่าเริ่มต้น ซึ่งหมายความว่าผู้ใช้ Android Studio ส่วนใหญ่ไม่จําเป็นต้องทําการเปลี่ยนแปลงการกําหนดค่าใดๆ ในโปรเจ็กต์

หากต้องการตั้งค่าเวอร์ชัน JDK ที่ใช้โดย AGP ใน Android Studio ด้วยตนเอง คุณต้องใช้ JDK 17 ขึ้นไป

เมื่อใช้ AGP แยกจาก Android Studio ให้อัปเกรดเวอร์ชัน JDK โดยการตั้งค่าJAVA_HOME ตัวแปรสภาพแวดล้อมหรือ-Dorg.gradle.java.home ตัวเลือกบรรทัดคำสั่งไปยังไดเรกทอรีการติดตั้ง JDK 17

ปัญหาที่แก้ไขแล้ว

ปลั๊กอิน Android Gradle 8.0.0

ปลั๊กอิน Android Gradle 8.0.1

ปลั๊กอิน Android Gradle 8.0.2