Apache Cordova
Apache Cordova 是一个开源的移动开发框架,它允许使用标准的 Web 技术(如 HTML5、CSS3 和 JavaScript)进行跨平台应用开发。应用通过针对各平台的包装器运行,并依赖符合标准的 API 绑定来访问设备功能,如传感器、数据和网络状态。
使用 Cordova,您可以将 PlayCanvas 应用包装为原生应用,并发布到 iOS App Store 或 Android 的 Google Play。Cordova 还能生成与 macOS 和 Windows 兼容的可执行文件。
Cordova 的安装
要开始使用,请按照 Cordova 官方文档中的安装步骤,在计算机上安装 Cordova CLI。
项目创建
创建项目时,输入以下命令:
cordova create hello com.example.hello HelloWorld
其中,hello 是项目文件夹,com.example.hello 是应用的反向域名标识符,HelloWorld 是应用的可读标题(例如,用于生成应用图标)。对于类似“Master Archer”的游戏,相应命令为:
cordova create masterarcher com.playcanvas.masterarcher "Master Archer"
项目创建后,根目录会有一个 config.xml 文件,用于设置或编辑应用特性,例如全局或按平台配置自定义应用图标。
添加 PlayCanvas 应用
新的 Cordova 项目会在 www 文件夹中生成一个骨架 Web 应用。请删除 www 文件夹中的所有内容,然后将 PlayCanvas 应用的文件复制到该位置。
如果使用引擎编辑器构建应用,请确保将应用文件复制到 www 文件夹,且 index.html 文件位于根目录。
注意:音频资源文件需要以 Base64 格式编码,以确保正确加载和播放。这是因为 iOS 对通过 WebView 本地加载的文件有限制。建议使用 Base64 Guru 等工具进行转换。
如果您通过 PlayCanvas 编辑器构建应用,可以使用官方外部工具来优化项目以兼容 Cordova。该工具能自动化任务,如将音频文件转换为 Base64 格式。您可以在 GitHub 上找到该工具,并按照设置说明运行 Cordova 发布脚本,从而生成一个准备好用于 Cordova 的项目 ZIP 包。将其内容解压到 www 文件夹的根目录即可。
构建可执行文件
现在,您可以构建 Cordova 支持的平台应用。
为 iOS 构建
iOS 构建仅限于基于 macOS 的计算机,且需要安装 Xcode。请从 Mac App Store 安装 Xcode。
要为 iOS 构建应用,首先将 Cordova iOS 平台添加到项目中。在项目根目录输入以下命令,并确保版本至少为 6.0.0,因为该版本将包装器从 UIWebView 升级到 WKWebView,提升了性能。更多细节请参考 Cordova 博客公告。
在运行基于 Cordova 的 PlayCanvas 应用时,可能会遇到跨源 HTTP 请求错误。要修复此问题,请在项目的 config.xml 中添加以下内容:
<platform name="ios">
<preference name="scheme" value="app" />
<preference name="hostname" value="localhost" />
</platform>
iOS 测试
测试应用时,可以使用模拟器或物理 iOS 设备。模拟器作为 Xcode 工具的一部分安装,能模拟各种 iOS 设备。要在模拟器中运行应用,输入相应命令,构建过程中会生成可执行文件并启动模拟器加载应用。
若要在物理设备上运行,请通过 USB 将 iOS 设备连接到 Mac,在 Xcode 中打开 platforms/ios/<项目名称>.xcworkspace,进入项目目标的签名与功能设置,选择有效团队以部署数字签名应用。接着,在 Xcode 的方案下拉列表中选择 iOS 设备,最后点击运行按钮来构建、部署和执行应用。
当应用满意后,您可以将其提交到 App Store Connect。