unity-2018.4升级到2019.4记录

Posted 2022-07-28 蝶泳奈何桥.

---

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_ROOT\\Editor\\Data\\PlaybackEngines\\AndroidPlayer\\Tools\\gradle) 替换为目的版本的 lib

• 2019 支持编辑器配置 gradle 目录

  edit -> preference -> external tools

  

---

升级 NDK

• 2019 使用 android-ndk-r19

---

JDK 不变

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

---

app gradle 修改

2019 也就是 launcherTemplate.gradle 文件

1. unity 工程根目录需要退 3 级别, 因为这个 gradle 在 android 工程里已经在 launcher 模块中了, 而 2018 则是直接在 android 工程根目录

   def projDir = String.format("../../..") // 2019
   def projDir = String.format("../..") // 2018
   

2. 引用 unityLibrary 模块中引用的 jar

   因为在 Plugins\\Android 目录里的 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'])
   
   
   
   
   

---

混淆配置 修改

1. 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

  <?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

  <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 即可

  public static List<string> memberFilter = new List<string> 
      ...
      "MeshRenderer.scaleInLightmap",
      "MeshRenderer.receiveGI",
      "MeshRenderer.stitchLightmapSeams"
  ;
  

---

修改思路

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

---