升级 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（自定义主要 Gradle 模板）和 Custom Gradle Properties Template（自定义 Gradle 属性模板）设置

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 build 工具 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