Как загрузить пакеты XAPK и ресурсы OBB в Meta Quest 2, Quest 3 и Quest 3S
Автономные VR-гарнитуры Meta Quest (Quest 2, Quest Pro, Quest 3 и Quest 3S) работают под управлением Мета Горизонт ОС, построенного на 64-битной версии Android (arm64-v8a. Независимо от того, тестируете ли вы собственную сборку Unreal Engine / Unity VR, упакованную с файлом ресурсов OBB, или загружаете легальную 2D-утилиту Android в библиотеку Неизвестные источники вашей гарнитуры, SideQuest и ADB не могут установить необработанный архив .xapk) напрямую без предварительного разделения или объединения его внутренних компонентов.
1. Требования к оборудованию для ОС Meta Horizon (только 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. Преобразование разделенных утилит XAPK для установки SideQuest
Если ваш .xapk представляет собой разделенный пакет APK (содержащий base.apk), config.arm64_v8a.apk и config.xxhdpi.apk:
- Откройте Конвертер XAPK в APK Онлайн на своем ПК, Mac или непосредственно в браузере Meta Quest.
- Отбросьте файл .xapk, чтобы объединить все разбиения в один файл .apk, подписанный v1+v2.
- В SideQuest (расширенный установщик) на вашем ПК или Mac щелкните значок Установить APK-файл из папки на компьютере на верхней панели и выберите преобразованный .apk.
3. Развертывание сборок VR, включающих файл расширения OBB
Многие автономные приложения виртуальной реальности и сборки Unity хранят скомпилированный код в base.apk, а 3D-текстуры и аудиобанки — в файле расширения main.<version>.<package>.obb. Если вы установите только APK, гарнитура останется на бесконечном трехточечном экране загрузки.
- Извлеките APK и OBB: Перетащите пакет .xapk в наш Экстрактор файлов OBB или Просмотрщик архива XAPK, чтобы загрузить на свой компьютер файлы .apk и .obb.
- Установите APK и загрузите OBB через ADB или SideQuest: Подключите гарнитуру Quest через USB-C и запустите эти две команды со своего терминала:
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
После установки откройте универсальное меню внутри гарнитуры, откройте Библиотека приложений, щелкните раскрывающийся список фильтров в правом верхнем углу (или на левой боковой панели в новых сборках Horizon OS) и выберите Неизвестные источники. Стандартные 2D-утилиты Android автоматически открываются в плавающем изогнутом окне с изменяемым размером в вашей домашней среде.