「」于2019年11月开启,现已收到数百篇原创投稿。每周根据Unity Connect社区反馈,帮助大家发现最优质、最干货、最受欢迎的博文作品。

,在Unity社区分享经验,你也有机会获得官方推荐哦!

之前收到许多小伙伴的求助,超过80%都是有关Android打包的问题。本文将针对此话题详细地来说一说。

Android打包的全部必要条件:

操作系统说明:Windows/MacOS都可以

Unity的安装及Android Build Support的安装

JDK的下载安装

Android SDK的下载安装

Unity的JDK和Android SDK设置

Unity安卓工程的设置

打包流程可能出现的问题

Unity及Android Build Support的安装

Unity的安装大家可以按照官网上的说明进行操作,这里提醒一下如果你要打包Android包的话一定要安装Android Build Support这个组件!!

建议使用Unity Hub进行安装和维护。
地址:https://unity.cn/releases

新安装Unity时可以带上JDK和Android SDK,一站式解决JDK/Android SDK下载安装的问题。

安装一个新版本的Unity

如果原来没有安装Android Build Support,在Unity Hub中可以通过如下方式安装:

JDK的下载安装

*如果第1步已经安装了Open JDK,此步可略过

强烈建议在第1步时安装内置的Open JDK

如果你对JDK比较熟悉,那么你可以自己安装JDK,这样可以在不同的Unity版本之间共用。

需要注意一点是:Unity目前仅支持JDK8(1.8)版本,如果你机子上有多个JDK版本,一定要有一个1.8版本,在第4步指定一下JDK 1.8的目录。

Android SDK的下载安装

*如果第1步安装了Android SDK,此步可略过

安装Unity每个版本内置的Android SDK是最简单的方法。

但是会有一个问题,那就是安装Unity版本多的话,占用的硬盘空间会很大。

动手能力强的同学可以接着往下看,咱们让所有的Unity版本共用一个Android SDK。
有两个方法:

方法一
把Unity内置安装的Android SDK复制出来

以使用UnityHub安装的Unity版本2019.3为例,Windows系统默认路径在:

C:\ProgramFiles\Unity\Hub\Editor\2019.3.0f6\Editor\Data\PlaybackEngines\AndroidPlayer\SDK

你可以把SDK整个目录复制到一个地方。

但是这个SDK没法直接升级,升级的时候,有一个方法是在Unity Hub中安装一下最新版本的Unity及Android和SDK,再复制出来。

方法二

使用Android Studio管理Android SDK

Android Studio是Android原生开发的IDE,下载地址是:

https://developer.android.google.cn/studio

下载安装后,运行Android Studio,可能会弹出如下的框:

直接点Cancel,忽略它。

然后可以根据配置向导配置并安装Android SDK【无墙】。

如果后续想升级Android SDK时,再次打开Android studio,如下选择:

更新Android SDK时,除了打开的首屏,显示的是SDK Platforms中可以更新;

记得还要更新第二个选项卡中的SDK Tools!!!(很多时候报错 SDK Tools 25.0.1 < 26.1.0 都是第二屏中的SDK Tools版本太老)

通常下面三个红框中的要更新。

Unity的JDK和Android SDK设置

*如果第1步安装了内置JDK/Android SDK,此步可略过

如果JDK和Android SDK是手动安装的,在Unity中需要设置一下JDK和Android SDK的路径。

Unity菜单栏:Edit > Pereferences

如果使用Unity Hub安装了内置的JDK和Android SDK,Unity会自动勾选使用内置的SDK。

如果需要手动设置,记得Android SDK要设置为比如build-tools的父目录,例如我的是 AndroidSDK 。

Unity安卓工程的设置

创建工程时路径不要有中文!!!

如何确认工程路径是否有中文呢?

找到你的Unity工程目录,光标在地址栏点一下看一下是否中间有中文。比如下图中你第一眼看上去都是中文,但实际路径并没有中文。

path.gif

切换Platform为Android。Unity菜单栏:File > Build Settings

设置Package Name

在上图左下角,有一个Player Settings,点它!

这个Package Name需要设置成非默认的com.Company.ProductName,需要是xxx.xxx.xxx的格式(2019.3开始Package Name默认会和项目名称关联)

打包流程可能出现的问题

上面都设置好以后就可以开始打包了,但是还有可能会出现很多问题,下面就是常见问题大全。

创建工程时路径不要有中文!!!

android build路径太长导致打包失败问题(Windows)

一般提示为Unable to create xxxxx

有两种方式:
方法一:把工程移到盘符根目录,比如直接放D盘下面
方法二:修改支持260个字符以上的路径:

1、按下键盘上的Win+R键打开运行命令框,输入Gpedit.msc后回车
2、一步步找本地计算机策略>计算机配置>管理模板>系统>文件系统>中有一个启用Win32长路径选项

3、设置已启用后点击确定。可能需要重启计算机。

卡在build gradle project(gradle代理修改)

一般见于第一次打包Android包,提示可能为:

Caused by: org.gradle.api.resources.ResourceException: Could not get resource 'https://jcenter.bintray.com/com/android/support/support-media-compat/27.0.2/support-media-compat-27.0.2.aar'.

这是因为连接不到google maven的中心库,可以切换到国内的aliyun的源加快速度。

工程内设置【适用于Unity2019.2及之前】

可以使用aliyun的maven库解决,流程如下:

1、勾选Player Settings里面的Publishing Settings中的Custom Gradle Template。如下图:

2、勾选后会在工程中生成一个文件,路径在Plugins\Android\mainTemplate.gradle。按下图提示,修改文件中的内容为:

上述方法优点:可以通过版本控制在团队中共享配置,无需每个团队成员单独设置
缺点:每个工程都需要设置一次

Unity全局设置【适用于所有Unity版本】

Unity2019.3及之后在工程内生成的mainTemplate.gradle中没有repositories设置,所以只能修改Unity安装目录里面的.gradle模板。

路径在:

// 2019.3及以后C:\Program Files\Unity\Hub\Editor\2019.2.19f1\Editor\Data\PlaybackEngines\AndroidPlayer\Tools\GradleTemplates\mainTemplate.gradle

// 2019.2及之前C:\Program Files\Unity\Hub\Editor\2019.2.17f6\Editor\Data\PlaybackEngines\AndroidPlayer\Tools\GradleTemplates\baseProjectTemplate.gradle

修改方法如图:

上述方法优点:一次设置,所有使用这个版本的Unity工程都适用
缺点:切换Unity版本时需要重新设置;团队小伙伴每台电脑都需要设置