unity-2018.4升级到2019.4记录

title: unity-2018.4升级到2019.4记录
categories: Unity3d
tags: [unity, android, gradle, 升级]
date: 2022-04-28 14:27:03
comments: false
mathjax: true
toc: true

unity-2018.4升级到2019.4记录

前篇

Gradle for Android - https://docs.unity3d.com/cn/2019.4/Manual/android-gradle-overview.html

Android 构建说明

在安卓方面, 2018.4 和 2019.4 的还是有点差异的

2018.4
- 构建工具
- 导出 Android 工程
  
  根目录就是一个应用模块, 自定义的 mainTemplate.gradle 就是应用模块的 build.gradle
2019.4
- 构建工具
- 导出 Android 工程
  
  分为两个模块, launcher 是应用模块, unityLibrary 是库模块
  - launcherTemplate.gradle 和 LauncherManifest.xml 会生成到应用模块
  - mainTemplate.gradle 和 AndroidManifest.xml 和 proguard-user.txt 会生成到库模块
  - baseProjectTemplate.gradle 会生成为根目录的 build.gradle
  官方说明: 导出的 Gradle 项目结构
  - UnityLibrary 模块：包含 Unity 运行时和项目数据。该模块是可以集成到其他任何 Gradle 项目中的一种库。这个模块可以用于将 Unity 嵌入现有的 Android 应用程序中。
  - Launcher 模块：包含应用程序的名称及其所有图标。这是一个可启动 Unity 的简单 Android 应用程序模块。您可以将其替换为自己的应用程序。

构建工具升级升级 Gradle

2018 需要自己去引擎目录 (UNITY_ROOTEditorDataPlaybackEnginesAndroidPlayerToolsgradle) 替换为目的版本的 lib
2019 支持编辑器配置 gradle 目录

edit -> preference -> external tools

升级 NDK

2019 使用 android-ndk-r19

JDK 不变

和 2018 一样, 也是使用 java1.8

app gradle 修改

2019 也就是 launcherTemplate.gradle 文件

unity 工程根目录需要退 3 级别, 因为这个 gradle 在 android 工程里已经在 launcher 模块中了, 而 2018 则是直接在 android 工程根目录
```
def projDir = String.format("../../..") // 2019
def projDir = String.format("../..") // 2018
```
引用 unityLibrary 模块中引用的 jar

因为在 PluginsAndroid 目录里的 jar (也就是一些第三方 sdk 或者自己的 java 代码生成的 jar), 都将会生成到 unityLibrary 模块中的 libs 目录下, launcher 模块默认只引用了 unityLibrary 模块
```
dependencies {
    implementation project(':unityLibrary')

    // 引用 unityLibrary 中引用的库
    implementation fileTree(dir: String.format("%s/libs", project(':unityLibrary').getProjectDir().toString()), include: ['*.jar'])
}
```

混淆配置修改

unity 工程根目录需要退 3 级别, 因为这个 gradle 在 android 工程里已经在 unityLibrary 模块中了
```
# 未混淆的类和成员
# -printseeds ../../patch/proguard-log/seeds.txt # 2018 退 2 级到根目录
# -printseeds ../../../../../../../../patch/proguard-log/seeds.txt # 2019 退 8 级到根目录
```
- 库模块的 gradle 中的混淆配置 consumerProguardFiles, 到根目录的路径要退 8 级目录

maven 仓库修改

2019 也就是 baseProjectTemplate.gradle 文件

将 maven 仓库地址写在这个文件中

allprojects {
    buildscript {
        repositories {**ARTIFACTORYREPOSITORY**
            // 自定义 maven
            maven { url 'http://192.168.1.233:8081/repository/aaa/' }
        }

        dependencies {
            // 自定义 gradle 构建工具
            classpath 'com.android.tools.build:gradle:4.2.0'
            classpath 'com.google.gms:google-services:4.3.3'
        }

        // 详细日志输出
        gradle.projectsEvaluated {
            tasks.withType(JavaCompile) {
                options.compilerArgs << "-Xlint:unchecked" << "-Xlint:deprecation"
            }
        }
    }

    repositories {**ARTIFACTORYREPOSITORY**
        // 自定义 maven
        maven { url 'http://192.168.1.233:8081/repository/aaa/' }
    }
}

清单文件修改

2019 包含两个模块的清单文件

LauncherManifest.xml

也就是之前版本 AndroidManifest.xml 内容全部移到这个文件中, 作为应用模块的清单文件

为啥一定要在应用模块呢? 因为这个清单文件里面有些内容是 gradle 工具动态配置的, 如: 包名, 而包名又必须是在应用模块才能获取到.
AndroidManifest.xml

这个文件一定要有, 不然默认 unity 会使用默认的清单文件, 里面有指定启动 activity, 会覆盖 LauncherManifest.xml 中指定的启动 activity
```
    
        
    
```

app 名字/icon 修改

默认 icon 是 @mipmap/app_icon, 而是用 as 生成的 icon 这是 ic_launcher

tolua 修改

使用了 tolua, 重新导出 wrap 文件, 编辑器运行时不报错, 打包是报错: 'MeshRenderer' does not contain a definition for 'scaleInLightmap'

原因是新版引擎的 MeshRenderer 类增加了几个 editor 属性, 只能在编辑器模式下运行

所以要 tolua 屏蔽掉这几个属性, 在 ToLuaExport.cs 中添加这几个属性, 然后重新导出 wrap 即可

public static List memberFilter = new List {
    ...
    "MeshRenderer.scaleInLightmap",
    "MeshRenderer.receiveGI",
    "MeshRenderer.stitchLightmapSeams"
};

修改思路

导出 Android 工程对比
打出的 apk 包反编译对比

unity-2018.4升级到2019.4记录

Unity3D相关栏目本月热门文章