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),你的技術探路者,下次見!

別走!點贊收藏哦!

好,你可以走了。

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章