Unity打包Android最全攻略（含完整流程及常見(jiàn)問(wèn)題）

摘要：【建議收藏】最近收到的求助里面，超過(guò)80%的都是安卓打包出現(xiàn)的問(wèn)題，這篇文章包含Unity打包安卓的所有必要條件和常見(jiàn)問(wèn)題。

洪流學(xué)堂，讓你快人幾步。你好，我是你的技術(shù)探路者鄭洪智，你可以叫我大智。

最近寫了很多AR教程，在收到的小伙伴的求助里面，超過(guò)80%都是Android打包的問(wèn)題。這篇就把你Android打包問(wèn)題統(tǒng)統(tǒng)搞定。
如果你遇到的Android打包問(wèn)題本篇沒(méi)有包含，可以評(píng)論或者私信我（VX: zhz11235），一起完善這個(gè)攻略集。

Android打包的全部必要條件：
0、操作系統(tǒng)說(shuō)明：Windows/MacOS都可以
1、Unity的安裝及Android Build Support的安裝
2、JDK的下載安裝
3、Android SDK的下載安裝
4、Unity的JDK和Android SDK設(shè)置
5、Unity安卓工程的設(shè)置
6、打包流程可能出現(xiàn)的問(wèn)題

1、Unity的安裝及Android Build Support的安裝

Unity的安裝應(yīng)該不需要說(shuō)什么了，但是如果你要打包Android包的話一定要安裝Android Build Support這個(gè)組件??！

建議使用Unity Hub進(jìn)行安裝和維護(hù)。
地址：https://unity.cn/releases

新安裝Unity時(shí)可以帶上JDK和Android SDK，一站式解決JDK/Android SDK下載安裝的問(wèn)題。

安裝一個(gè)新版本的Unity

如果原來(lái)沒(méi)有安裝Android Build Support，在Unity Hub中可以通過(guò)如下方式安裝：

2、JDK的下載安裝【如果第1步安裝了Open JDK，可略過(guò)】

強(qiáng)烈建議在第1步時(shí)安裝內(nèi)置的Open JDK

如果你對(duì)JDK比較熟悉，那么你可以自己安裝JDK，這樣可以在不同的Unity版本之間共用。
需要注意一點(diǎn)是：Unity目前僅支持JDK8（1.8）版本
如果你機(jī)子上有多個(gè)JDK版本，一定要有一個(gè)1.8版本，在第4步指定一下JDK 1.8的目錄。

3、Android SDK的下載安裝【如果第1步安裝了Android SDK，可略過(guò)】

安裝Unity每個(gè)版本內(nèi)置的Android SDK是最簡(jiǎn)單的方法。
但是會(huì)有一個(gè)問(wèn)題，那就是安裝Unity版本多的話，占用的硬盤空間會(huì)很大。

動(dòng)手能力強(qiáng)的同學(xué)可以接著往下看，咱們讓所有的Unity版本共用一個(gè)Android SDK。
有兩個(gè)方法：
1、把Unity內(nèi)置安裝的Android SDK復(fù)制出來(lái)
2、使用Android Studio管理Android SDK

方法1：把Unity內(nèi)置安裝的Android SDK復(fù)制出來(lái)

以使用UnityHub安裝的Unity版本2019.3為例，Windows系統(tǒng)默認(rèn)路徑在：

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

你可以把SDK整個(gè)目錄復(fù)制到一個(gè)地方。
但是這個(gè)SDK沒(méi)法直接升級(jí)，升級(jí)的時(shí)候，有一個(gè)方法是在Unity Hub中安裝一下最新版本的Unity及Android和SDK，再?gòu)?fù)制出來(lái)。

方法2：使用Android Studio管理Android SDK

Android Studio是Android原生開發(fā)的IDE，下載地址是：https://developer.android.google.cn/studio

下載安裝后，運(yùn)行Android Studio，可能會(huì)彈出如下的框：


直接點(diǎn)Cancel，忽略它。

然后可以根據(jù)配置向?qū)渲貌惭bAndroid SDK【無(wú)墻】。

如果后續(xù)想升級(jí)Android SDK時(shí)，再次打開Android studio，如下選擇：

更新Android SDK時(shí)，除了打開的首屏，顯示的是SDK Platforms中可以更新；
記得還要更新第二個(gè)選項(xiàng)卡中的SDK Tools?。?！（很多時(shí)候報(bào)錯(cuò)SDK Tools 25.0.1 < 26.1.0都是第二屏中的SDK Tools版本太老）

通常下面三個(gè)紅框中的要更新。


4、Unity的JDK和Android SDK設(shè)置【如果第1步安裝了內(nèi)置JDK/Android SDK，可略過(guò)】

如果JDK和Android SDK是手動(dòng)安裝的，在Unity中需要設(shè)置一下JDK和Android SDK的路徑。

Unity菜單欄：Edit > Pereferences

如果使用Unity Hub安裝了內(nèi)置的JDK和Android SDK，Unity會(huì)自動(dòng)勾選使用內(nèi)置的SDK。


如果需要手動(dòng)設(shè)置，記得Android SDK要設(shè)置為比如build-tools的父目錄，例如我的是AndroidSDK。

5、Unity安卓工程的設(shè)置

創(chuàng)建工程時(shí)路徑不要有中文?。?！
創(chuàng)建工程時(shí)路徑不要有中文?。?！
創(chuàng)建工程時(shí)路徑不要有中文?。?！

如何確認(rèn)工程路徑是否有中文呢？
找到你的Unity工程目錄，光標(biāo)在地址欄點(diǎn)一下看一下是否中間有中文。
比如下圖中你第一眼看上去都是中文，但實(shí)際路徑并沒(méi)有中文。

path.gif

切換Platform為Android。

Unity菜單欄：File > Build Settings


設(shè)置Package Name
在上圖左下角，有一個(gè)Player Settings，點(diǎn)它！

這個(gè)Package Name需要設(shè)置成非默認(rèn)的com.Company.ProductName，需要是xxx.xxx.xxx的格式（2019.3開始Package Name默認(rèn)會(huì)和項(xiàng)目名稱關(guān)聯(lián)）

6、打包流程可能出現(xiàn)的問(wèn)題

上面都設(shè)置好以后就可以開始打包了，但是還有可能會(huì)出現(xiàn)很多問(wèn)題，下面就是常見(jiàn)問(wèn)題大全。
創(chuàng)建工程時(shí)路徑不要有中文！?。?/strong>
創(chuàng)建工程時(shí)路徑不要有中文?。?！
創(chuàng)建工程時(shí)路徑不要有中文?。?！

android build路徑太長(zhǎng)導(dǎo)致打包失敗問(wèn)題（Windows）

一般提示為Unable to create xxxxx

有兩種方式：
方法一：把工程移到盤符根目錄，比如直接放D盤下面
方法二：修改支持260個(gè)字符以上的路徑：

1、按下鍵盤上的Win+R鍵打開運(yùn)行命令框，輸入Gpedit.msc后回車
2、一步步找本地計(jì)算機(jī)策略>計(jì)算機(jī)配置>管理模板>系統(tǒng)>文件系統(tǒng)>中有一個(gè)啟用Win32長(zhǎng)路徑選項(xiàng)

3、設(shè)置已啟用后點(diǎn)擊確定?？赡苄枰貑⒂?jì)算機(jī)。

卡在build gradle project（gradle代理修改）

一般見(jiàn)于第一次打包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'.

這是因?yàn)檫B接不到google maven的中心庫(kù)，可以切換到國(guó)內(nèi)的aliyun的源加快速度。

工程內(nèi)設(shè)置【適用于Unity2019.2及之前】

可以使用aliyun的maven庫(kù)解決，流程如下：
1、勾選Player Settings里面的Publishing Settings中的Custom Gradle Template。如下圖：

2、勾選后會(huì)在工程中生成一個(gè)文件，路徑在Plugins\Android\mainTemplate.gradle。按下圖提示，修改文件中的內(nèi)容為：

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

上述方法優(yōu)點(diǎn)：可以通過(guò)版本控制在團(tuán)隊(duì)中共享配置，無(wú)需每個(gè)團(tuán)隊(duì)成員單獨(dú)設(shè)置
缺點(diǎn)：每個(gè)工程都需要設(shè)置一次

Unity全局設(shè)置【適用于所有Unity版本】
Unity2019.3及之后在工程內(nèi)生成的mainTemplate.gradle中沒(méi)有repositories設(shè)置，所以只能修改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/'}

上述方法優(yōu)點(diǎn)：一次設(shè)置，所有使用這個(gè)版本的Unity工程都適用
缺點(diǎn)：切換Unity版本時(shí)需要重新設(shè)置；團(tuán)隊(duì)小伙伴每臺(tái)電腦都需要設(shè)置

擴(kuò)展閱讀

后續(xù)更新

如果你遇到的Android打包問(wèn)題本篇沒(méi)有包含，可以評(píng)論或者私信我（VX: zhz11235），一起完善這個(gè)攻略集。
本文最新永久鏈接：http://www.itdecent.cn/p/61d8939a4aeb

好了，今天就絮絮叨叨到這里了。
沒(méi)講清楚的地方歡迎評(píng)論，也可以加我微信討論。

我是大智（VX: zhz11235），你的技術(shù)探路者，下次見(jiàn)！

別走！點(diǎn)贊，收藏哦！

好，你可以走了。

最后編輯于 ：
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請(qǐng)聯(lián)系作者
【社區(qū)內(nèi)容提示】社區(qū)部分內(nèi)容疑似由AI輔助生成，瀏覽時(shí)請(qǐng)結(jié)合常識(shí)與多方信息審慎甄別。
平臺(tái)聲明：文章內(nèi)容（如有圖片或視頻亦包括在內(nèi)）由作者上傳并發(fā)布，文章內(nèi)容僅代表作者本人觀點(diǎn)，簡(jiǎn)書系信息發(fā)布平臺(tái)，僅提供信息存儲(chǔ)服務(wù)。

友情鏈接更多精彩內(nèi)容