Посібник зі встановлення VR через sideload

Як встановити FastMediaSorter VR APK на Meta Quest без використання магазину.

Вимоги

  1. Meta Quest - Quest 3, Quest Pro або Quest 2
  2. USB-C кабель - для підключення шолома до ПК
  3. Developer Mode увімкнений на шоломі
  4. ADB - Android Debug Bridge (входить до Android SDK Platform Tools)

Крок 1: Увімкнути Developer Mode

  1. Відкрийте додаток Meta на телефоні
  2. Перейдіть до Меню → Пристрої та оберіть ваш шолом
  3. Натисніть Налаштування шолома → Developer Mode
  4. Увімкніть Developer Mode
  5. Перезавантажте шолом

Якщо опції Developer Mode немає, спочатку зареєструйтесь як розробник на developer.meta.com.

Крок 2: Встановити ADB

Якщо у вас вже є Android Studio або Android SDK, ADB знаходиться за шляхом:

C:\Users\<ім'я_користувача>\AppData\Local\Android\Sdk\platform-tools\adb.exe

Інакше завантажте Platform Tools з developer.android.com/tools/releases/platform-tools та розпакуйте в зручне місце.

Крок 3: Підключити Quest до ПК

  1. Підключіть Quest до ПК через USB-C
  2. Надягніть шолом - з’явиться діалог «Дозволити налагодження через USB?»
  3. Позначте «Завжди дозволяти з цього комп’ютера» та натисніть Дозволити
  4. Перевірте підключення в терміналі:
adb devices

Пристрій має відображатися зі статусом device (не unauthorized).

Крок 4: Зібрати VR APK

# Варіант A: Скрипт збірки (автоверсія + копіювання до DOWNLOADS/)
.\scripts\builders\build-vr-debug.ps1

# Варіант B: Gradle безпосередньо
.\gradlew.bat assembleVrDebug

APK буде за шляхом:

app_v2/build/outputs/apk/vr/debug/app_v2-vr-debug.apk

Або, при використанні скрипту, також скопійований до:

DOWNLOADS/FastMediaSorter_vr_debug.apk

Крок 5: Встановити на Quest

# Варіант A: Збірка + встановлення однією командою
.\scripts\builders\build-vr-device.ps1

# Варіант B: Ручне встановлення
adb install -r -d DOWNLOADS\FastMediaSorter_vr_debug.apk

Крок 6: Запуск на Quest

Додаток з’являється в розділі Unknown Sources у бібліотеці Quest:

  1. Надягніть шолом
  2. Відкрийте Бібліотеку додатків
  3. Оберіть Unknown Sources у фільтрі (верхній правий кут)
  4. Знайдіть FastMediaSorter VR та запустіть

Також можна запустити через ADB:

adb shell am start -n com.sza.fastmediasorter.vr.debug/com.sza.fastmediasorter.ui.main.MainActivity

ADB через Wi-Fi (бездротове підключення)

Щоб не використовувати кабель після початкового налаштування:

# Поки ще підключені по USB:
adb tcpip 5555

# Від'єднайте USB, потім підключіться по Wi-Fi:
adb connect <ip-адреса-quest>:5555

IP-адресу Quest можна знайти в Налаштування → Wi-Fi → Підключена мережа → Деталі.

Усунення несправностей

Проблема Рішення
adb devices показує unauthorized Надягніть шолом та прийміть діалог налагодження через USB
adb devices нічого не показує Перевірте кабель, спробуйте інший порт, переконайтеся що Developer Mode увімкнений
Додаток не видно в бібліотеці Шукайте в розділі Unknown Sources
Додаток падає при запуску Перевірте logcat: adb logcat -s FastMediaSorter
XR runtime недоступний Переконайтеся що прошивка Quest оновлена

Пов’язана документація