升级 Gradle for Android

Google 移动广告 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 移动广告 Android SDK 22.4.0。

Unity 2022.1 及更早版本

Unity 2022.2 及更早版本使用旧版 Gradle for Android，Google 移动广告 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 集成式 build

    安装 Gradle

    下载 Gradle 6.7.1 版。

    在 Unity 中设置 Gradle 路径

    在 Unity 中，依次打开 Unity Preferences > External Tools，并设置自定义 Gradle 路径。

    Android Studio build

    导出 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