cocos-creator的安裝配置原生開發環境

安裝配置原生開發環境  （摘自：http://www.cocos.com/docs/creator/publish/setup-native-development.html）

除了內置的 Web 版游戲發布功能外，Cocos Creator 使用基於 cocos2d-x 引擎的 JSB 技術實現跨平台發布原生應用和 Cocos Play 手機頁游。在使用 Cocos Creator 打包發布到原生平台之前，我們需要先配置好 cocos2d-x 相關的開發環境。

Android 平台相關依賴

要發布到 Android 平台，需要安裝以下全部開發環境依賴。

如果您沒有發布到 Android 平台的計划，或您的操作系統上已經有完整的 Android 開發環境，可以跳過這個部分。

Android SDK 10 依賴

從 v1.2.2 開始，默認的 Android 項目模板將指定 android-10 sdk platform 版本作為默認的 target，詳情可見Pull Request Use API Level 10。

如果編譯 Android 工程時遇到 '未找到 android-10' 之類的報錯，可以下載單獨的 Android SDK platform 包android-10.zip，並解壓到您的 Android SDK 根目錄下的 platforms 目錄里，和其他 android-xx 目錄並列。

如果需要更改 target 的 API Level，可以修改原生引擎目錄下cocos/platform/android/java/project.properties 文件中的

    target=android-10

將 android-10 修改為其他您需要的 API Level。

下載發布 Android 平台所需的 SDK 和 NDK

從以下鏈接下載和操作系統一致的 Android SDK 和 NDK：

• Android SDK Windows
• Android SDK Mac
• Android NDK Windows 32位
• Android NDK Windows 64位
• Android NDK Mac

下載之后解壓到任意位置，我們之后需要設置 Android SDK 和 NDK 的路徑，請記住以上文件的解壓位置。

下載 ANT

Apache Ant 是一種用來構建軟件的 Java 程序庫和可執行文件。我們在構建 Android 平台項目時需要這個軟件的支持。

之前前往 Apache Ant 的下載鏈接：

Apache Ant 下載

選擇穩定版的 .zip 壓縮包並下載，下載完成后解壓到任意目錄，之后我們在進行設置時需要選擇這個目錄。

下載 Java SDK （JDK）

編譯 Android 工程需要本地電腦上有完整的 Java SDK 工具，請到以下地址下載：

Java SE Development Kit 8 Downloads

下載時注意選擇和本機匹配的操作系統和架構，下載完成后運行安裝程序即可。

注意：安裝完成后請在命令行中確認 java 命令是有效的，否則請參考下文手動添加 java 可執行文件所在目錄到您的環境變量中。

安裝 C++ 編譯環境

Cocos2d-x 自帶的編譯工具 Cocos Console 需要以下運行環境：

• Python 2.7.5+，下載頁，注意不要下載 Python 3.x 版本。
• Windows 下需要安裝 Visual Studio 2013 或 2015 社區版，下載頁
• Mac 下需要安裝 Xcode 和命令行工具，下載頁

配置原生發布環境路徑

下載安裝好開發環境依賴后，讓我們回到 Cocos Creator 中配置構建發布原生平台的環境路徑。在主菜單中選擇文件/偏好設置，打開偏好設置窗口：

我們在這里需要配置以下三個路徑：

• NDK，選擇剛才下載並解壓后的 NDK 路徑，不需要編譯 Android 平台的話這里可以跳過
• Android SDK，選擇剛才下載並解壓后的 Android SDK 路徑，不需要編譯 Android 平台的話這里可以跳過
• ANT，請選擇前面下載並解壓完成的 Apache Ant 路徑，選定的路徑中應該包括一個名叫 ant 的可執行文件。

配置完成后點擊 保存 按鈕，保存並關閉窗口。

注意：這里的配置會在編譯 原生工程 的時候生效。如果沒有生效（一些 Mac 機器有可能出現這個情況），可能需要您嘗試到 系統環境變量 設置這些值：COCOS_CONSOLE_ROOT, ANT_ROOT, NDK_ROOT, ANDROID_SDK_ROOT。

注意事項

由於在公測版中收到了很多原生打包的問題反饋，這里補充一些可能的問題原因。

1. 檢查路徑

   在偏好設置中設置好的路徑必須確保是正確的，比如：ant 路徑需要設置到 ant 安裝目錄內的 bin 目錄下，NDK 是其根目錄，而 Android SDK 的目錄下應該包含 build-tools、platforms 等文件夾。

2. 檢查 Xcode 和 Visual Studio

   打包 Mac 版本和 iOS 版本需要 Xcode 支持。打包 Windows 版本需要安裝 Visual Studio，同時在安裝 Visual Studio 時，默認並沒有勾選 C++ 編譯組件。如果沒有安裝，則需要重新安裝並選擇 C++ 相關編譯組件。

3. 檢查 NDK 版本

   不論使用什么版本的引擎，都需要使用 NDK r9b 以上版本。如果使用了 Cocos2d-x framework, 請使用 NDK r10 以上的版本，推薦 r10e。

4. Windows 平台需要檢查 JAVA_HOME 環境變量

   如果使用 Windows 平台，請確認你的環境變量中包含 JAVA_HOME，可以通過右鍵點擊我的電腦，選擇屬性，打開高級選項卡中來查看和修改環境變量。Windows 平台可能需要重啟電腦才會生效。

   參考如何設置或更改 JAVA 系統環境變量？

5. 檢查 JAVA 環境

   在 Mac 終端或者 Windows 命令行工具中輸入下面代碼來查看：

    java -version

   如果顯示為 JAVA SE 則沒有問題，如果系統中使用的是 JRE，則需要安裝 JAVA SE 運行環境。

6. 包名問題

   檢查構建發布面板中的包名，包含空格，-等都是非法的包名。

7. Android 6.0 SDK 的支持問題

   Android 6.0 SDK 去除了 Cocos2d-x 依賴的 HttpClient 庫，所以會導致編譯失敗。目前的解決方案是：

   • 找到 Android SDK 目錄下的 HttpClient 庫：platforms/android-23/optional/org.apache.http.legacy.jar。
   • 如果使用源碼引擎模版，需要拷貝到原生編譯目錄下的 jsb/frameworks/cocos2d-x/cocos/platform/android/java/libs/ 目錄下。如果使用預編譯庫引擎模版，需要拷貝到原生編譯目錄下的 jsb/frameworks/runtime-src/proj.android/jars/ 目錄下。
   • 重新編譯。

8. Android 編譯成功，但運行時提示 dlopen failed: cannot locate symbol "xxxx" referenced by "libcocos2djs.so"...

   請檢查 NDK 和 Android SDK 的架構和版本是否和測試用的 Android 系統相對應，另外可以嘗試使用本文章下載的 NDK 和 Android SDK 來測試。

最后，如果依然打包失敗，可以嘗試創建一個標准的 Cocos2d-x 工程，並嘗試編譯，如果 Cocos2d-x 工程可以編譯，而 Cocos Creator 無法打包，請將 bug 通過論壇反饋給我們。

---

現在您已經完成了全部原生開發環境的配置，接下來請繼續前往 打包發布原生平台 說明文檔。