XAPK-bundels en OBB-activa sideloaden op Meta Quest 2, Quest 3 en Quest 3S

Meta Quest standalone VR-headsets (Quest 2, Quest Pro, Quest 3 en Quest 3S) draaien op Meta Horizon-besturingssysteem, dat is gebouwd op 64-bit Android (arm64-v8a). Of u nu uw eigen Unreal Engine / Unity VR-build test, verpakt met een OBB-activabestand, of een legitiem 2D Android-hulpprogramma sideloadt in de Onbekende bronnen-bibliotheek van uw headset, SideQuest en ADB kunnen een onbewerkt .xapk-archief niet rechtstreeks installeren zonder eerst de interne componenten te scheiden of samen te voegen.

1. Hardwarevereisten voor Meta Horizon OS (alleen 64-bits ARM)

De Qualcomm Snapdragon XR2 Gen 1 (Quest 2) en Snapdragon XR2 Gen 2 (Quest 3 / Quest 3S) draaien een strikt 64-bit Android-gebruikersland. Voordat u probeert een pakket te sideloaden:

• Zorg ervoor dat het pakket native arm64-v8a-bibliotheken bevat (of pure Java/Kotlin-bytecode is). U kunt dit binnen twee seconden verifiëren door uw bestand in onze Apparaat-ABI- en DPI-compatibiliteitscontrole te plaatsen.
• Zorg ervoor dat Ontwikkelaarsmodus is ingeschakeld in de mobiele Meta Horizon-app onder Menu → Apparaten → Headsetinstellingen → Ontwikkelaarsmodus.

2. Gesplitste XAPK-hulpprogramma's converteren voor SideQuest-installatie

Als uw .xapk een split-APK-bundel is (bevat base.apk), config.arm64_v8a.apk en config.xxhdpi.apk:

1. Open de XAPK naar APK Converter op uw pc, Mac of rechtstreeks in de Meta Quest-browser.
2. Zet het .xapk-bestand neer om alle splitsingen samen te voegen in één enkel v1+v2 ondertekend .apk-bestand.
3. Klik in SideQuest (geavanceerd installatieprogramma) op uw pc of Mac op het Installeer het APK-bestand vanuit de map op de computer-pictogram in de bovenste balk en selecteer de geconverteerde .apk.

3. VR-builds implementeren die een OBB-uitbreidingsbestand bevatten

Veel stand-alone VR-ervaringen en Unity-builds bewaren hun gecompileerde code in base.apk en slaan 3D-texturen en audiobanken op in een main.<version>.<package>.obb-uitbreidingsbestand. Als u alleen de APK installeert, blijft de headset op een oneindig laadscherm van drie stippen staan.

1. Extraheer zowel APK als OBB: Plaats uw .xapk-bundel in onze OBB-bestandsextractor of XAPK-archiefviewer om zowel het .apk- als het .obb-bestand naar uw computer te downloaden.
2. Installeer de APK en push de OBB via ADB of SideQuest: Sluit uw Quest-headset aan via USB-C en voer deze twee opdrachten uit vanaf uw 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/

Lancering van sideloaded apps binnen Meta Horizon OS

Na de installatie opent u uw universele menu in de headset, opent u de App-bibliotheek, klikt u op de vervolgkeuzelijst met filters in de rechterbovenhoek (of in de linkerzijbalk bij nieuwere Horizon OS-builds) en selecteert u Onbekende bronnen. Standaard 2D Android-hulpprogramma's worden automatisch geopend in een zwevend, aanpasbaar gebogen venster in uw thuisomgeving.