Cocos Creator 打包原生 Android 包該如何選擇 NDK 版本？

張曉衡發表於2023-01-18
Android

大家好，我是曉衡！

記得前段時間，在一些群裡看到有小夥伴說 Cocos Creator 打包 Android 原生 APK 有問題：一種是構建失敗，一種是執行起來報錯。

曉衡也是有好長一段時間，沒有碰過 Android 原生打包，我用的這臺新電腦上環境都沒有配置。

正好這兩天，我將一個 2.0.10 的老專案，升級到了 Creator 3.6.2，並順手測試了一下在 3.6.2 上打包 Android APK包。

不知道為什麼，出乎意料的順利，一次性構建成功，安裝到手機上執行也很絲滑。

file

後來我發現有個關鍵點，Android NDK 版本不能用太新的，Cocos官方文件中推薦在 r18 ~ 21 之間。
file

在此記錄一下我的 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
file

安裝好後，第一次執行 Android Studio 會有一大......頓的下載更新操作，需要有點耐心，基本上是跟著提示來就行。
file

02 下載SDK 和 NDK

根據官方文件，下載當前主流 Platform SDK，我這裡下載的是 Level 33、Level 32 兩個版本。

file

然後切換到 SDK Tools 這一頁，安裝最新版本的 Build-Tools，我這裡顯示的是 33.0.1。
file
如果在你的電腦上，不是像上圖這樣顯示的，勾選皮膚底部的 Show Packages Details 核取方塊，就能看到了。

SDK Tools 皮膚繼續向下，找到 NDK(Side by side) ，我這裡選擇的是 18.1.5063045 ，看下圖：
file

勾選好後點選皮膚下面的 Apply 按鈕開始下載，再耐心等一陣。

03 Creator 偏好設定

Android SDK & NDK 下載完成後，開啟 Cocos Creator 主選單 -> 偏好設定 -> 外部程式，分別設定配置 NDK、SDK 路徑。
file

我用的是 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。
file

再設定一個 Android 的包名ID，螢幕方向設定為豎屏，其它的選項都預設。

檢查沒有問題後，依次點選構建皮膚下方的 構建 -> 生成，構建是生成 Cocos Creator 遊戲資源包，生成才是真正打包 Andoird APK。

這時，你可以開啟構建日誌，檢視整個 Android 構建打包過程。
file

最後顯示 BUILD SUCCESSFUL 就表示打包完成，我這個專案總共花了 3分46秒。
file

構建生成出的 APK 檔案路徑：

- release：當前工程/build/android/publish/release
- debug：當前工程/build/android/publish/debug

05 小結

這次打包 Android 感覺還是挺方便的，總結一下環境配置流程：

  1. 安裝 Android Studio 並按提示升級更新；
  2. 在 Android Studio 中下載 SDK、NDK；
  3. 在 Cocos Creator 中配置 Android SDK、NDK 路徑；
  4. 在 Cocos Creator 構建皮膚中選擇打包 Android 平臺。

希望我的分享能對你有所幫助和啟發！

更多精彩請關注Creator星球遊戲開發社群

相關文章