如何在 Meta Quest 2、Quest 3 和 Quest 3S 上旁加载 XAPK 捆绑包和 OBB 资源
Meta Quest 独立 VR 耳机（Quest 2、Quest Pro、Quest 3 和 Quest 3S）运行 元地平线操作系统，该系统基于 64 位 Android (arm64-v8a) 构建。无论您是测试自己的与 OBB 资源文件打包的虚幻引擎/Unity VR 版本，还是将合法的 2D Android 实用程序旁加载到耳机的 来源不明 库中，SideQuest 和 ADB 都无法在不首先分离或合并其内部组件的情况下直接安装原始 .xapk 存档。
1. Meta Horizon OS 的硬件要求（仅限 64 位 ARM）
Qualcomm Snapdragon XR2 Gen 1 (Quest 2) 和 Snapdragon XR2 Gen 2 (Quest 3 / Quest 3S) 运行严格的 64 位 Android 用户区。在尝试旁加载任何包之前：
- 确保包包含 arm64-v8a 本机库（或者是纯 Java/Kotlin 字节码）。您可以通过将文件放入我们的 设备 ABI 和 DPI 兼容性检查器 中来在两秒钟内验证这一点。
- 确保在 菜单 → 设备 → 耳机设置 → 开发者模式 下的 Meta Horizon 移动配套应用程序中启用 开发者模式。
2. 转换 Split XAPK 实用程序以进行 SideQuest 安装
如果您的 .xapk 是拆分 APK 捆绑包（包含 base.apk、config.arm64_v8a.apk 和 config.xxhdpi.apk）：
- 在 PC、Mac 上或直接在 Meta Quest 浏览器中打开 XAPK 转 APK 在线转换器。
- 删除 .xapk 文件，将所有拆分合并到单个 v1+v2 签名的 .apk 文件中。
- 在 PC 或 Mac 上的 SideQuest（高级安装程序） 中，单击顶部栏中的 从计算机上的文件夹安装 APK 文件 图标，然后选择转换后的 .apk。
3. 部署包含 OBB 扩展文件的 VR 构建
许多独立的 VR 体验和 Unity 构建将其编译代码保留在 base.apk 中，并将 3D 纹理和音频库存储在 main.<version>.<package>.obb 扩展文件中。如果您仅安装 APK，耳机将停留在无限三点加载屏幕上。
- 提取 APK 和 OBB： 将您的 .xapk 捆绑包放入我们的 OBB 文件提取器 或 XAPK 档案查看器 中，将 .apk 和 .obb 文件下载到您的计算机上。
- 安装 APK 并通过 ADB 或 SideQuest 推送 OBB： 通过 USB-C 连接 Quest 耳机并从终端运行这两个命令：
adb install base.apk adb shell mkdir -p /sdcard/Android/obb/com.studio.vrapp/ adb push main.100.com.studio.vrapp.obb /sdcard/Android/obb/com.studio.vrapp/
在 Meta Horizon OS 内启动旁加载应用程序
安装后，打开耳机内的通用菜单，打开 应用程序库，单击右上角的筛选器下拉列表（或较新的 Horizon OS 版本的左侧边栏），然后选择 来源不明。标准 2D Android 实用程序将在您的家庭环境中的浮动、可调整大小的弧形窗口内自动打开。