升級 Gradle for Android

Google Mobile Ads Android SDK 22.4.0 在 Android 資訊清單中新增了 <property> 元素。針對此版本或更高版本建構時，必須使用 Gradle 6.7.1 以上版本和 Android Gradle 外掛程式 4.2.0 以上版本。本指南會說明如何確保 Unity 編輯器相容。

必要條件

完成入門指南。請務必執行下列操作：

  • 將最低 API 級別設為 21
  • 將目標 API 級別設為 33 以上
  • 啟用「Custom Main Gradle Template」和「Custom Gradle Properties Template」設定

Unity 2022.2 以上版本

根據預設，Unity 2022.2 以上版本會隨附較新的 Gradle for Android 版本。您不需要採取額外行動，即可支援 Google Mobile Ads Android SDK 22.4.0。

Unity 2022.1 以下版本

Unity 2022.2 以下版本使用的是舊版 Android 版 Gradle，而 Google Mobile Ads Android SDK 22.4.0 不支援舊版。以下步驟說明如何根據建構程序升級至 Gradle 最低版本需求：

  1. 啟用自訂 Gradle 範本

    依序前往「Project Settings」>「Player」>「Android」>「Publishing Settings」>「Build」，然後選取：

    • 自訂 Gradle 基礎範本

  2. 修改 Gradle 範本

    開啟 Assets/Plugins/Android/baseProjectTemplate.gradle 檔案，並設定依附元件以使用 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 版。

    在 Unity 中設定 Gradle 路徑

    在 Unity 中，依序開啟「Unity Preferences」>「External Tools」，然後設定自訂 Gradle 路徑。

    Android Studio 版本

    匯出 Android Studio 專案

    依序開啟「File」>「Build Settings」選單，確認「Export Project」已勾選，然後按下「Export」按鈕。匯出完成後，請在 Android Studio 中開啟專案。

    更新 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