升級 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 以下版本使用 Google Mobile Ads Android SDK 22.4.0 不支援的舊版 Gradle for Android。下列步驟說明如何根據建構程序，升級至最低必要的 Gradle 版本：

  1. 啟用自訂 Gradle 範本

    依序前往「Project Settings」>「Player」>「Android」>「Publish 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