Como fazer o sideload de pacotes XAPK e ativos OBB no Meta Quest 2, Quest 3 e Quest 3S

Os headsets VR autônomos Meta Quest (Quest 2, Quest Pro, Quest 3 e Quest 3S) executam SO Meta Horizonte, que é baseado em Android de 64 bits (arm64-v8a). Esteja você testando sua própria compilação Unreal Engine / Unity VR empacotada com um arquivo de ativos OBB ou carregando um utilitário Android 2D legítimo na biblioteca Fontes desconhecidas do seu fone de ouvido, SideQuest e ADB não podem instalar um arquivo .xapk bruto diretamente sem primeiro separar ou mesclar seus componentes internos.

1. Requisitos de hardware no Meta Horizon OS (somente ARM de 64 bits)

O Qualcomm Snapdragon XR2 Gen 1 (Quest 2) e o Snapdragon XR2 Gen 2 (Quest 3 / Quest 3S) executam um ambiente de usuário Android estrito de 64 bits. Antes de tentar fazer o sideload de qualquer pacote:

• Certifique-se de que o pacote contenha bibliotecas nativas arm64-v8a (ou seja um bytecode Java/Kotlin puro). Você pode verificar isso em dois segundos, colocando seu arquivo em nosso Verificador de compatibilidade de ABI e DPI do dispositivo.
• Certifique-se de que Modo de desenvolvedor esteja habilitado no aplicativo complementar móvel Meta Horizon em Menu → Dispositivos → Configurações do fone de ouvido → Modo de desenvolvedor.

2. Convertendo utilitários Split XAPK para instalação SideQuest

Se o seu .xapk for um pacote APK dividido (contendo base.apk), config.arm64_v8a.apk e config.xxhdpi.apk:

1. Abra o Conversor de XAPK para APK no seu PC, Mac ou diretamente no navegador Meta Quest.
2. Solte o arquivo .xapk para mesclar todas as divisões em um único arquivo .apk assinado v1+v2.
3. Em SideQuest (instalador avançado) em seu PC ou Mac, clique no ícone Instale o arquivo APK da pasta no computador na barra superior e selecione o .apk convertido.

3. Implantando compilações VR que incluem um arquivo de expansão OBB

Muitas experiências autônomas de VR e compilações do Unity mantêm seu código compilado em base.apk e armazenam texturas 3D e bancos de áudio dentro de um arquivo de expansão main.<version>.<package>.obb. Se você instalar apenas o APK, o fone ficará em uma tela infinita de carregamento de três pontos.

1. Extraia APK e OBB: Coloque seu pacote .xapk em nosso Extrator de arquivo OBB ou Visualizador de arquivo XAPK para baixar o arquivo .apk e .obb para o seu computador.
2. Instale o APK e envie o OBB via ADB ou SideQuest: Conecte seu fone de ouvido Quest via USB-C e execute estes dois comandos em seu 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/

Lançamento de aplicativos sideloaded dentro do Meta Horizon OS

Depois de instalado, abra o menu universal dentro do fone de ouvido, abra o Biblioteca de aplicativos, clique no menu suspenso de filtro no canto superior direito (ou na barra lateral esquerda nas versões mais recentes do Horizon OS) e selecione Fontes desconhecidas. Os utilitários Android 2D padrão serão abertos automaticamente dentro de uma janela curva flutuante e redimensionável em seu ambiente doméstico.