【大话西游】CocosCreator安装及打包环境教程

编译 Android 工程需要本地电脑上有完整的 Java SDK 工具，请到以下地址下载：
Java SE Development Kit 8 Downloads
下载时注意选择和本机匹配的操作系统和架构，下载完成后运行安装程序即可。
安装后请检查 JAVA 环境，在 Mac 终端或者 Windows 命令行工具中输入下面代码来查看：
java -version
显示为 JAVA SE 则没有问题，如果系统中使用的是 JRE，则需要安装 JAVA SE 运行环境。
如果是 Windows 系统，请确认你的环境变量中包含 JAVA_HOME。可以通过右键点击我的电脑，选择属性，打开高级选项卡中来查看和修改环境变量。修改完成后 Windows 平台可能需要重启电脑才会生效。参考 如何设置或更改 JAVA 系统环境变量

Cocos Creator 不支持 Eclipse 的 ANT 构建，需要使用 Android Studio 4.1 及以上版本 作为安卓平台的构建工具，并在 Android Studio 中下载所需的 SDK 和 NDK 包。首先请 安装 Android Studio。

安装 Android Studio 完成后，参考官方文档，打开 SDK Manager：SDK Manager 使用说明。

1.在 SDK Platforms 分页栏，勾选你希望安装的 API Level，也就是支持安卓系统的版本，推荐选择主流 API Level 26（8.0）、API Level 28（9.0）等。
2.在 SDK Tools 分页栏，首先勾选右下角的 Show Package Details，显示分版本的工具选择。
3.在 Android SDK Build-Tools 里，选择最新的 build tools 版本。
4.勾选 Android SDK Platform-Tools 和 CMake，如需安装 Android 支持库，请参考 官方文档 — 支持库设置。
5.勾选 NDK，推荐使用版本为 r18~21。
6.记住窗口上方所示的 Android SDK Location 指示的目录，稍后我们需要在 Cocos Creator 编辑器中填写这个 SDK 所在位置。
7.点击 OK，根据提示完成安装。

请安装以下运行环境：
Windows 下需要安装 Visual Studio 2017/2019 社区版。在安装 Visual Studio 时，请勾选 使用 C++ 的桌面开发 和 使用 C++ 的游戏开发 两个模块。
注意：在 使用 C++ 的游戏开发 模块中有一个 Cocos 选项，请勿勾选。
Mac 下需要安装 Xcode 和命令行工具，下载页。
注意：
1.从 v3.0.1 开始，要求使用的 Xcode 版本为 11.5 及以上。
2.从 v3.1 开始，要求使用的 macOS 版本为 10.14 及以上。

下载安装好开发环境依赖后，回到 Cocos Creator 中配置构建发布原生平台的环境路径。在主菜单中选择 Cocos Creator -> 偏好设置，打开 偏好设置 面板，我们需要在 外部程序 栏中配置以下两个路径：

Android NDK：选择刚才在 Android Studio 中的 Android SDK Location 路径下的 ndk-bundle 文件夹（NDK 是其根目录），不需要编译 Android 平台的话这里可以跳过。
注意：新版本 Android Studio 的 NDK 可下载多版本，之前的 ndk-bundle 文件名更改为 ndk，可在 ndk 目录下根据需要选择具体版本的 NDK。

Android SDK：选择刚才在 Android Studio 的 SDK Manager 中记下的 Android SDK Location 路径（Android SDK 的目录下应该包含 build-tools、platforms 等文件夹），不需要编译 Android 平台的话这里可以跳过。

配置完成后会自动保存。
注意：这里的配置会在编译 原生工程 的时候生效。如果没有生效（一些 Mac 机器有可能出现这个情况），可能需要您尝试到 系统环境变量 设置这些值：NDK_ROOT、ANDROID_SDK_ROOT。

在之前的版本中收到了很多原生打包的问题反馈，这里补充一些可能的问题原因。

1.包名问题
检查 构建发布 面板中的包名，具体命名规范请参考相应原生平台中的 构建选项说明。

2.Android 编译成功，但运行时提示 dlopen failed: cannot locate symbol "xxxx" referenced by "libcocos2djs.so"...
请检查 NDK 和 Android SDK 的架构和版本是否和测试用的 Android 系统相对应，另外可以尝试使用本文所用的 NDK 和 Android SDK 版本来测试。