SuperAPI AI 工具集

hz-store-pwa

通用与其它

查看项目

更新于 10-16 00:29

技能介绍

用途:指导把 Web 应用封装为 Meta VR 应用并发布到 Meta Horizon Store,支持 2D 窗口面板与沉浸式 WebXR/VR 两种交付模式,走同一条流水线。

主要能力:决定应用模式(2D 面板或沉浸式 WebXR);用 IWSDK 构建 WebXR 应用并接入已安装 PWA 的自动进入会话;部署 PWA 到 Vercel 并生成可安装的 manifest 与图标;用 @meta-quest/bubblewrap-cli 将线上 PWA 打包为签名 Meta VR APK;配置签名 keystore 与 Digital Asset Links;用 ovr-platform-util 上传构建;排查 2D 应用卡加载、沉浸式应用出现 URL 栏、TWA 无法启动或上传被阻止等问题。

使用方式:按顺序执行——选模式、构建 Web 应用、部署 Vercel、准备 manifest 与图标、打包 APK、上传商店。命令使用 <…> 占位符(如 <DOMAIN>、<HORIZON_APP_ID>、<team-slug>、<PW>),运行前需替换。沉浸式应用用 npx @iwsdk/create@latest <app-name> --yes --mode vr --no-metaspatial --no-physics --no-locomotion --grabbing 脚手架;打包用 npm i -g @meta-quest/bubblewrap-cli,再 bubblewrap update && bubblewrap build;上传用 ovr-platform-util upload-quest-build,需 --app-id、--apk、--channel、--age-group 及 --app-secret 或 --token。

适用场景:需要把 2D 或 WebXR Web 应用上架 Meta Horizon Store 的开发者。

限制:horizonOSAppMode 取值错误是首要失败原因;签名密钥永久,更新必须复用同一 keystore;bubblewrap init 需要真实 TTY,代理须走脚本化路径;自动进入会话仅限沉浸式且需以 getDigitalGoodsService 为条件,只能在头显验证;Vercel 须用规范别名而非哈希 URL;maskable 图标须满幅不透明;asset links 未就绪 TWA 不会启动;首次上传需组织管理员签署开发者分发协议。更深入的 IWSDK 构建见 hz-iwsdk-webxr,商店提交流程见 hz-store-submit。