ปลั๊กอิน 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 คุณเริ่มใช้พร็อพเพอร์ตี้ namespace DSL ได้ตั้งแต่ AGP 7.3 เป็นต้นไป ดูข้อมูลเพิ่มเติมได้ที่ ตั้งค่าเนมสเปซ

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

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

ดูข้อมูลเพิ่มเติมได้ที่ issue #191813691 comment #19

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

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

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

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

แฟล็กใหม่ที่เสถียรสำหรับโปรไฟล์การดำเนินการ

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

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

ไม่รองรับการกำหนดพร็อพเพอร์ตี้แบบเลซี่ของ 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 8.0 เพื่อสร้างแอป ตอนนี้คุณต้องใช้ JDK 17 เพื่อเรียกใช้ Gradle Android Studio Flamingo มาพร้อมกับ JDK 17 และกำหนดค่า Gradle ให้ใช้ JDK 17 โดยค่าเริ่มต้น ซึ่งหมายความว่าผู้ใช้ 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