跳到正文

兼容性

当前公开兼容系列是 Manifest V1。

对象公开契约运行环境
@vifu/sdk用于 Vifu 服务、资源和游戏自有动作的浏览器 SDKVifu Web iframe、iOS WKWebView
@vifu/clisetup、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 访问,不直接调用后端。