Cocos Creator3D:发布到本机

Cocos Creator3D:发布到本机
推荐:将NSDT场景编辑器加入你的3D工具链
3D工具集:NSDT简石数字孪生

发布到本机

Cocos Creator 3D 从 v1.0.3 开始正式支持原生平台,点击主菜单中的项目 -> 构建,打开构建面板。

有四个原生平台,包括AndroidiOSMacWindows。在iOS,Mac和Windows上发布游戏的选项只会出现在这些操作系统上。这意味着无法从 Windows 计算机将游戏发布到 iOS。目前所有原生平台都打包在一起,可以在 Build 面板配置每个原生平台的参数,一次构建即可生成所有原生平台发布包。

环境配置

有关详细信息,请参阅安装程序本机开发环境文档。

构建选项

有关平台的一些常规构建选项,请参阅常规构建选项文档了解详细信息。

原生平台

以下是各个平台的特定生成选项以及常规生成选项的注意事项。

MD5 缓存

MD5 缓存作为通用选项,主要用于构建后为所有资产文件名添加 MD5 信息,解决热更新CDN 资产缓存问题

启用后,如果任何资产加载失败,那是因为在重命名新文件后找不到它。这通常是因为 C++ 中使用的某些第三方资产不是由 加载的。此时,您可以使用以下方法在加载前转换 URL,以解决加载问题:loader

auto cx = ScriptingCore::getInstance()->getGlobalContext();
JS::RootedValue returnParam(cx);
ScriptingCore::getInstance()->evalString("loader.md5Pipe.transformURL('url')", &returnParam);

string url;
jsval_to_string(cx, returnParam, &url);

本机构建选项

由于对构建机制进行了调整,不同平台的处理以插件的形式提供。当您在构建面板的“平台”区域选择原生”时,会看到除了特定平台的构建选项外,还有一个原生选项,原生相关选项的配置会影响所有原生平台。

模板

模板的下拉菜单中有两种可用的引擎模板,我们可以从中选择一种:

  • 默认 - 使用 Cocos2d-x 源代码版本引擎构建项目。
  • 链接 - 与默认模板不同,链接模板不会将 Cocos2d-x 源代码复制到目录中。相反,使用共享的 Cocos2d-x 源代码。这可以有效地减少目录的占用空间,并且还可以共享对 Cocos2d-x 源代码的修改。buildbuild

让我们回顾一下源代码引擎的概念:

Cocos2d-x 引擎包括源代码引擎。记得:
  • 源代码引擎第一次构建编译项目时,编译C++代码需要很长时间,具体取决于计算机的配置,可能需要5~20分钟。同一项目编译一次后,下一次重新编译所需的时间大大缩短。
  • 由源代码引擎构建的项目,使用原生开发环境(如 Android Studio、Xcode 等)编译运行。IDE),也可以进行调试和错误捕获。

下的 Cocos Creator 3D 安装目录已经包含 Cocos2d-x 源代码引擎。resources/3d/cocos2d-x-lite

多填充物

Polyfills 是脚本系统支持的新功能选项。如果在生成时选中此选项,则生成的发布包中将包含相应的 polyfill,并且还会增加包的大小。开发人员可以按需选择填充物,但目前仅可用,稍后将打开更多。Async Functions

安卓构建选项

包名称(捆绑标识符)

通常按产品网站 URL 降序排列,例如 .com.mycompany.myproduct

注意包名称中只能包含数字、字母和下划线。此外,包名称的最后一部分必须以字母开头,而不是以下划线或数字开头。

目标 API 级别

设置编译 Android 平台所需的目标 API 级别。点击旁边的按钮,快速跳转到安卓SDK配置页面。有关详细信息,请参阅安装程序本机开发环境文档。Set Android SDK

应用阿比

设置 Android 需要支持的 CPU 类型,包括 armeabi-v7a、arm64-v8ax86。您可以选择一个或多个选项。

注意:当您选择要构建的 ABI 然后构建另一个 ABI 时,两个 ABI 都将打包到 APK 中,这是 Android Studio 的默认行为。如果使用 Android Studio 导入项目,选择要构建的 ABI 后,运行 Build -> Clean Project,然后构建另一个 ABI,只有后一个 ABI 会被打包到 APK 中。Cleanso

注意:使用 Android Studio 导入项目后,它是独立的存在,不依赖于构建面板。如果需要修改 ABI,可以直接修改 ABI 中的属性,如下所示:PROP_APP_ABIgradle.properties
修改 ABI

密钥库

Android 要求所有 APK 在安装之前都使用证书进行数字签名。提供了缺省密钥库,请选中使用调试密钥库以使用 .如果需要定制密钥库,可以除去使用调试密钥库复选框。有关详细信息,请参阅官方安卓文档。default keystore

取向

设备的方向包括三种类型纵向横向左侧横向右侧

生成应用捆绑包 (Google Play)

选中此选项可将游戏打包为应用捆绑包格式,以便上传到 Google Play 商店。有关详细信息,请参阅官方安卓文档。

Mac 构建选项

捆绑标识符

请参考安卓包名称选项。

iOS 构建选项

捆绑标识符

请参考安卓包名称选项。

取向

请参考安卓的方向选项。

选择平台后,在构建面板中设置初始场景和平台配置选项,然后点击右下角的构建按钮,即可开始构建过程。

构建完成后,我们得到的是一个标准的 Cocos2d-x 项目,其结构与使用 Cocos 控制台构建的新项目相同。然后单击“生成路径”旁边的“打开”按钮可在操作系统的文件管理器中打开生成发布路径,其中所有本机平台的发布包都包含在此路径的目录中。native -> frameworks -> runtime-src

原生项目

编译

目前,编辑器尚未集成编译功能。您需要在相应平台(例如 XcodeAndroid Studio、Visual Studio)的 IDE 中手动打开构建的原生项目,以便进一步预览、调试和发布。

以下是每个本机平台的手动编译:

  • iOS:使用 Xcode 打开目录中的文件,在 Xcode 面板中设置签名,然后在 Xcode 左上角选择连接的设备后点击编译按钮进行编译运行。 native\frameworks\runtime-src\proj.ios_mac\.xcodeprojbuildGeneral -> Signing
  • Android:使用 Android Studio 打开项目,下载缺少的工具(如果出现提示),然后编译并运行它。
  • Mac:使用 Xcode 打开目录中的文件夹进行编译和运行。native\frameworks\runtime-src\proj.ios_macbuild
  • Windows:使用 Visual Studio建议使用 Visual Studio 2017)打开目录中的文件,或者双击它即可编译并运行项目。安装 Visual Studio 时,请注意,您需要选中该框才能安装 Windows 8.1 版本的 SDK。native\frameworks\runtime-src\proj.win32\.slnbuild
注意:在 MIUI 10 系统上运行调试模式下构建的项目时,可能会弹出提示,这是 MIUI 10 系统本身引入的问题,只需使用发布模式即可构建即可。Detected problems with API compatibility

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

上一篇:Cocos Creator3D:发布到 Web 平台 (mvrlink.com)

下一篇:Cocos Creator3D:设置本机开发环境 (mvrlink.com)

NSDT场景编辑器 | NSDT 数字孪生 | GLTF在线编辑器 | 3D模型在线转换 | UnrealSynth虚幻合成数据生成器 | 3D模型自动纹理化工具
2023 power by nsdt©鄂ICP备2023000829号