大家好,我是曉衡!
記得前段時間,在一些群里看到有小伙伴說 Cocos Creator 打包 Android 原生 APK 有問題:一種是構建失敗,一種是運行起來報錯。
曉衡也是有好長一段時間,沒有碰過 Android 原生打包,我用的這臺新電腦上環境都沒有配置。
正好這兩天,我將一個 2.0.10 的老項目,升級到了 Creator 3.6.2,并順手測試了一下在 3.6.2 上打包 Android APK包。
不知道為什么,出乎意料的順利,一次性構建成功,安裝到手機上運行也很絲滑。
后來我發現有個關鍵點,Android NDK 版本不能用太新的,Cocos官方文檔中推薦在 r18 ~ 21 之間。
在此記錄一下我的 Android 構建配置流程,如果有小伙伴,在打包 APK 遇到問題可以參考一下。
01 官方文檔
我在打包 Android 前,還是先認認真真地,看了下官方文檔的。
- 《安裝配置原生開發環境》
- 鏈接:https://docs.cocos.com/creator/manual/zh/editor/publish/setup-native-development.html
首先下載安裝 Android Studio,下圖是我安裝好的版本:Android Studio Dolphin | 2021.3.1
安裝好后,第一次運行 Android Studio 會有一大......頓的下載更新操作,需要有點耐心,基本上是跟著提示來就行。
02 下載SDK 和 NDK
根據官方文檔,下載當前主流 Platform SDK,我這里下載的是 Level 33、Level 32 兩個版本。
然后切換到 SDK Tools 這一頁,安裝最新版本的 Build-Tools,我這里顯示的是 33.0.1。
如果在你的電腦上,不是像上圖這樣顯示的,勾選面板底部的
Show Packages Details
復選框,就能看到了。
SDK Tools 面板繼續向下,找到 NDK(Side by side) ,我這里選擇的是 18.1.5063045
,看下圖:
勾選好后點擊面板下面的 Apply 按鈕開始下載,再耐心等一陣。
03 Creator 偏好設置
Android SDK & NDK 下載完成后,打開 Cocos Creator 主菜單 -> 偏好設置 -> 外部程序,分別設置配置 NDK、SDK 路徑。
我用的是 Mac 系統,路徑在:
- NDK: /Users/[用戶名]/Library/Android/sdk/ndk/18.1.5063045
- SDK:/Users/[用戶名]/Library/Android/sdk
你可在自己電腦上 Android Studio 的 SDK 面板上可以找到,具體路徑位置。
04 Creator 構建發布
打開 Creator 構建面板,創建一個 Android 發布,在 Target API Level 一項會檢測到我們安裝的 Android SDK 版本,我這里配置的是 android-32。
再設置一個 Android 的包名ID,屏幕方向設置為豎屏,其它的選項都默認。
檢查沒有問題后,依次點擊構建面板下方的 構建
-> 生成
,構建是生成 Cocos Creator 游戲資源包,生成才是真正打包 Andoird APK。
這時,你可以打開構建日志,查看整個 Android 構建打包過程。
最后顯示 BUILD SUCCESSFUL 就表示打包完成,我這個項目總共花了 3分46秒。
構建生成出的 APK 文件路徑:
- release:當前工程/build/android/publish/release
- debug:當前工程/build/android/publish/debug
05 小結
這次打包 Android 感覺還是挺方便的,總結一下環境配置流程:
- 安裝 Android Studio 并按提示升級更新;
- 在 Android Studio 中下載 SDK、NDK;
- 在 Cocos Creator 中配置 Android SDK、NDK 路徑;
- 在 Cocos Creator 構建面板中選擇打包 Android 平臺。
希望我的分享能對你有所幫助和啟發!
更多精彩請關注Creator星球游戲開發社區