unity-2018.4升级到2019.4记录
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_ROOT\Editor\Data\PlaybackEngines\AndroidPlayer\Tools\gradle) 替换为目的版本的 lib2019 支持编辑器配置 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 工程根目录
1
2def projDir = String.format("../../..") // 2019
def projDir = String.format("../..") // 2018引用 unityLibrary 模块中引用的 jar
因为在 Plugins\Android 目录里的 jar (也就是一些 第三方 sdk 或者 自己的 java 代码生成的 jar), 都将会生成到 unityLibrary 模块中的 libs 目录下, launcher 模块默认只引用了 unityLibrary 模块
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19dependencies {
implementation project(':unityLibrary')
// 引用 unityLibrary 中引用的库
implementation fileTree(dir: String.format("%s/libs", project(':unityLibrary').getProjectDir().toString()), include: ['*.jar'])
}
---
### 混淆配置 修改
1. unity 工程根目录需要退 3 级别, 因为这个 gradle 在 android 工程里已经在 *unityLibrary* 模块中了
```json
# 未混淆的类和成员
# -printseeds ../../patch/proguard-log/seeds.txt # 2018 退 2 级到根目录
# -printseeds ../../../../../../../../patch/proguard-log/seeds.txt # 2019 退 8 级到根目录- 库模块的 gradle 中的混淆配置 consumerProguardFiles, 到根目录的路径要退 8 级目录
maven 仓库修改
2019 也就是 baseProjectTemplate.gradle 文件
将 maven 仓库地址写在这个文件中
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100allprojects {
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
```xml
<?xml version="1.0" encoding="utf-8"?>
<!-- GENERATED BY UNITY. REMOVE THIS COMMENT TO PREVENT OVERWRITING WHEN EXPORTING AGAIN-->
<manifest
xmlns:android="http://schemas.android.com/apk/res/android"
package="com.unity3d.player" // 这个也可以删掉, 因为库模块不需要包名
xmlns:tools="http://schemas.android.com/tools">
<application>
<!-- 注释掉这个, 不然 *LauncherManifest.xml* 中指定的启动 activity 无效
<activity android:name="com.unity3d.player.UnityPlayerActivity"
android:theme="@style/UnityThemeSelector">
<intent-filter>
<action android:name="android.intent.action.MAIN" />
<category android:name="android.intent.category.LAUNCHER" />
</intent-filter>
<meta-data android:name="unityplayer.UnityActivity" android:value="true" />
</activity>
-->
</application>
</manifest>
---
#### app 名字/icon 修改
- 默认 icon 是 `@mipmap/app_icon`, 而是用 as 生成的 icon 这是 `ic_launcher`
```xml
<application android:label="@string/app_name" android:icon="@mipmap/ic_launcher">
</application>
---
### tolua 修改
使用了 tolua, 重新导出 wrap 文件, 编辑器运行时不报错, 打包是报错: `'MeshRenderer' does not contain a definition for 'scaleInLightmap'`
- 原因是新版引擎的 *MeshRenderer* 类增加了几个 editor 属性, 只能在编辑器模式下运行
- 所以要 tolua 屏蔽掉这几个属性, 在 `ToLuaExport.cs` 中添加这几个属性, 然后重新导出 wrap 即可
```csharp
public static List<string> memberFilter = new List<string> {
...
"MeshRenderer.scaleInLightmap",
"MeshRenderer.receiveGI",
"MeshRenderer.stitchLightmapSeams"
};
修改思路
- 导出 Android 工程对比
- 打出的 apk 包反编译对比