SuperAPI AI 工具集

iwsdk-dev-workflow

编程与开发

查看项目

更新于 11-17 00:29

技能介绍

用途

iwsdk-dev-workflow 是 iwsdk-webxr-skills 中的“先从这里开始”路由技能,用于指导开发者用 Meta 的 Immersive Web SDK(IWSDK)和 Claude Code 制作 WebXR 游戏或应用,并在 Meta Quest 上测试、准备 Meta VR 商店发布。该技能本身只负责路由,详细步骤存放在它指向的其他技能中;需要先加载被指名的技能再执行对应步骤。

主要能力

按阶段组织开发路径:

  1. 计划:涉及 game-gdd-author、prototype-fast、hz-immersive-designer、xr-ux-design-and-performance-budgeting、horizon-launch-roadmap 等技能,目标是验证核心循环并确定 VR/MR/浏览器、沉浸式/2D、托管 Web/商店 PWA、是否必须手柄等选择。
  2. 搭建:iwsdk-project-setup、quest-browser-webxr、iwsdk-vr-glasses,目标是 npm run dev 可用、Claude Code 能识别 iwsdk-runtime、模拟器中可进入 XR。
  3. 构建:iwsdk-dev 及 iwsdk-build-model、iwsdk-compose-scene、iwsdk-ui、iwsdk-physics、iwsdk-depth-occlusion 等,资产相关有 iwsdk-asset-pipeline 和 Blender 场景技能。
  4. 模拟器测试:iwsdk-grab、iwsdk-ray、iwsdk-debug、iwsdk-testing。
  5. Quest 设备测试:iwsdk-quest-device-testing、iwsdk-native-xr-test、hz-vr-debug、metavr-cli、game-playtest。
  6. 优化:iwsdk-performance、quest-browser-webxr、hz-perfetto-debug、threejs-perf-loading,并用 iwsdk-project-code-reviewer 审查。
  7. 托管与打包:iwsdk-hosting、horizon-web-store-publish。
  8. 商店就绪:horizon-web-vrc-checklist。
  9. 商店素材:horizon-store-listing-assets、review-game-trailer。
  10. 上传提交:horizon-web-store-publish 与开发者 Dashboard。

另提供快速路由表,按“用户想做什么”映射到对应技能,例如新增功能用 iwsdk-dev、导入压缩 GLB/FBX 用 iwsdk-asset-pipeline、空间 UI 用 iwsdk-ui 等。

使用方式

开始前检查环境:

  • node --version(要求 >=20.19 <21、>=22.12 <23 或 >=24)
  • 在 IWSDK 应用内运行 npx @iwsdk/cli dev status
  • adb devices(确认头显已连接并授权)

无项目、Node 版本不对或 MCP 工具缺失时,转向 iwsdk-project-setup;IWSDK 0.4.x 项目(GLXF、Meta Spatial Editor、vite-plugin-uikitml)需先经 iwsdk-migrate-0-5 迁移。对应用代码、场景、模型或 UI 的任何改动,先调用 iwsdk-dev。

适用场景

适用于从零启动 WebXR/IWSDK 项目、迁移旧版本项目、添加或修改功能、处理资产与场景、测试交互、在 Quest 真机调试、性能优化、托管打包、商店合规检查与上架素材准备的开发者。对于适配 Meta VR Glasses 的目标设备(技能资料称 2027 年春季,v207 SDK 已发布),需在规划阶段加载 iwsdk-vr-glasses,因为输入方案会改变设计。

限制与注意事项

  • 该技能只做路由,不包含具体实现步骤。
  • 被指名技能未安装时应说明,并指向库 README,不得凭记忆编造其内容。
  • 由脚手架创建的项目已含 IWSDK 的 12 个官方技能于 .claude/skills/,不要重复安装。
  • 在部署到公开主机、商店上传或渠道提升、使用 --force 脚手架、安装工具、写入代理配置、启用浏览器自动化或创建签名密钥前,必须先征得用户同意。商店提交由用户在开发者 Dashboard 完成。
  • 密钥库、密码、应用密钥和部署令牌不得放入 public/、dist/、git 或聊天输出;每次发布后检查 https://<domain>/android.keystore 返回 404,并提醒用户备份密钥库。
  • 以运行时和真机证据为准,编译通过或平面截图不算证明。
  • 所有 @iwsdk/* 包应保持同一版本;资料记录 npm latest 为 1.0.1,next 为 1.1.0-rc.1(截至 2026-10-17)。
  • 当托管文档与已安装包冲突时,以安装包为准;IWSDK 托管页面描述的是 0.5.3,部分配置键在 1.0.1 中被拒绝。
  • 内置能力优先:抓取、射线/指针交互、UIKitML 面板、移动、物理和音频已由 IWSDK 提供,pmndrs 相关包仅作底层参考。
  • npm install 会运行 @meta-quest/metavr 的 postinstall,并在通过 metavr 启用 IWSDK 工具调用遥测。
  • 排行榜、存档、多人后端等平台服务 IWSDK 未内置,需要自建后端。