unity-android和gradle升级

已于 2022-03-23 14:55:40 修改
阅读量1w 收藏 10
点赞数 1
分类专栏： Unity3D . 文章标签： gradle android unity 升级
于 2022-01-25 09:59:40 首次发布
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/yangxuan0261/article/details/122679710
版权

title: unity-android和gradle升级
categories: Unity3d
tags: [unity, android, gradle, 升级]
date: 2022-01-23 15:33:10
comments: false
mathjax: true
toc: true

unity-android和gradle升级, 使用的 unity 版本是 2018.4.36f1 (LTS)

前篇

适配 android 11,12 的需要

sdk 升级到 最新版本后 unity 打包问题

报错无法识别的属性名模块: unrecognized Attribute name MODULE

  • 完整报错

    CommandInvokationFailure: Gradle build failed. 
D:\unity2018.4.36f1\Editor\Data\PlaybackEngines\AndroidPlayer/Tools\OpenJDK\Windows\bin\java.exe -classpath "D:\unity2018.4.36f1\Editor\Data\PlaybackEngines\AndroidPlayer\Tools\gradle\lib\gradle-launcher-5.1.1.jar" org.gradle.launcher.GradleMain "-Dorg.gradle.jvmargs=-Xmx4096m" "assembleRelease"

stderr[
编译器 (1.8.0-adoptopenjdk) 中出现异常错误。如果在 Bug Database (http://bugs.java.com) 中没有找到该错误, 请通过 Java Bug 报告页 (http://bugreport.java.com) 建立该 Java 编译器 Bug。请在报告中附上您的程序和以下诊断信息。谢谢。
java.lang.AssertionError: annotationType(): unrecognized Attribute name MODULE (class com.sun.tools.javac.util.UnsharedNameTable$NameImpl)
    at com.sun.tools.javac.util.Assert.error(Assert.java:133)
    at com.sun.tools.javac.code.TypeAnnotations.annotationType(TypeAnnotations.java:231)
    at com.sun.tools.javac.code.TypeAnnotations$TypeAnnotationPositions.separateAnnotationsKinds(TypeAnnotations.java:294)
    at com.sun.tools.javac.code.TypeAnnotations$TypeAnnotationPositions.visitVarDef(TypeAnnotations.java:1164)
    at com.sun.tools.javac.tree.JCTree$JCVariableDecl.accept(JCTree.java:852)
    at com.sun.tools.javac.tree.TreeScanner.scan(TreeScanner.java:49)

  • 原因

    使用的自定义 gradle (mainTemplate.gradle) 中使用的 tool (4.0.0) 版本高于 unity 自带的 gradle 版本 (5.1.1)

    buildscript {
    dependencies {
        classpath 'com.android.tools.build:gradle:4.0.0' # 对应的 gradle 版本是 6.1.1
**BUILD_SCRIPT_DEPS**}
}

    gradle tool 版本对应关系 - https://developer.android.com/studio/releases/gradle-plugin?hl=zh-cn#updating-gradle

  • 解决办法: [gradle 升级](#gradle 升级)

android 升级

升级到 32

  1. 下载 android-studio-2020.3.1.26-windows.zip

    新版 as 编辑器默认不显示 gradle 任务, 需要手动打开

    settings -> experimental, 取消勾选 do not build gradle task list during…

  2. 更新 sdk,tools

  3. 修改 build-tools

    1. 将 %ANDROID_SDK%\build-tools\32.0.0 目录下的 d8.bat 改成 dx.bat
    2. 将 %ANDROID_SDK%\build-tools\32.0.0\lib 目录下的 d8.jar 改成 dx.jar
模块升级

  1. 将每个模块的 gradle 构建版本都改成新版本

    android {
    compileSdkVersion 32
    buildToolsVersion '32.0.0'
    defaultConfig {
        targetSdkVersion 32
    }
}

  2. 如果有引入 androidx.test 单元测试 , 也将版本升级一下

    单元测试最新版本: https://developer.android.com/jetpack/androidx/releases/test?hl=zh-cn

    androidTestImplementation 'androidx.test:core:1.4.0'
androidTestImplementation 'androidx.test.ext:junit:1.1.3'
androidTestImplementation 'androidx.test:runner:1.4.0'
androidTestImplementation 'androidx.test:rules:1.4.0'
androidTestImplementation 'androidx.test.espresso:espresso-core:3.4.0'

    • 不然可能出现 构建 app 正常, 执行单元测试用例却失败的情况, 报错: processdebugandroidtestmanifest manifest merger failed

    • 也可以在 gui 中升级

踩坑
gradle tool 升级报错已损坏

报错: Installed Build Tools revision 32.0.0 is corrupted. Remove and install again using the SDK Manager. 错误

gradle 配置的是 32.0.0

android {
    compileSdkVersion 32
    buildToolsVersion '32.0.0'
    defaultConfig {
        minSdkVersion 19
        targetSdkVersion 32
    }
}

改成 31.0.0 也报类似的错误

原因是:

The main problem is the two files missing in SDK build tool 31 that are:

  1. dx.bat
  2. dx.jar

解决办法:

  1. 将 %ANDROID_SDK%\build-tools\32.0.0 目录下的 d8.bat 改成 dx.bat
  2. 将 %ANDROID_SDK%\build-tools\32.0.0\lib 目录下的 d8.jar 改成 dx.jar

参考: https://stackoverflow.com/questions/68387270/android-studio-error-installed-build-tools-revision-31-0-0-is-corrupted

gradle 升级

  • 各版本 gradle 下载地址 - https://services.gradle.org/distributions/
  • gradle tool 版本对应关系 - https://developer.android.com/studio/releases/gradle-plugin?hl=zh-cn#updating-gradle

  1. 下载 tool 对应的 gradle 版本, 比如: tool 4.0.1 对应的 gradle 是 6.1.1

  2. 将 unity 安装目录下的 UNITY_ROOT\Editor\Data\PlaybackEngines\AndroidPlayer\Tools\gradle 的 lib 删了, 然后从 gradle-6.1.1-all.zip 文件中解压 lib 丢到该目录下

踩坑
unity 默认版本 低于 tools 版本

  • 自定义配置 tools 版本是 4.0.1, 需要对应的 gradle 版本是 6.1.1, 而 unity 默认版本是 5.1.1

    classpath 'com.android.tools.build:gradle:4.0.1'

  • 报错

    CommandInvokationFailure: Gradle build failed. 
D:\unity2018.4.36f1\Editor\Data\PlaybackEngines\AndroidPlayer/Tools\OpenJDK\Windows\bin\java.exe -classpath "D:\unity2018.4.36f1\Editor\Data\PlaybackEngines\AndroidPlayer\Tools\gradle\lib\gradle-launcher-5.1.1.jar" org.gradle.launcher.GradleMain "-Dorg.gradle.jvmargs=-Xmx4096m" "assembleRelease"

stderr[

FAILURE: Build failed with an exception.

* What went wrong:
A problem occurred evaluating root project 'gradleOut'.
> Failed to apply plugin [id 'com.android.internal.version-check']
   > Minimum supported Gradle version is 6.1.1. Current version is 5.1.1. If using the gradle wrapper, try editing the distributionUrl in E:\its\tdmj_itc\Temp\gradleOut\gradle\wrapper\gradle-wrapper.properties to gradle-6.1.1-all.zip

  • 解决办法

    将 unity 默认的 gradle 升级到 6.1.1

aaptOptions.noCompress 数组超出限制

aaptOptions.noCompress 数组的容量限制是 255

  • 对应的 tools 版本是 4.0.1, 对应的 gradle 版本是 6.1.1

    classpath 'com.android.tools.build:gradle:4.0.1'

  • 报错

    CommandInvokationFailure: Gradle build failed. 
D:/unity_kit/Java/jdk1.8.0_144\bin\java.exe -classpath "D:\unity2018.4.36f1\Editor\Data\PlaybackEngines\AndroidPlayer\Tools\gradle\lib\gradle-launcher-6.1.1.jar" org.gradle.launcher.GradleMain "-Dorg.gradle.jvmargs=-Xmx4096m" "assembleRelease"

stderr[

FAILURE: Build failed with an exception.

* What went wrong:
Execution failed for task ':processReleaseResources'.
> A failure occurred while executing com.android.build.gradle.internal.tasks.Workers$ActionFacade
   > AAPT2 aapt2-4.0.1-6197926-windows Daemon #0: Unexpected error during link, attempting to stop daemon.
     This should not happen under normal circumstances, please file an issue if it does.

  • 原因

    streamingAssets 下项目下文件数量过多引起的, 导致 unity 默认配置中的 **STREAMING_ASSETS** 这个占位符在 gradle 构建时会全部展开为所有文件

    aaptOptions {
    noCompress = ['.unity3d', '.ress', '.resource', '.obb'**STREAMING_ASSETS**]
}**SIGN**

    • 构建失败后, 可以查看 UNITY_PROJ\Temp\gradleOut\build.gradle

  • 解决办法

    直接去掉 **STREAMING_ASSETS**, 变为

    aaptOptions {
    noCompress = ['.unity3d', '.ress', '.resource', '.obb']
}**SIGN**

  • 参考

    • https://answers.unity.com/questions/1875624/cant-build-on-android-aapt2-unexpected-error-durin.html
    • https://stackoverflow.com/questions/69924552/unity-failed-to-package-after-upgrading-gradle-plug-in-version-to-4-1-0
    • Unity3D使用gradle打Android包遇到的aaptOptions.noCompress越界问题及解决方案 - https://www.jianshu.com/p/402d28da05de
aaptOptions.noCompress 配置技巧

aapt官方文档以及网上查到的一些资料都说aaptOptions.noCompress配置的是不压缩资源文件的后缀名，但是使用后缀名来配置有一定的局限性，比如有些文件后缀名相同，但是如果只想将其中几个文件（而不是全部）配成不压缩，再比如有的文件没有后缀名怎么办？

经过实践发现aaptOptions.noCompress机制并不是检查文件后缀名，而是判断文件路径是否以某个字符串结尾，另外一个需要注意的地方是，在做string.EndWith判断之前会将文件路径全部转换为小写，所以aaptOptions.noCompress中的配置项也必须全为小写

android 12 需要明确指定 android:exported

  • 对应的 tools 版本是 4.2.0, 版本 6.7.1

    classpath 'com.android.tools.build:gradle:4.2.0'

  • 报错

    CommandInvokationFailure: Gradle build failed. 
D:/unity_kit/Java/jdk1.8.0_144\bin\java.exe -classpath "D:\unity2018.4.36f1\Editor\Data\PlaybackEngines\AndroidPlayer\Tools\gradle\lib\gradle-launcher-6.7.1.jar" org.gradle.launcher.GradleMain "-Dorg.gradle.jvmargs=-Xmx4096m" "assembleRelease"

stderr[
E:\its\tdmj_itc\Temp\gradleOut\src\main\AndroidManifest.xml Error:
    Apps targeting Android 12 and higher are required to specify an explicit value for `android:exported` when the corresponding component has an intent filter defined. See https://developer.android.com/guide/topics/manifest/activity-element#exported for details.

FAILURE: Build failed with an exception.

* What went wrong:
Execution failed for task ':processReleaseMainManifest'.
> Manifest merger failed with multiple errors, see logs

  • 解决办法: 所有包含 intent-filter 的 service/receiver/activity 都加上 android:exported="true" 或 android:exported="false"

unity android 配置修改

  1. 修改自定义 gradle

    1. tools 版本, 使用的自定义 gradle (mainTemplate.gradle) 中使用的 tool (4.0.0)

      buildscript {
    dependencies {
        classpath 'com.android.tools.build:gradle:4.0.0' # 对应的 gradle 版本是 6.1.1
**BUILD_SCRIPT_DEPS**}
}

    2. 增加后置任务.

      升级 unity 内置 gradle (4.0.1版本) 生成的 aab 文件名为 gradleOut-release.aab, 而 unity 回去找的文件是 gradleOut.aab, 所以会

      报错: FileNotFoundException: Temp\gradleOut\build\outputs\bundle\release\gradleOut.aab does not exist

      添加个重命名的任务即可

      defaultConfig {
    // rename aab for unity
    tasks.whenTaskAdded { task ->
        if (task.name.startsWith("bundle")) {
            def renameTaskName = "rename${task.name.capitalize()}Aab"
            def flavor = task.name.substring("bundle".length()).uncapitalize()
            tasks.create(renameTaskName, Copy) {
                def path = "${buildDir}/outputs/bundle/${flavor}/"
                from(path)
                include "gradleOut-release.aab"
                destinationDir file("${buildDir}/outputs/bundle/${flavor}/")
                rename "gradleOut-release.aab", "gradleOut.aab"
            }
            task.finalizedBy(renameTaskName)
        }
    }
}
      • 参考: https://stackoverflow.com/questions/66997991/filenotfoundexception-temp-gradleout-build-outputs-bundle-release-gradleout-aab?rq=1

  2. 修改自定义 AndroidManifest

    所有包含 intent-filter 的 service/receiver/activity 都加上 android:exported="true" 或 android:exported="false"

    <activity
    android:name="${ps_pkg_path}.MainActivity"
    android:label="@string/app_name" android:exported="true">
    <intent-filter>
    ...
    </intent-filter>
</activity>
Android 12 启动异常

异常行为可能是 闪退 或者 卡住

unity 社区大多都是报闪退的错误, 参考: https://forum.unity.com/threads/android-12-crash-on-startup.1230936/

原因可能是因为升级了 gradle 导致的 (不升级没办法, 要使用 Android 12 相关 api)

  1. 解决办法

    1. 简单粗暴升级 unity, 可以升级到 unity 2020.3.31, 这个版本实测过没问题, 过不有在线项目的慎重

    2. 经测试, 会卡住流程的是在 csharp 的协程里面的 yield return 语句, 如:

      public class GameMgr : MonoBehaviour {
    void Awake() {
        Debug.LogFormat("--- ccc 1");
        StartCoroutine(Init());
    }

    IEnumerator Init() {
        Debug.LogFormat("--- ccc 2");
        yield return StartLuaMain();
    }

    IEnumerator StartLuaMain() {
        Debug.LogFormat("--- ccc 2-1");
        yield return 1; // 这里卡住, 不往下走了
        Debug.LogFormat("--- ccc 3");
    }
}

      解决办法是需要 Android 的 电话权限, 而且还不能动态申请, 一定要跳转到 app 信息里面手动把 电话权限 打开. 可以在 app 启动 onCreate 的下一帧提示一下去打开 (onCreate 里面不能做一些 ui 操作, 即使在 ui 线程中)

      @Override
protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    ...
    // 跳一帧, 检测 Android 12 电话权限
    new Handler(Looper.getMainLooper()).post(() -> Tools.adr12CallPermCheck());
}
unity中使用用gradle 打包（持续更新与改进）
Thewen
06-20 1万+
最新版Unity Android 打包原理解析 模板地址：C:\Program Files\Unity2018.4.3f1\Editor\Data\PlaybackEngines\AndroidPlayer\Tools\GradleTemplates unity用到的gradle版本地址：C:\Program Files\...
Unity版本升级2022 Gradle 升级7.x版本调整
两水先木示的博客
09-04 1657
务必删除mainTemplate.gradle的所有maven{ url ... }，所以查到是仍然支持的，但现在只需要settingsTemplate.gradle。settingsTemplate.gradle是新增的一个文件，用于统一管理所有的maven依赖加载路径。并且位于最前方，如果你还有其他的maven{ url ... } 请放置在它们下方。调整settingsTemplate.gradle文件的maven，必须添加有。mainTemplate.gradle有所变化，主要如下标红行。
Unity打包失败，Gradle构建失败问题良心解决，看完这个一定让你轻松
Unity游戏开发
04-25 3万+
Android打包失败问题良心解决，看完这个一定让你轻松 问题 CommandInvokationFailure: Gradle build failed. C:\Program Files\Java\jdk1.8.0_171\bin\java.exe -classpath “C:\Program Files\Unity2017.4.2.0\Editor\Data\PlaybackEngines\Android...
Unity打包安卓注意事项（包含Gradle配置问题）
最新发布
weixin_42378979的博客
03-26 1438
文章解决了unity打包过程中因Gradle版本导致的打包错误的问题，并添加了配置过程
Unity打包篇：能够解决Unity打包Gradle遇到的所有问题方法整合!(持续更新中!)
热门推荐
设计师养成记
05-31 6万+
大家自己的问题如果没有找到解决办法,请在下方留言,6小时之内绝对回复! 1.首先是准备工作也是基础工作,下载JDK和SDK,安装的时候就直接点下一步,不要自定义路径,就让他放c盘,总共也没几个G,JDK和SDK的下载链接如下,JDK为1.8 171 版本.SDK为24.4.1版本 JDK http://www.oracle.com/technetwork/cn/java/javase/dow...
Unity 安卓升级目标API 34
HelloYSK的博客
07-16 2205
处理升级 API Level 34 报错：AAPT2 aapt2-4.2.2-7147631-osx Daemon #0: Unexpected error during link......
如何升级gradle
11-30
升级gradle，太痛苦了，网上各种方法试了两天，没有效果。仔细浏览每次的错误和报警说明，碰巧试验成功。其实很简单，看文档吧，有图有真相。
Unity---升级gradle版本
学海无涯
08-06 1万+
接穿山甲SDK时，发现unity低版本的gradle版本太低。需要更新gradle版本到4.0.1以上！ 插件版本与gradle版本对应关系 如图，我们可以看出gradle插件4.0.1 最低需要下载gradle6.1.1版本。 各版本gradle下载地址 下载完成后，我们需要把解压出来的gradle文件中的lib文件复制替换到你使用的unity对应位置，就可以在maingradle里指定插件版本为4.0.1了 ......
为unity 更新自己想要的Gradle版本
qq_43488767的博客
10-18 8519
下载你需要的Gradle版本 找到你的unity的安装目录 1 该目录所在的Unity Editor安装路径下：\Editor\Data\PlaybackEngines\AndroidPlayer\Tools\gradle，将gradle目录下的lib文件夹进行备份后删除 2、将下载的Gradle压缩包解压出来的gradle-*目录里面的lib文件夹复制粘贴到gradle目录下（假装是5.4.1版本的Gradle，将解压出来的gradle-5.4.1目录下的lib文件夹复制到gradle目录下） ...
Unity Android 升级Gradle 报错 Task :unityLibrary:BuildIl2CppTask FAILED
liujunjie0120的博客
07-10 650
commandLineArgs.add("--tool-chain-path=" + android.ndkDirectory) 这一行错误。Unity 升级 到 2021.3.39， 升级 targetSdkVersion 34\35 导出Android 工程 出现 打包错误。参考 getSdkDir() 增加 getNdkDir()
CommandInvokationFailure: Gradle build failed. 记录一次unity打android失败的原因
小孔明的专栏
03-30 1634
target architectures：选择armv7和arm64。可以看到其lib文件夹下，能看到arm7以及arm8的so文件。arm8和arm7兼具的，包体自然要大一些。
gradle-6.7.1 安装包
12-02
Gradle 是一个强大的构建自动化工具，广泛用于Java、Android和其他多语言项目。Gradle 6.7.1是Gradle项目在2020年11月16日发布的稳定版本，提供了许多新特性和改进，旨在提升构建性能、可靠性和开发者体验。在这个...
gradle-6和8的版本
04-01
本篇将探讨Gradle 6.5.1与Gradle 8.0.2在Cocos Creator 3.7和3.8这两个不同版本中的应用，以及在Android Studio中如何进行项目构建和配置。 首先，Gradle 6.5.1是2020年发布的一个稳定版本，它引入了对Java 14的...
[Unity][Android]安装gradle7.0
BuladeMian的博客，菜得抠脚，菜得真实
07-31 536
通过参考资料1 或者按下下面的方式 AS新建空的项目 后，自动下载库。 Connection refused: connect gradle7.0没有安装 maven { url 'https://www.jitpack.io' } 屏蔽测试库，提高下载速度。 点Try Again，重新下载。 安装完毕后。 参考资料： 1.【极速下载】gradle各版本快速下载地址大全 2. ...
Unity升级Android Target API Level 34
qq_29925869的博客
09-11 1213
编辑AndroidManifest.xml文件，删除package, android:version ,android.versinName 选项配置。分别添加namespace “com.unity3d.player”，namespace “com.xxxx.xxxx”(package name)编辑mainTemplate.gradle、launcherTemplate.gradle。添加org.gradle.java.home=”JAVE_HOME”选项。JavaVersion 更改为17。
unity--maingradle中配置androidX
学海无涯
05-19 793
buildscript { repositories { google() jcenter() } dependencies { classpath'com.android.tools.build:gradle:4.0.1 } } allprojects { repositories { google() jcenter() flatDir { ...
Unity2019配置JDK、SDK、NDK、Gradle
y0205yang的博客
05-14 6177
用Unity开发了一个使用AR Foundation的小项目，导出项目需要在安卓手机上进行测试。在导出时遇到了配置环境的问题，查找了很多方法终于解决。记录一下。我所使用的unity版本是2019.2.12f。在完成项目需要导出时，在首选项设置中需要设置JDK、SDK、DNK、Gradle路径。下面分别写一下配置方法。
unity使用gradle方式打包遇到的坑（3）
jialeheyeshu的博客
02-26 1万+
使用带java8支持的gradle打包可能会遇到这样的问题： CommandInvokationFailure: Gradle build failed.  D:\jdk\jdk1.8.0_191\bin\java.exe -classpath "C:\Program Files\Unity\Editor\Data\PlaybackEngines\AndroidPlayer\Tools\grad...
unity导出错误Exception: Gradle install not valid
05-29
这个错误通常是由于Unity版本和Android Gradle插件版本不兼容导致的。您可以尝试以下方法来解决这个问题： 1. 检查您的Unity版本是否与所需的Gradle版本兼容。您可以在Unity官网上查看Unity版本和Gradle版本的兼容列表。 2. 尝试升级您的Gradle版本。您可以在Unity的“Edit”菜单下选择“Preferences”，然后在“External Tools”中找到“Android”的设置，然后将Gradle版本更改为最新的版本。 3. 如果上述方法都没有解决问题，请尝试手动安装Gradle。您可以在Gradle官网上下载Gradle，并将其放置在您的Unity项目的“Assets/Plugins/Android”目录下。 希望这些方法能够帮助您解决这个问题。
评论 4
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

蝶泳奈何桥.

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付：¥1
获取中
扫码支付

您的余额不足，请更换扫码支付或充值

打赏作者

实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值