อัปเกรด Gradle สำหรับ Android

SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google สำหรับ Android 22.4.0 เพิ่มองค์ประกอบ <property> ในไฟล์ Manifest ของ Android การสร้างกับเวอร์ชันนี้หรือเวอร์ชันที่สูงกว่าต้องใช้ Gradle 6.7.1 ขึ้นไปและปลั๊กอิน Android Gradle 4.2.0 ขึ้นไป คู่มือนี้จะอธิบายวิธีตรวจสอบว่าเครื่องมือแก้ไข Unity ของคุณเข้ากันได้

ข้อกำหนดเบื้องต้น

ทำตามคู่มือเริ่มต้นใช้งาน โปรดตรวจสอบว่าได้ดำเนินการดังนี้

  • ตั้งค่าระดับ API ขั้นต่ำเป็น 21
  • ตั้งค่าระดับ API เป้าหมายเป็น 33 ขึ้นไป
  • เปิดใช้การตั้งค่าเทมเพลต Gradle หลักที่กำหนดเองและเทมเพลตพร็อพเพอร์ตี้ Gradle ที่กําหนดเอง

Unity 2022.2 ขึ้นไป

Unity 2022.2 ขึ้นไปมาพร้อมกับ Gradle สำหรับ Android เวอร์ชันใหม่โดยค่าเริ่มต้น คุณไม่ต้องดำเนินการใดๆ เพิ่มเติมเพื่อรองรับ SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google เวอร์ชัน 22.4.0 สำหรับ Android

Unity 2022.1 และเก่ากว่า

Unity 2022.2 และเวอร์ชันก่อนหน้าใช้ Gradle สําหรับ Android เวอร์ชันเก่า ซึ่ง Google Mobile Ads Android SDK 22.4.0 ไม่รองรับ ขั้นตอนต่อไปนี้แสดงวิธีอัปเกรดเป็น Gradle เวอร์ชันขั้นต่ำที่จำเป็นตามกระบวนการสร้างของคุณ

  1. เปิดใช้เทมเพลต Gradle ที่กําหนดเอง

    ไปที่การตั้งค่าโปรเจ็กต์ > Player > Android > การตั้งค่าการเผยแพร่ > บิลด์ แล้วเลือกรายการต่อไปนี้

    • เทมเพลต Gradle พื้นฐานที่กำหนดเอง

  2. แก้ไขเทมเพลต Gradle พื้นฐาน

    เปิดไฟล์ Assets/Plugins/Android/baseProjectTemplate.gradle และตั้งค่า Dependency ให้ใช้เครื่องมือบิลด์ Gradle 4.2.0

      allprojects {
          buildscript {
              dependencies {
                  classpath 'com.android.tools.build:gradle:4.2.0'
                  **BUILD_SCRIPT_DEPS**
              }
          }
      }
      ...
    
  3. อัปเดต Gradle

    อัปเดต Gradle เป็นเวอร์ชัน 6.7.1 ขั้นตอนนี้จะแตกต่างกันเล็กน้อยโดยขึ้นอยู่กับว่าคุณส่งออกโปรเจ็กต์เป็นโปรเจ็กต์ Android Studio เป็นส่วนหนึ่งของกระบวนการสร้างหรือไม่

    บิลด์ที่ผสานรวมของ Unity

    ติดตั้ง Gradle

    ดาวน์โหลด Gradle เวอร์ชัน 6.7.1

    กำหนดเส้นทาง Gradle ใน Unity

    ใน Unity ให้เปิดค่ากำหนด Unity > เครื่องมือภายนอก แล้วตั้งค่าเส้นทาง Gradle ที่กําหนดเอง

    บิลด์ Android Studio

    ส่งออกโปรเจ็กต์ Android Studio

    เปิดเมนูไฟล์ > การตั้งค่าการสร้าง เปิดใช้ส่งออกโปรเจ็กต์โดยเลือก แล้วกดปุ่มส่งออก เมื่อส่งออกแล้ว ให้เปิดโปรเจ็กต์ใน Android Studio

    อัปเดต Wrapper ของ Gradle

    เปิดไฟล์ ./gradle/wrapper/gradle-wrapper.properties แล้วตั้งค่า distributionUrl เพื่อใช้ Gradle 6.7.1

    distributionBase=GRADLE_USER_HOME
    distributionPath=wrapper/dists
    zipStoreBase=GRADLE_USER_HOME
    zipStorePath=wrapper/dists
    distributionUrl=https\://services.gradle.org/distributions/gradle-6.7.1-bin.zip