兼容性
当前公开兼容系列是 Manifest V1。
| 对象 | 公开契约 | 运行环境 |
|---|---|---|
@vifu/sdk | 用于 Vifu 服务、资源和游戏自有动作的浏览器 SDK | Vifu Web iframe、iOS WKWebView |
@vifu/cli | setup、build、deploy 和成果物验证 | Node.js CLI |
@vifu/create-vifu | 创建入门项目 | Node.js CLI |
版本策略
补丁 / alpha 发布可以添加 SDK 辅助函数、诊断、清单字段和部署验证规则,但不应该在没有提示的情况下破坏有效的 Manifest V1 项目。
破坏性变更需要新的兼容系列。在那之前,请使用:
manifestVersion: 1- 浏览器入口文件使用
main.url @vifu/sdk- 使用 Vifu SDK API,而不是 host bridge messages
宿主要求
- Vifu Web 使用
window.postMessage。 - iOS WKWebView 运行环境使用
window.webkit.messageHandlers.vifuHost。 - 包含 HTML 入口文件的静态浏览器输出。
- 上下文、动作输入 / 结果、观测事件和信号载荷都需要能序列化为 JSON。
- 平台能力通过
@vifu/sdk访问,不直接调用后端。