发布

发布版的应用程序清单

更新时间: 2026年3月5日
如需上传应用进行审核,以便添加到 Meta Horizon 商店,则必须根据本文所述规范为应用准备一份应用清单 (AndroidManifest.xml)。应用清单若不符合规范,将无法通过虚拟现实检查 (VRC) VRC.Quest.Packaging.1
请注意,编译版本的清单即便不符合这些规范,也仍可能会被上传到开发者面板,或在 Meta Quest 设备上侧载和启动。
本主题包括以下几部分:

发布清单规范

应用 AndroidManifest.xml 文件的通用规范,请见原生开发指南中的 Android 设置
如要在商店发布,应用清单还应满足以下要求:
  • android:minSdkVersionandroid:targetSdkVersionandroid:compileSdkVersion 必须根据下表进行适当设置。
    • 更低的 minSdkVersion 意味着支持用户使用更旧的设备。如果应用使用较新的功能,例如近期的混合现实功能,您可能需要将 minSdkVersion 设置为更高的值。
    • compileSdkVersion 在应用清单中为可选;但是,如果列出,它必须大于或等于 android:targetSdkVersion。使用更高的 compileSdkVersion(高于 targetSdkVersion),确保您收到最新的编译器错误消息。
    • 尽管 Android 支持 maxSdkVersion,但不建议在 Meta Quest 设备上使用。
    设备minSdkVersiontargetSdkVersioncompileSdkVersion(可选)
    Quest 2
    29-34
    32-34(沉浸式),32-36(2D)
    32+
    Quest Pro
    29-34
    32-34(沉浸式),32-36(2D)
    32+
    Quest 3
    29-34
    32-34(沉浸式),32-36(2D)
    32+
  • installLocation 必须设置为 auto(或 0,两者意义相同)。这支持在 SD 卡外部存储空间安装应用。如果您有特殊情况并且需要设置不同的安装位置,请使用获取开发者支持表格,联系商店团队。
  • manifest 节点中必须出现下行内容:
<uses-feature android:name="android.hardware.vr.headtracking" android:required="true" android:version="1" />
  • application 节点,android:label 必须包含应用名称或应用名称的合理表示,并且标签在平台上必须是唯一的。
  • application 节点,android:debuggable 必须设置为 false,或取消设置。应用必须为发布版,而非调试版。
  • 在启动应用的 activity 节点,指定以下 intent-filter 值:
    <intent-filter><action android:name="android.intent.action.MAIN" /><category android:name="android.intent.category.LAUNCHER" /></intent-filter>
    注意:对于 OpenXR 应用,intent-filter 下还需要一个 category 值:
    <category android:name="com.oculus.intent.category.VR" />
  • 在启动应用的 activity 节点,android:excludeFromRecents 必须设置为 true
  • application 节点中必须有一个元数据元素,用于指定支持的 Meta Quest 设备,例如:<meta-data android:name="com.oculus.supportedDevices" android:value="quest2|quest3|quest3s" />。在您使用 Unity 和 Unreal 引擎项目设置来配置目标设备时,该元素会自动添加。更多信息请参阅兼容模式

Unity 应用清单

Unity Android 项目设置允许您设置一些必要的应用清单选项,以便构建适合商店的移动应用。如要设置其余清单设置选项,请使用 Unity 版 Meta XR 核心 SDK 提供的功能,或直接编辑清单。
配置 Unity,为构建 Meta Quest Android .apk 软件包做好准备
  1. 打开 Unity 编辑器。
  2. 前往 Meta > Tools(工具)> Create store-compatible AndroidManifest.xml(创建与商店兼容的 AndroidManifest.xml)
  3. 前往 Edit(编辑)> Project Settings(项目设置)> Player(玩家)
  4. 展开 Other Settings(其他设置)属性,选择 Android 选项卡。
  5. Identification(标识)下的 Package Name(软件包名称)字段中输入软件包名称。软件包名称中应包含公司名称和应用名称,且该名称在上传到 Meta Horizon 商店的应用中必须是唯一的。软件包名称中可以有一个应用代号,但这个代号不得是 Meta Horizon 商店中应用的名称。
  6. 前往 Meta > Tools(工具)> Project Setup Tool(项目设置工具)
  7. 点击所有适用项旁边的“Fix”(修复)或“Apply”(应用)。

Unreal 应用清单

Meta 建议使用 Meta 的 Unreal 引擎分叉进行 Unreal 开发。该分叉版本不仅能修复问题以提升 Unreal 在 Meta Quest 设备上的性能,还包含 Project Setup Tool(项目设置工具)以简化修改应用清单的流程。
配置 Unreal 引擎,为构建 Meta Quest Android .apk 软件包做好准备
  1. 在主菜单中,依次选择 Edit(编辑)和 Project Settings(项目设置)。
  2. Platforms(平台)标头下,选择 Android
  3. Install Location(安装位置)更改为 Auto(自动)。
  4. 确认未勾选 Remove Oculus Signature Files from Distribution APK(将 Oculus 签名文件从分发 APK 中删除)。如果已勾选,请取消勾选。
  5. Project(项目)标头下,选择 Packaging(打包)。
  6. 确认已勾选 For Distribution(用于分发)。
  7. 最后,按照 Unreal 引擎 Signing Projects for Release(签署项目及发行)指南中的步骤为您的 Android 软件包签名。
  8. Meta XR Tools(Meta XR 工具)标头下,选择 Meta XR Project Setup Tool(Meta XR 项目设置工具)。
  9. 点击所有适用项旁边的“Fix”(修复)或“Apply”(应用)。