Comment télécharger des bundles XAPK et des actifs OBB sur Meta Quest 2, Quest 3 et Quest 3S
Les casques VR autonomes Meta Quest (Quest 2, Quest Pro, Quest 3 et Quest 3S) exécutent Système d'exploitation Meta Horizon, qui est construit sur Android 64 bits (arm64-v8a). Que vous testiez votre propre version Unreal Engine / Unity VR fournie avec un fichier d'actifs OBB ou que vous téléchargiez un utilitaire Android 2D légitime dans la bibliothèque Sources inconnues de votre casque, SideQuest et ADB ne peuvent pas installer directement une archive .xapk brute sans d'abord séparer ou fusionner ses composants internes.
1. Configuration matérielle requise sur Meta Horizon OS (ARM 64 bits uniquement)
Les Qualcomm Snapdragon XR2 Gen 1 (Quest 2) et Snapdragon XR2 Gen 2 (Quest 3 / Quest 3S) exécutent un espace utilisateur Android 64 bits strict. Avant d'essayer de charger un package :
- Assurez-vous que le package contient des bibliothèques natives arm64-v8a (ou qu'il s'agit d'un bytecode Java/Kotlin pur). Vous pouvez le vérifier en deux secondes en déposant votre fichier dans notre Vérificateur de compatibilité ABI et DPI des appareils.
- Assurez-vous que Mode développeur est activé dans l'application mobile compagnon Meta Horizon sous Menu → Appareils → Paramètres du casque → Mode développeur.
2. Conversion des utilitaires Split XAPK pour l'installation de SideQuest
Si votre .xapk est un bundle APK divisé (contenant base.apk), config.arm64_v8a.apk et config.xxhdpi.apk :
- Ouvrez le Convertisseur XAPK en APK sur votre PC, Mac ou directement dans le navigateur Meta Quest.
- Supprimez le fichier .xapk pour fusionner toutes les divisions en un seul fichier .apk signé v1+v2.
- Dans SideQuest (installateur avancé) sur votre PC ou Mac, cliquez sur l'icône Installer le fichier APK à partir du dossier sur l'ordinateur dans la barre supérieure et sélectionnez le .apk converti.
3. Déploiement de versions VR incluant un fichier d'extension OBB
De nombreuses expériences VR autonomes et versions Unity conservent leur code compilé dans base.apk et stockent les textures 3D et les banques audio dans un fichier d'extension main.<version>.<package>.obb. Si vous installez uniquement l’APK, le casque restera sur un écran de chargement infini à trois points.
- Extrayez l’APK et l’OBB : Déposez votre bundle .xapk dans notre Extracteur de fichiers OBB ou Visionneuse d'archives XAPK pour télécharger à la fois le fichier .apk et le fichier .obb sur votre ordinateur.
- Installez l'APK et poussez l'OBB via ADB ou SideQuest : Connectez votre casque Quest via USB-C et exécutez ces deux commandes depuis votre terminal :
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/
Lancement d'applications téléchargées dans Meta Horizon OS
Une fois installé, ouvrez votre menu universel à l'intérieur du casque, ouvrez le Bibliothèque d'applications, cliquez sur la liste déroulante des filtres dans le coin supérieur droit (ou sur la barre latérale gauche sur les versions plus récentes d'Horizon OS) et sélectionnez Sources inconnues. Les utilitaires Android 2D standard s'ouvriront automatiquement dans une fenêtre incurvée flottante et redimensionnable dans votre environnement domestique.