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

Google Mobile Ads Android SDK 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 เวอร์ชันใหม่โดยค่าเริ่มต้น คุณไม่ต้องดำเนินการใดๆ เพิ่มเติมเพื่อรองรับโฆษณาบนอุปกรณ์เคลื่อนที่ของ Google Android SDK 22.4.0

Unity 2022.1 และรุ่นก่อนหน้า

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

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

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

    • เทมเพลต Base Gradle ที่กำหนดเอง

  2. แก้ไขเทมเพลต Base 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