@cocos/engine-platforms

Cocos 引擎的运行时平台适配层(platform adapters) 独立分发包。为各平台提供引擎与宿主环境之间的适配(全局对象、Canvas、音频、文件、网络、输入等),发布内容为预打包产物 bin/adapter/**。

本包是 Cocos 引擎的内部依赖,在引擎安装期被铺放到引擎目录供构建消费,通常无需单独安装。

支持平台

• Native:iOS / Android / Windows / macOS / HarmonyOS 等原生平台
• 小游戏(Minigame):微信、支付宝、抖音、淘宝、小米
• 快游戏(Runtime):荣耀、华为、咪咕、OPPO、vivo
• Node.js

开发与测试

完整的实现说明、本地开发、测试、CI 与发布流程参见 开发、测试与发布指南。

npm ci
npm run test:unit     # 快速运行单元测试
npm test              # 单元测试、构建及产物完整性检查
npm run test:coverage # 带覆盖率报告的单元测试

每次 push 和 pull request 都会通过 GitHub Actions 在统一的 Node.js 18.17.0 环境中运行单元测试，随后构建并检查 npm 包内容。

发布

发布前需更新 package.json 版本，并在 GitHub Releases 中选择与版本一致的标签（例如版本 1.1.0 可使用 1.1.0 或 v1.1.0）。点击 Publish release 后，Release 工作流才会运行测试、混淆构建和产物检查，并发布到 npm。仅推送标签或保存 Draft Release 都不会发布。仓库需配置与 cocos-pal、cocos-ccbuild 相同的 NPM_PUBLISH Secret。

许可

UNLICENSED — Cocos 内部使用。