Come eseguire il sideload di pacchetti XAPK e risorse OBB su Meta Quest 2, Quest 3 e Quest 3S

I visori VR autonomi Meta Quest (Quest 2, Quest Pro, Quest 3 e Quest 3S) eseguono Sistema operativo Meta Horizon, basato su Android a 64 bit (arm64-v8a). Sia che tu stia testando la tua build Unreal Engine/Unity VR confezionata con un file di risorse OBB o eseguendo il sideload di un'utilità Android 2D legittima nella libreria Fonti sconosciute del tuo visore, SideQuest e ADB non possono installare direttamente un archivio .xapk grezzo senza prima separare o unire i suoi componenti interni.

1. Requisiti hardware sul sistema operativo Meta Horizon (solo ARM a 64 bit)

Il Qualcomm Snapdragon XR2 Gen 1 (Quest 2) e lo Snapdragon XR2 Gen 2 (Quest 3 / Quest 3S) eseguono un rigoroso userland Android a 64 bit. Prima di tentare di eseguire il sideload di qualsiasi pacchetto:

• Assicurati che il pacchetto contenga le librerie native arm64-v8a (o sia un bytecode Java/Kotlin puro). Puoi verificarlo in due secondi trascinando il file nel nostro Verifica compatibilità ABI e DPI del dispositivo.
• Assicurati che Modalità sviluppatore sia abilitato nell'app mobile Meta Horizon sotto Menu → Dispositivi → Impostazioni auricolare → Modalità sviluppatore.

2. Conversione delle utilità XAPK divise per l'installazione di SideQuest

Se il tuo .xapk è un bundle con APK diviso (contenente base.apk), config.arm64_v8a.apk e config.xxhdpi.apk:

1. Apri Convertitore da XAPK a APK sul tuo PC, Mac o direttamente nel browser Meta Quest.
2. Rilascia il file .xapk per unire tutte le suddivisioni in un unico file .apk firmato v1+v2.
3. In SideQuest (programma di installazione avanzato) sul tuo PC o Mac, fai clic sull'icona Installa il file APK dalla cartella sul computer nella barra in alto e seleziona lo .apk convertito.

3. Distribuzione di build VR che includono un file di espansione OBB

Molte esperienze VR autonome e build Unity mantengono il codice compilato in base.apk e memorizzano texture 3D e banchi audio all'interno di un file di espansione main.<version>.<package>.obb. Se installi solo l'APK, l'auricolare rimarrà su una schermata di caricamento infinita a tre punti.

1. Estrai sia APK che OBB: Trascina il tuo pacchetto .xapk nel nostro Estrattore di file OBB o Visualizzatore archivio XAPK per scaricare sia il file .apk che il file .obb sul tuo computer.
2. Installa l'APK e invia OBB tramite ADB o SideQuest: Collega le tue cuffie Quest tramite USB-C ed esegui questi due comandi dal tuo terminale:

   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/

Avvio di app trasferite lateralmente all'interno del sistema operativo Meta Horizon

Una volta installato, apri il menu universale all'interno dell'auricolare, apri Libreria di app, fai clic sul menu a discesa del filtro nell'angolo in alto a destra (o sulla barra laterale sinistra nelle versioni più recenti del sistema operativo Horizon) e seleziona Fonti sconosciute. Le utilità Android 2D standard si apriranno automaticamente all'interno di una finestra curva mobile e ridimensionabile nel tuo ambiente domestico.