這一篇講的是用 Cocos Creator 編譯器打包 Android APP 的時候遇到的一些問題,雖然說打包的過程不是很復雜,但是在其中還是會遇到各式各樣的坑。
我們將項目用CCC(Cocos Creator)編譯器打包的時候,肯定是要先配置一下本機的開發環境,我這里主要是打包成 Android APP 的時候需要依賴的開發環境。
下載 Java SDK(JDK)
在編譯 Android 工程的時候需要在本地電腦上有完整的 Java SDK 工具,如果沒有這個工具可以到下面的地址下載:
Java SE Development Kit 8 Downloads
下載的時候注意選擇一下和本機匹配的操作系統和架構,下載完成后運行安裝就可以了。
安裝后檢查 Java 環境就是在命令行工具中輸入以下代碼來查看:
輸出顯示結果為上圖,則沒有問題,如果系統中使用的是JRE則需要安裝 JAVA SE 運行環境
檢查之后,我們還需要確認下本機的環境變量中是否包含 JAVA_HOME 。沒有配置環境的可以通過右鍵點擊我的電腦,選擇屬性,打開高級選項卡來查看和修改環境變量。
變量值就是安裝Java的路徑,修改完成之后需要重啟一下電腦才會生效。
依照官方文檔,下載 JDK 后是通過 Android Studio 下載所需的 SDK 和 NDK。當然也可以自己去獨自下載這兩個工具: SDK 、NDK 。下載之后就是運行安裝就可以了。
我們這邊就先講講從 Android Studio 中去下載,首先就是 安裝 Android Studio 。安裝的過程中直接點下一步,下一步就可以了。
安裝完成之后,運行打開一個新的文件就可以了,進入主界面之后。點擊主界面右上角的一個是下載的圖標去下載安裝我們所需的工具。
點開之后進入分頁欄,根據自己想支持的手機版本去下載
在 SDK Tools 分頁欄,首先勾選右下角的 Show Package Details,顯示分版本的工具選擇。
在 Android SDK Build-Tools 里,選擇最新的 build tools 版本。
勾選 Android SDK Platform-Tools, Android SDK Tools 和 Android Support Library
勾選 NDK,確保版本在 14 以上(推薦使用 r16)。NDK-r18 已經移除了 GNU 編譯器,請 Creator v2.0.9 以下的版本 不要 將 NDK 更新到 r18,否則會導致編譯報錯。
記住窗口上方所示的 Android SDK Location 指示的目錄,稍后我們需要在 Cocos Creator 里填寫這個 SDK 所在位置。
點擊 OK,根據提示完成安裝。
配置原生發布環境路徑
下載安裝好開發環境依賴后,讓我們回到 Cocos Creator 中配置構建發布原生平台的環境路徑。在主菜單中選擇 文件 -> 設置,打開設置窗口:
在原生開發環境里面要配置兩個路徑:
- NDK 路徑,選擇
Android SDK Location
路徑下的ndk-bundle
文件夾(NDK 是其根目錄),不需要編譯 Android 平台的話這里可以跳過。 - Android SDK 路徑,選擇剛才在 SDK Manager 中記下的
Android SDK Location
路徑(Android SDK 的目錄下應該包含 build-tools、platforms 等文件夾),不需要編譯 Android 平台的話這里可以跳過。
配置完成后點擊 保存 按鈕,保存並關閉窗口。
配置好開發環境后就是打包發布了。
打包發布原生平台
點擊菜單欄的 項目 -> 構建發布,打開構建發布面板。或者快捷鍵 Ctrl + Shift + B 也可以打開構建發布面板。
這里的這些構建選項都可以參考 Cocos Creator 的官方文檔 去查看各個選項的作用,這里就不再一一列出了。
構建原生工程
選擇發布平台,設置了初始場景后,就可以開始構建了,點擊右下角的 構建 按鈕,開始構建流程。
構建成功后,在CCC編譯器面板的控制台,看到輸出了
Built to "C:\Users\Administrator\Desktop\Animation\build\jsb-link" successfully
就表示已經構建成功。構建結束后,我們得到的是一個標准的 cocos2d-x 工程,和使用 Cocos Console 新建的工程有同樣的結構。接下來我們可以選擇通過 Cocos Creator 編輯器的進程進行編譯,以及運行桌面預覽,或手動在相應平台的 IDE 中打開構建好的原生工程,進行進一步的預覽、調試和發布。
通過編譯器去編譯和運行
點擊下方的 編譯 按鈕,進入編譯流程,如果模板選擇了 link
的源碼版引擎,這個編譯的過程將會花費比較久的時間。編譯成功后會提示
Compile native project successfully.
如果在控制台中顯示出現錯誤的,建議刪除掉 SDK 中的 ndk-bundle 文件,然后重新 下載 DNK 文件,建議下載舊版本 r16 或者 r17,下載最新版本可能會報錯。
下載完成后將下載的文件替換掉我們刪除的 ndk-bundle 文件,並將文件名更改成 ndk-bundle 。然后再次進行編譯。
接下來就可以點擊右下角的 運行 按鈕,通過默認方式預覽原生平台的游戲。
點擊運行后,視平台不同可能還會繼續進行一部分編譯工作,請耐心等待或通過日志文件查看進展。
如果我們沒有更改路徑,打包后的 apk 會在 build\jsb-link\publish\android 里面。
這就完成了打包,雖然不是很難,但是我們總是會因為配置環境變量的問題,而報出各種錯誤,在下載工具的時候也會因為工具的殘缺,報出各式各樣的錯誤,總之會出現各種各樣的坑。