Unity打包Android最全攻略(含完整流程及常见问题)

摘要:【建议收藏】最近收到的求助里面,超过80%的都是安卓打包出现的问题,这篇文章包含Unity打包安卓的所有必要条件和常见问题。

洪流学堂,让你快人几步。你好,我是你的技术探路者郑洪智,你可以叫我大智。

最近写了很多AR教程,在收到的小伙伴的求助里面,超过80%都是Android打包的问题。这篇就把你Android打包问题统统搞定。
如果你遇到的Android打包问题本篇没有包含,可以评论或者私信我(VX: zhz11235),一起完善这个攻略集。

Android打包的全部必要条件:
0、操作系统说明:Windows/MacOS都可以
1、Unity的安装及Android Build Support的安装
2、JDK的下载安装
3、Android SDK的下载安装
4、Unity的JDK和Android SDK设置
5、Unity安卓工程的设置
6、打包流程可能出现的问题

1、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中可以通过如下方式安装:

2、JDK的下载安装【如果第1步安装了Open JDK,可略过】

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

如果你对JDK比较熟悉,那么你可以自己安装JDK,这样可以在不同的Unity版本之间共用。
需要注意一点是:Unity目前仅支持JDK8(1.8)版本
如果你机子上有多个JDK版本,一定要有一个1.8版本,在第4步指定一下JDK 1.8的目录。

3、Android SDK的下载安装【如果第1步安装了Android SDK,可略过】

安装Unity每个版本内置的Android SDK是最简单的方法。
但是会有一个问题,那就是安装Unity版本多的话,占用的硬盘空间会很大。

动手能力强的同学可以接着往下看,咱们让所有的Unity版本共用一个Android SDK。
有两个方法:
1、把Unity内置安装的Android SDK复制出来
2、使用Android Studio管理Android SDK

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

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

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

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

方法2:使用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版本太老)

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


4、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

5、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默认会和项目名称关联)

6、打包流程可能出现的问题

上面都设置好以后就可以开始打包了,但是还有可能会出现很多问题,下面就是常见问题大全。
创建工程时路径不要有中文!!!
创建工程时路径不要有中文!!!
创建工程时路径不要有中文!!!

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。按下图提示,修改文件中的内容为:

maven{url 'http://maven.aliyun.com/nexus/content/repositories/central/'}

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

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

修改方法如图:

maven{url 'http://maven.aliyun.com/nexus/content/repositories/central/'}

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

扩展阅读

后续更新

如果你遇到的Android打包问题本篇没有包含,可以评论或者私信我(VX: zhz11235),一起完善这个攻略集。
本文最新永久链接:https://www.jianshu.com/p/61d8939a4aeb


好了,今天就絮絮叨叨到这里了。
没讲清楚的地方欢迎评论,也可以加我微信讨论。

我是大智(VX: zhz11235),你的技术探路者,下次见!

别走!点赞收藏哦!

好,你可以走了。

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 204,053评论 6 478
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 85,527评论 2 381
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 150,779评论 0 337
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 54,685评论 1 276
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 63,699评论 5 366
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,609评论 1 281
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 37,989评论 3 396
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,654评论 0 258
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 40,890评论 1 298
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,634评论 2 321
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,716评论 1 330
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,394评论 4 319
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 38,976评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,950评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,191评论 1 260
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 44,849评论 2 349
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,458评论 2 342