ปลั๊กอิน Android Gradle 4.2.0 (มีนาคม 2021)

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

เวอร์ชันขั้นต่ำ เวอร์ชันเริ่มต้น หมายเหตุ
Gradle 6.7.1 ไม่มี ดูข้อมูลเพิ่มเติมได้ที่การอัปเดต Gradle
เครื่องมือสร้าง SDK 30.0.2 30.0.2 ติดตั้งหรือกำหนดค่าเครื่องมือสร้าง SDK
NDK ไม่มี 21.4.7075529 ติดตั้งหรือกำหนดค่า NDK เวอร์ชันอื่น

ฟีเจอร์ใหม่

ปลั๊กอิน Android Gradle เวอร์ชันนี้มีฟีเจอร์ใหม่ดังต่อไปนี้

ภาษา Java เวอร์ชัน 8 โดยค่าเริ่มต้น

ตั้งแต่เวอร์ชัน 4.2 เป็นต้นไป AGP จะใช้ระดับภาษา Java 8 โดยค่าเริ่มต้น Java 8 ให้สิทธิ์เข้าถึงฟีเจอร์ภาษาใหม่ๆ มากมาย ซึ่งรวมถึงนิพจน์ Lambda, การอ้างอิงเมธอด และเมธอดอินเทอร์เฟซแบบคงที่ ดูรายการฟีเจอร์ที่รองรับทั้งหมดได้ในเอกสารประกอบของ Java 8

หากต้องการคงลักษณะการทำงานเดิมไว้ ให้ระบุ Java 7 อย่างชัดเจนในไฟล์ build.gradle.kts หรือ build.gradle ระดับโมดูล ดังนี้

// build.gradle
android {
  ...
  compileOptions {
    sourceCompatibility JavaVersion.VERSION_1_7
    targetCompatibility JavaVersion.VERSION_1_7
  }
  // For Kotlin projects, compile to Java 6 instead of 7
  kotlinOptions {
    jvmTarget = "1.6"
  }
}
// build.gradle.kts
android {
  ...
  compileOptions {
    sourceCompatibility = JavaVersion.VERSION_1_7
    targetCompatibility = JavaVersion.VERSION_1_7
  }
  // For Kotlin projects, compile to Java 6 instead of 7
  kotlinOptions {
    jvmTarget = "1.6"
  }
}

คอมไพเลอร์ทรัพยากร JVM ใหม่

คอมไพเลอร์ทรัพยากร JVM ใหม่ในปลั๊กอิน Android Gradle 4.2 จะแทนที่บางส่วนของคอมไพเลอร์ทรัพยากร AAPT2 ซึ่งอาจปรับปรุงประสิทธิภาพการบิลด์ โดยเฉพาะในเครื่อง Windows คอมไพเลอร์ทรัพยากร JVM ใหม่จะเปิดใช้โดยค่าเริ่มต้น

ตอนนี้รองรับการรับรอง v3 และ v4 แล้ว

ตอนนี้ปลั๊กอิน Android Gradle 4.2 รองรับรูปแบบการรับรอง APK v3 และ APK v4 แล้ว หากต้องการเปิดใช้รูปแบบใดรูปแบบหนึ่งหรือทั้ง 2 รูปแบบในบิลด์ ให้เพิ่มพร็อพเพอร์ตี้ต่อไปนี้ลงในไฟล์ build.gradle หรือ build.gradle.kts ระดับโมดูล

// build.gradle
android {
  ...
  signingConfigs {
    config {
        ...
        enableV3Signing true
        enableV4Signing true
    }
  }
}
// build.gradle.kts
android {
  ...
  signingConfigs {
      config {
          ...
          enableV3Signing = true
          enableV4Signing = true
      }
  }
}

การรับรอง APK v4 ช่วยให้คุณติดตั้งใช้งาน APK ขนาดใหญ่ได้อย่างรวดเร็วโดยใช้การติดตั้ง APK แบบเพิ่มทีละส่วนของ ADB ใน Android 11 แฟล็กใหม่นี้จะดูแลขั้นตอนการรับรอง APK ในกระบวนการทำให้ใช้งานได้

กำหนดค่า App Signing ต่อตัวแปร

ตอนนี้คุณสามารถเปิดหรือปิดใช้ App Signing ในปลั๊กอิน Android Gradle ต่อตัวแปรได้แล้ว

ตัวอย่างนี้แสดงวิธีตั้งค่า App Signing ต่อตัวแปรโดยใช้เมธอด onVariants() ใน Kotlin หรือ Groovy

androidComponents {
    onVariants(selector().withName("fooDebug")) {
        signingConfig {
            enableV1Signing false
            enableV2Signing true
        }
    }
}

พร็อพเพอร์ตี้ Gradle ใหม่ android.native.buildOutput

เพื่อลดความยุ่งเหยิงในเอาต์พุตบิลด์ AGP 4.2 จะกรองข้อความจากบิลด์ C/C++ ที่ใช้ CMake และ ndk-build โดยแสดงเฉพาะเอาต์พุตคอมไพเลอร์ C/C++ โดยค่าเริ่มต้น ก่อนหน้านี้ ระบบจะสร้างบรรทัดเอาต์พุตสำหรับทุกไฟล์ที่สร้างขึ้น ซึ่งส่งผลให้มีข้อความแสดงข้อมูลจำนวนมาก

หากต้องการดูเอาต์พุต C/C++ ทั้งหมด ให้ตั้งค่าพร็อพเพอร์ตี้ Gradle ใหม่ android.native.buildOutput เป็น verbose

คุณตั้งค่าพร็อพเพอร์ตี้นี้ได้ในไฟล์ gradle.properties หรือผ่านบรรทัดคำสั่ง

gradle.properties
android.native.buildOutput=verbose

บรรทัดคำสั่ง
-Pandroid.native.buildOutput=verbose

ค่าเริ่มต้นของพร็อพเพอร์ตี้นี้คือ quiet

การเปลี่ยนแปลงลักษณะการทำงานของไฟล์ gradle.properties

ตั้งแต่ AGP 4.2 เป็นต้นไป คุณจะลบล้างพร็อพเพอร์ตี้ Gradle จากโปรเจ็กต์ย่อยไม่ได้อีกต่อไป กล่าวคือ หากคุณประกาศพร็อพเพอร์ตี้ในไฟล์ gradle.properties ในโปรเจ็กต์ย่อยแทนที่จะเป็นโปรเจ็กต์รูท ระบบจะไม่สนใจพร็อพเพอร์ตี้นั้น

ตัวอย่างเช่น ในรุ่นก่อนหน้า AGP จะอ่านค่าจาก <var>projectDir</var>/gradle.properties, <var>projectDir</var>/app/gradle.properties, <var>projectDir</var>/library/gradle.properties ฯลฯ สำหรับโมดูลแอป หากมีพร็อพเพอร์ตี้ Gradle เดียวกันทั้งใน <var>projectDir</var>/gradle.properties และ <var>projectDir</var>/app/gradle.properties ค่าจาก <var>projectDir</var>/app/gradle.properties จะมีลำดับความสำคัญเหนือกว่า

ใน AGP 4.2 ลักษณะการทำงานนี้มีการเปลี่ยนแปลง และ AGP จะไม่โหลดค่าจาก gradle.properties ในโปรเจ็กต์ย่อย (เช่น <var>projectDir</var>/app/gradle.properties) การเปลี่ยนแปลงนี้สอดคล้องกับลักษณะการทำงานใหม่ของ Gradle และรองรับการแคชการกำหนดค่า

ดูข้อมูลเพิ่มเติมเกี่ยวกับการตั้งค่าในไฟล์ gradle.properties ได้ที่เอกสารประกอบของ Gradle

การเปลี่ยนแปลงความเข้ากันได้และการกำหนดค่า Gradle

เมื่อทำงานใน Android Studio เครื่องมือสร้าง Gradle จะใช้ JDK ที่มาพร้อมกับ Studio ในรุ่นก่อนหน้า JDK 8 จะรวมมากับ Studio แต่ในเวอร์ชัน 4.2 จะรวม JDK 11 ไว้แทน เมื่อใช้ JDK ที่รวมมาใหม่เพื่อเรียกใช้ Gradle อาจส่งผลให้เกิดความไม่เข้ากันหรือส่งผลต่อประสิทธิภาพของ JVM เนื่องจากการเปลี่ยนแปลงใน Garbage Collector ปัญหาเหล่านี้มีคำอธิบายอยู่ด้านล่าง

หมายเหตุ: แม้ว่าเราจะแนะนำให้เรียกใช้ Gradle ด้วย JDK 11 แต่คุณสามารถเปลี่ยน JDK ที่ใช้เรียกใช้ Gradle ได้ในกล่องโต้ตอบโครงสร้างโปรเจ็กต์ การเปลี่ยนการตั้งค่านี้จะเปลี่ยนเฉพาะ JDK ที่ใช้เรียกใช้ Gradle และจะไม่เปลี่ยน JDK ที่ใช้เรียกใช้ Studio เอง

ความเข้ากันได้ของ Studio กับปลั๊กอิน Android Gradle (AGP)

Android Studio 4.2 สามารถเปิดโปรเจ็กต์ที่ใช้ AGP 3.1 ขึ้นไปได้ หาก AGP ใช้ Gradle 4.8.1 ขึ้นไป ดูข้อมูลเพิ่มเติมเกี่ยวกับความเข้ากันได้ของ Gradle ได้ที่อัปเดต Gradle

การเพิ่มประสิทธิภาพบิลด์ Gradle สำหรับ JDK 11

การอัปเดตเป็น JDK 11 นี้ส่งผลต่อการกำหนดค่าเริ่มต้นของ JVM Garbage Collector เนื่องจาก JDK 8 ใช้ Parallel Garbage Collector ขณะที่ JDK 11 ใช้ G1 Garbage Collector

เราขอแนะนำให้ทดสอบบิลด์ Gradle ด้วย Garbage Collector แบบขนานเพื่อปรับปรุงประสิทธิภาพของบิลด์ ใน gradle.properties ให้ตั้งค่าต่อไปนี้

org.gradle.jvmargs=-XX:+UseParallelGC

หากมีตัวเลือกอื่นที่ตั้งค่าไว้แล้วในช่องนี้ ให้เพิ่มตัวเลือกใหม่ดังนี้

org.gradle.jvmargs=-Xmx1536m -XX:+UseParallelGC

หากต้องการวัดความเร็วในการสร้างด้วยการกำหนดค่าต่างๆ โปรดดูสร้างโปรไฟล์บิลด์

ไฟล์ DEX ที่ไม่ได้บีบอัดใน APK เมื่อ minSdk = 28 ขึ้นไป

ตอนนี้ AGP จะแพ็กไฟล์ DEX ที่ไม่บีบอัดใน APK โดยค่าเริ่มต้นเมื่อ minSdk = 28 ขึ้นไป ซึ่งจะทำให้ขนาด APK เพิ่มขึ้น แต่จะส่งผลให้ขนาดการติดตั้งในอุปกรณ์เล็กลง และขนาดการดาวน์โหลดจะใกล้เคียงกัน

หากต้องการบังคับให้ AGP แพ็กเกจไฟล์ DEX ที่บีบอัดแทน คุณสามารถเพิ่มโค้ดต่อไปนี้ลงในไฟล์ build.gradle

android {
    packagingOptions {
        dex {
            useLegacyPackaging true
        }
    }
}

ใช้ DSL เพื่อแพ็กเกจไลบรารี C/C++ ที่บีบอัด

เราขอแนะนำให้แพ็กเกจไลบรารี C/C++ ในรูปแบบที่ไม่มีการบีบอัด เนื่องจากจะส่งผลให้ขนาดการติดตั้งแอปเล็กลง ขนาดการดาวน์โหลดแอปเล็กลง และผู้ใช้โหลดแอปได้เร็วขึ้น อย่างไรก็ตาม หากต้องการให้ปลั๊กอิน Android Gradle จัดแพ็กเกจไลบรารี C/C++ ที่บีบอัดเมื่อสร้างแอป ให้ตั้งค่า useLegacyPackaging เป็น true ในไฟล์ build.gradle ของแอป ดังนี้

android {
    packagingOptions {
        jniLibs {
            useLegacyPackaging true
        }
    }
}

แฟล็ก useLegacyPackaging จะแทนที่แอตทริบิวต์ไฟล์ Manifest extractNativeLibs ดูข้อมูลเบื้องหลังเพิ่มเติมได้ที่บันทึกประจำรุ่นไลบรารีแบบเนทีฟที่แพ็กเกจโดยไม่มีการบีบอัดโดยค่าเริ่มต้น