quest-store

发布到 Meta Horizon Store

有两个事实决定了大部分时间安排。**每次上传——包括 Alpha 版本——都必须满足完整的发布打包要求。**而且，只有 Production 渠道会触发审核；构建上传到该渠道后不会自动进行任何操作，必须先填写提交信息并点击“Submit for Review”。

规划发布或审核产品就绪情况时，请阅读 references/production-readiness.md：其中涵盖制品身份、清单冲突、账户、购买、存档、社交功能、隐私、审核证据和发布后的恢复。

如需制定完整产品路线图或进行阶段审核，请使用 quest-lifecycle；单项技术任务仍由当前负责人处理。如果没有相关信息，请在文中说明当前阶段、对应证据和下一项前置要求。

请阅读 references/launch-and-growth.md，了解商业化设置、发布前决策、变现测试、营销和发布后运营。在采集素材、制作商店列表或审核生成的素材前，请阅读 references/store-asset-production.md。

四个渠道

渠道	受众	审核
ALPHA	仅限受邀用户，初始为空——连你自己也不例外	无
BETA	仅限受邀用户	无
RC	仅限受邀用户	无
Production（Store）	所有有权使用的用户	技术审核 + 内容审核

• 可通过电子邮件、别名或 URL 邀请用户，也可以将渠道设为公开，让用户自行订阅。每个渠道默认限额为 200 位用户，可申请提高至 2,500 位。
• 测试人员可在 Library 和 My Preview Apps 下看到构建。
• 将已批准的构建复制到 Production 后，所有有权使用的用户都会获得更新。
• 向韩国的测试人员分发内容时，另有 GRAC 评级要求。

这带来的实际好处是：首个可玩版本无需经过 任何 Meta 审核，即可交给真正的测试人员——前提是它按发布构建的标准完成打包。

审核流程，按实际顺序排列

1. 技术审核——Virtual Reality Checks（VRC）。若未通过，会收到审核结果；不要以为其中列出了所有尚存问题。
2. 内容审核——技术审核通过后，检查内容是否完整、精良且有价值。
3. 批准——之后即可设置发布日期，可立即发布，也可安排在未来发布。

请在目标发布日期之前至少预留 两周。在竞争激烈的类别中，审核可能只指出发现的第一个违规项，因此自行检查比反复提交更省力。使用平台功能的应用必须在提交前完成 Data Use Checkup；如果没有当前有效的 DUC，平台功能将仅限测试用户使用。

检查项，按后期修复成本分组

分组	导致构建失败的项目
打包	清单符合发布规范（.1）、使用v2 签名（.2）、不包含不受支持的 Android 功能（.3）、使用受支持的 SDK/引擎（.4）、APK < 1 GB 且 OBB < 4 GB（.5）、仅限 64 位（.6）
性能	以声明的刷新率运行（.1）、在 4 s 内显示头部跟踪画面或 VR 加载指示器（.3）、建议渲染缩放 ≥ 85%（.4）
功能	不崩溃或冻结；按操作系统要求暂停；绝不使用户陷入无法继续的状态；不丢失数据；支持位置跟踪；可供多位有权使用的用户使用；从 MR Home 启动时显示透视加载画面
输入	感知焦点状态——继续渲染、隐藏手部、忽略输入（.4）；手部追踪应用必须遵守系统预留手势
安全	权限应尽可能少，且不得使用不受支持的权限（.2）；在 10 s 内进行权限检查属于建议，而非要求（.1）
素材	Logo 背景透明；封面图顶部和底部 20% 区域不得包含文字；截图应能代表实际内容，且不得出现其他平台的硬件；预告片**≤ 2 分钟**；文字 ≥ 24 pt

适用于沉浸式应用和 2D 应用的完整表格，请参阅 references/vrc-checklist.md。提交前请获取最新清单——要求会退役，也会新增（VRC.Quest.Performance.2 目前已退役）。

发布清单不等于开发清单

开发要求和提交要求是两份文档，只有后者会在审核时强制执行。上传前请确认：

• android:debuggable 为 false 或未设置——必须是发布构建，而非调试构建。
• installLocation="auto"，且 android:label 唯一。
• 沉浸式应用：android.hardware.vr.headtracking 的 required="true"；2D 面板应用应省略此项或将 required 设为 "false"。
• OpenXR 应用：当前 Meta 发布页面列出了与 MAIN/LAUNCHER 一同使用的 com.oculus.intent.category.VR；检查合并后的 APK，并有意保留 SDK/运行时要求的其他类别。
• 发布启动 Activity：android:excludeFromRecents="true"。
• SDK 级别：2026 年 3 月 1 日之后创建的应用必须以 34 为 target；对于生命周期内的设备，建议 min 32 / target 34 / compile ≥ target。
• 使用 APK 签名方案 v2 签名；不要将密钥库放入仓库。

quest-native 从构建端也遵循相同要求。

上传

metavr store dist apps                       # app ids in the organization
metavr store dist channels --app-id <ID>     # channels and their latest builds
metavr store dist upload --app-id <ID> --channel ALPHA --apk build.apk \
  --notes "what changed"                     # a DRAFT upload unless --publish
metavr store dist copy-build ...             # promote between channels
metavr store test-user ...                   # FRL test accounts for the org

此标志中的 LIVE 是商店渠道。Oculus Platform Command Line Utility（metavr tools install platform-utils）也能完成相同工作，并支持对大型程序包进行差分修补；MQDH 则是它的图形界面封装。上传后才会进行上传验证并报告打包问题，因此请预留一轮修正时间。

每次构建都必须递增 versionCode，否则上传会被拒绝；测试人员看到的版本是 versionName。

适用于两道关卡的检查清单

首次上传 ALPHA 前：发布清单、v2 签名、64 位、大小限制、递增 versionCode，并确认应用能在真实头显上冷启动。

提交 Production 前：完成上述所有事项，此外还需通过 VRC 自检、在使用平台功能时提交 DUC、商店素材符合规格、在头显中截取屏幕截图、预告片时长少于两分钟、完成年龄评级问卷，并确保隐私政策 URL 已上线。

可能导致多一轮提交的问题

• “这只是 Alpha 版”并不能豁免打包要求。
• 渠道初始时没有任何用户，包括开发者自己——空渠道看起来就像上传出了问题。
• Production 构建在提交前不可见；仅上传不会启动审核。
• 2D 面板应用适用另一套规则：只需满足部分 VRC 要求，但某些权限（精确定位、电话功能，……）会触发自动拒绝。
• **商店素材有自己的检查项。**请核实当前安全区域并使用有代表性的截图；不要根据 APK 上传成功就推断素材会被接受。

渠道行为、审核阶段、VRC 分组和 SDK 级别规则取自 developers.meta.com（resources/publish-release-channels、publish-app-review、publish-quest-req、publish-mobile-manifest），访问日期为 2026-09-20。提交前请再次核实：这些页面各自标有日期。

触发词

还有一些会指向此处的短语：“发布渠道” / “релизный канал”、“应用审核” / “ревью приложения”、“Data Use Checkup”、“DUC”、“商店素材” / “ассеты для стора”、“测试用户” / “тестовый аккаунт”、“预购” / “предзаказ”。