3D建模

Cocos Creator3D：设置本机开发环境

ygtu

Jun 15, 2023 • 5 min read

推荐：将NSDT场景编辑器加入你的3D工具链

3D工具集：NSDT简石数字孪生

设置本机开发环境

除了将游戏发布到Web之外，Cocos Creator 3D还使用基于Cocos2d-x引擎的JSB技术进行原生游戏的跨平台发布。在使用 Cocos Creator 3D 将游戏捆绑发布到原生平台之前，您需要先配置相关的 Cocos2d-x 开发环境。

安卓平台依赖关系

要发布到 Android 平台，您需要安装以下所有开发环境。

如果您没有发布到 Android 平台的计划，或者您的操作系统已经具有完整的 Android 开发环境，则可以跳过此部分。

下载 Java SDK （JDK）

编译 Android 项目需要在本地计算机上安装完整的 Java SDK 工具，可在以下地址下载：

Java SE 开发工具包 8 下载

下载并注意选择机器和操作系统及架构，下载安装后即可完成安装过程。

安装完成后，请在命令行上确认该命令有效。在Mac终端或Windows命令行工具中输入以下代码进行检查：java

java -version

如果显示，则没有问题。如果显示，则需要安装 JAVA SE 运行环境）。JAVA SEJRE

在 Windows 平台上，请确认是否包含在您的环境变量中。右键单击计算机上的计算机，选择属性 -> 高级系统设置 -> 环境变量以检查和修改环境变量。为了在 Windows 平台上有效运行，您可能需要重新启动计算机。有关详细信息，请参阅文档：如何设置或更改 PATH 系统变量？。JAVA_HOME

下载并安装安卓工作室

Cocos Creator 3D 不支持 Eclipse 的 ANT 构建，我们需要使用 Android Studio 作为 Android 平台的构建工具，您应该在 Android Studio 中下载所需的 SDK 和 NDK 包。首先安装 Android Studio。

下载发布安卓平台所需的 SDK 和 NDK

安装 Android Studio 后，请参考官方文档，打开 SDK 管理器：SDK 管理器说明。

在 SDK 平台 页签，勾选要安装的 API 级别，建议选择所需的主流 API 级别，如、、等。API Level 23 (6.0)API Level 26 (8.0)API Level 28 (9.0)
在 SDK 工具页签，首先查看右下角的显示包详情，显示工具选择的版本。
在 Android SDK 构建工具中，选择最新的构建工具版本。
查看 Android SDK 平台工具和 Android SDK 工具。如果您需要安装 Android 支持库，请参阅官方 Android 文档。
检查 NDK，推荐版本为 r17 ~ r19。
记下 SDK 管理器窗口顶部的 Android SDK 位置路径。稍后我们需要在 Cocos Creator 3D 中填写 SDK 的位置。
单击确定并按照提示完成安装。

安装C++编译环境

请安装以下运行环境：

Python 2.7.5+，下载页面。注意！不要下载Python 3.x版本。

在Windows中，需要安装Visual Studio 2017 Community Edition。安装 Visual Studio 时，请检查C++桌面开发和C++两个模块的游戏开发。

注意：使用C++游戏开发模块中有一个 Cocos 选项。不要检查它。

在Mac中，需要安装Xcode和命令行工具。

配置本机开发环境路径

接下来，我们回到 Cocos Creator 3D 来配置原生平台的环境路径。在主菜单中选择 CocosCreator 3D -> 首选项，然后打开首选项面板：

我们需要在这里配置以下两条路径：

NDK 根目录，选择我们刚刚在 Android Studio SDK 管理器窗口中记下的路径中的文件夹。如果您不需要在 Android 平台上编译，则可以跳过此操作。ndk-bundleAndroid SDK Location
Android SDK 根目录，选择我们刚刚在 Android Studio SDK Manager 窗口中标注的路径（Android SDK 的目录应包含、、等文件夹）。如果您不需要编译 Android 平台，则可以跳过此操作。Android SDK Locationbuild-toolsplatforms

配置完成后关闭窗口。

注意：构建本机项目时，配置将起作用。如果配置不起作用，请尝试手动将这些设置设置为系统环境：、、。COCOS_CONSOLE_ROOTNDK_ROOTANDROID_SDK_ROOT

笔记

我们收到了很多关于公测版原生打包的反馈，这里补充了一些可能的原因：

包名称问题

在构建面板中查看游戏包名称，包括空格等。都是违法的。-

Android 构建成功，但在运行时提示。dlopen failed: cannot locate symbol "xxxx" referenced by "libcocos2djs.so"...

请检查 NDK 和 Android SDK 的架构和版本是否与手机的 Android 系统相对应。此外，您可以尝试使用本文中使用的 NDK 和 Android SDK 版本进行测试。

最后，如果构建仍然失败，请向论坛发送问题，其中包含 Creator 3D 版本、构建面板中的构建日志文件以及重现问题的演示。

由3D建模学习工作室翻译整理，转载请注明出处!

上一篇：Cocos Creator3D：发布到本机 (mvrlink.com)

下一篇：Cocos Creator3D：在原生平台上调试 JavaScript (mvrlink.com)