說明:cocos creator官方網(wǎng)上也有很詳細(xì)的安裝配置步驟。本文僅供常考。
一.安裝
1.首先到cocos官網(wǎng)http://www.cocos.com下載穩(wěn)定版或是去下載最新版。
2.接下來就是傻瓜式的安裝了安裝完成璧函。
注意:如果初次運(yùn)行時(shí)出現(xiàn)下載的應(yīng)用已損壞的提示,請(qǐng)前往并設(shè)置 系統(tǒng)偏好設(shè)置->安全性與隱私->允許任何來源的應(yīng)用基显,首次打開后您可以馬上恢復(fù)您的安全與隱私設(shè)置蘸吓。Mac OS X 所支持的最低版本是 OS X 10.9。
3.打開cocos creator 撩幽,會(huì)提示登錄cocos賬戶库继,有的話直接登錄,沒有就需要注冊(cè)一個(gè)賬戶摸航。
二.配置原生開發(fā)環(huán)境
除了內(nèi)置的 Web 版游戲發(fā)布功能外制跟,Cocos Creator 使用基于 cocos2d-x 引擎的 JSB 技術(shù)實(shí)現(xiàn)跨平臺(tái)發(fā)布原生應(yīng)用。在使用 Cocos Creator 打包發(fā)布到原生平臺(tái)之前酱虎,我們需要先配置好 cocos2d-x 相關(guān)的開發(fā)環(huán)境。
1.Android 平臺(tái)相關(guān)依賴(如果你需要打安卓包的話)
要發(fā)布到 Android 平臺(tái)擂涛,需要安裝以下全部開發(fā)環(huán)境依賴读串。
如果您沒有發(fā)布到 Android 平臺(tái)的計(jì)劃聊记,或您的操作系統(tǒng)上已經(jīng)有完整的 Android 開發(fā)環(huán)境,可以跳過這個(gè)部分恢暖。
下載 Java SDK (JDK)
編譯 Android 工程需要本地電腦上有完整的 Java SDK 工具排监,請(qǐng)到以下地址下載:
Java SE Development Kit 8 Downloads
下載時(shí)注意選擇和本機(jī)匹配的操作系統(tǒng)和架構(gòu),下載完成后運(yùn)行安裝程序即可杰捂。
安裝后請(qǐng)檢查 JAVA 環(huán)境舆床,在 Mac 終端或者 Windows 命令行工具中輸入下面代碼來查看:
java -version
顯示為 JAVA SE 則沒有問題,如果系統(tǒng)中使用的是 JRE嫁佳,則需要安裝?JAVA SE 運(yùn)行環(huán)境挨队。
下載安裝 Android Studio
從 v1.5 開始,我們支持最新版本的 Android Studio 和配套的構(gòu)建工具蒿往,推薦使用 Android Studio 作為安卓平臺(tái)的構(gòu)建工具盛垦,并在 Android Studio 里下載所需的 SDK 和 NDK 包。首先請(qǐng)?安裝 Android Studio瓤漏。
下載發(fā)布 Android 平臺(tái)所需的 SDK 和 NDK
安裝 Android Studio 完成后腾夯,參考官方文檔,打開 SDK Manager:
在 SDK Platforms 分頁欄蔬充,勾選你希望安裝的 API Level蝶俱,也就是支持安卓系統(tǒng)的版本,推薦選擇最低兼容的 API Level 10(2.3.3) 和最主流的 API Level 17 (4.2) 以及 API Level 22 (5.1)饥漫。
在 SDK Tools 分頁欄榨呆,首先勾選右下角的?Show package details,顯示分版本的工具選擇趾浅。
在?Android SDK Build-Tools?里愕提,選擇 25 以上的 build tools 版本。
勾選?Android SDK Platform-Tools,?Android SDK Tools?和?Android Support Library
勾選?NDK皿哨,確保版本在 14 以上(請(qǐng)使用 r10c 以上的版本浅侨,推薦 r10e)。
記住窗口上方所示的 Android SDK Location 指示的目錄证膨,稍后我們需要在 Cocos Creator 里填寫這個(gè) SDK 所在位置如输。
點(diǎn)擊?OK,根據(jù)提示完成安裝央勒。
Android SDK 10 依賴
從 v1.2.2 開始不见,默認(rèn)的 Android 項(xiàng)目模板將指定?android-10?sdk platform 版本作為默認(rèn)的 target,詳情可見?Pull Request Use API Level 10崔步。
如果編譯 Android 工程時(shí)遇到 '未找到 android-10' 之類的報(bào)錯(cuò)稳吮,可以通過上文介紹的方式下載 Android SDK API Level 10。
如果需要更改 target 的 API Level井濒,可以修改原生引擎目錄下?cocos/platform/android/java/project.properties?文件中的
將?android-10?修改為其他您需要的 API Level灶似。
2.安裝 C++ 編譯環(huán)境
Cocos2d-x 自帶的編譯工具 Cocos Console 需要以下運(yùn)行環(huán)境:
Python 2.7.5+列林,下載頁,注意不要下載 Python 3.x 版本酪惭。
Windows 下需要安裝 Visual Studio 2015 或 2017 社區(qū)版希痴,下載頁
Mac 下需要安裝 Xcode 和命令行工具,下載頁
配置原生發(fā)布環(huán)境路徑
下載安裝好開發(fā)環(huán)境依賴后春感,讓我們回到 Cocos Creator 中配置構(gòu)建發(fā)布原生平臺(tái)的環(huán)境路徑砌创。在主菜單中選擇?CocosCreator -> 偏好設(shè)置,打開偏好設(shè)置窗口:
我們?cè)谶@里需要配置以下三個(gè)路徑:
Android SDK Root鲫懒,選擇剛才在 SDK Manager 中記下的?Android SDK Location?路徑(Android SDK 的目錄下應(yīng)該包含 build-tools嫩实、platforms 等文件夾),不需要編譯 Android 平臺(tái)的話這里可以跳過刀疙。
NDK Root舶赔,選擇?Android SDK Location?路徑下的?ndk-bundle?文件夾(NDK 是其根目錄),不需要編譯 Android 平臺(tái)的話這里可以跳過谦秧。
ANT Path竟纳,請(qǐng)選擇下載并解壓完成的 Apache Ant 路徑,需要設(shè)置到 ant 安裝目錄內(nèi)的 bin 目錄下疚鲤,選定的路徑中應(yīng)該包括一個(gè)名叫?ant?的可執(zhí)行文件锥累。不需要編譯 Android 平臺(tái)的話這里可以跳過。
配置完成后點(diǎn)擊?保存?按鈕集歇,保存并關(guān)閉窗口桶略。
注意:這里的配置會(huì)在編譯?原生工程?的時(shí)候生效。如果沒有生效(一些 Mac 機(jī)器有可能出現(xiàn)這個(gè)情況)诲宇,可能需要您嘗試到?系統(tǒng)環(huán)境變量?設(shè)置這些值:COCOS_CONSOLE_ROOT, ANT_ROOT, NDK_ROOT, ANDROID_SDK_ROOT际歼。
3.注意事項(xiàng)
由于在公測(cè)版中收到了很多原生打包的問題反饋,這里補(bǔ)充一些可能的問題原因姑蓝。
檢查 Xcode 和 Visual Studio
打包 Mac 版本和 iOS 版本需要 Xcode 支持鹅心,打包 Windows 版本需要安裝 Visual Studio。在安裝 Visual Studio 時(shí)纺荧,默認(rèn)并沒有勾選 C++ 編譯組件旭愧。如果沒有安裝,則需要重新安裝并選擇 C++ 相關(guān)編譯組件宙暇。
包名問題
檢查構(gòu)建發(fā)布面板中的包名输枯,包含空格,-?等都是非法的包名占贫。
不使用 Android Studio
如果您使用 Cocos Creator v1.5 以前的版本桃熄,或由于某些原因無法使用 Android Studio,請(qǐng)安裝 Eclipse 并使用舊的流程下載 SDK 和 NDK
從以下鏈接下載和操作系統(tǒng)一致的 Android SDK 和 NDK:
下載之后解壓到任意位置型奥,我們之后需要設(shè)置 Android SDK 和 NDK 的路徑蜻拨,請(qǐng)記住以上文件的解壓位置池充。
下載?Apache Ant?是一種用來構(gòu)建軟件的 Java 程序庫(kù)和可執(zhí)行文件桩引。我們?cè)跇?gòu)建 Android 平臺(tái)項(xiàng)目時(shí)需要這個(gè)軟件的支持缎讼。
前往 Apache Ant 的下載鏈接:
選擇穩(wěn)定版的?.zip?壓縮包并下載,下載完成后解壓到任意目錄坑匠,之后我們?cè)谶M(jìn)行設(shè)置時(shí)需要選擇這個(gè)目錄血崭。
Android 6.0 SDK 的支持問題
Android 6.0 SDK 去除了 Cocos2d-x 依賴的 HttpClient 庫(kù),所以會(huì)導(dǎo)致 Cocos Creator v1.5 以前的版本編譯失敗厘灼。舊版本用戶的解決方案是:
找到 Android SDK 目錄下的 HttpClient 庫(kù):platforms/android-23/optional/org.apache.http.legacy.jar夹纫。
如果使用源碼引擎模版,需要拷貝到原生編譯目錄下的?jsb/frameworks/cocos2d-x/cocos/platform/android/java/libs/?目錄下设凹。如果使用預(yù)編譯庫(kù)引擎模版舰讹,需要拷貝到原生編譯目錄下的?jsb/frameworks/runtime-src/proj.android/jars/?目錄下。
重新編譯闪朱。
Android 編譯成功月匣,但運(yùn)行時(shí)提示?dlopen failed: cannot locate symbol "xxxx" referenced by "libcocos2djs.so"...
請(qǐng)檢查 NDK 和 Android SDK 的架構(gòu)和版本是否和測(cè)試用的 Android 系統(tǒng)相對(duì)應(yīng),另外可以嘗試使用本文所用的 NDK 和 Android SDK 版本來測(cè)試奋姿。
最后锄开,如果依然打包失敗,可以嘗試創(chuàng)建一個(gè)標(biāo)準(zhǔn)的 Cocos2d-x 工程称诗,并嘗試編譯萍悴,如果 Cocos2d-x 工程可以編譯,而 Cocos Creator 無法打包寓免,請(qǐng)將 bug 通過?論壇?反饋給我們癣诱。
現(xiàn)在您已經(jīng)完成了全部原生開發(fā)環(huán)境的配置,接下來請(qǐng)繼續(xù)前往?打包發(fā)布原生平臺(tái)?說明文檔袜香。