Meta Quest 2, Quest 3 및 Quest 3S에서 XAPK 번들 및 OBB 자산을 사이드로드하는 방법
Meta Quest 독립형 VR 헤드셋(Quest 2, Quest Pro, Quest 3 및 Quest 3S)은 64비트 Android(arm64-v8a를 기반으로 구축된 메타 호라이즌 OS를 실행합니다. OBB 자산 파일과 함께 패키지된 Unreal Engine/Unity VR 빌드를 테스트하거나 합법적인 2D Android 유틸리티를 헤드셋의 알 수 없는 소스 라이브러리에 사이드로드하는 경우 SideQuest 및 ADB는 먼저 내부 구성 요소를 분리하거나 병합하지 않고 원시 .xapk) 아카이브를 직접 설치할 수 없습니다.
1. Meta Horizon OS의 하드웨어 요구 사항(64비트 ARM만 해당)
Qualcomm Snapdragon XR2 Gen 1(Quest 2) 및 Snapdragon XR2 Gen 2(Quest 3/Quest 3S)는 엄격한 64비트 Android 사용자 영역을 실행합니다. 패키지를 사이드로드하기 전에 다음을 수행하십시오.
- 패키지에 arm64-v8a 네이티브 라이브러리가 포함되어 있는지(또는 순수 Java/Kotlin 바이트코드인지) 확인하세요. 파일을 장치 ABI 및 DPI 호환성 검사기에 놓으면 2초 안에 이를 확인할 수 있습니다.
- 메뉴 → 장치 → 헤드셋 설정 → 개발자 모드 아래의 Meta Horizon 모바일 도우미 앱에서 개발자 모드가 활성화되어 있는지 확인하세요.
2. SideQuest 설치를 위해 분할 XAPK 유틸리티 변환
.xapk가 분할 APK 번들(base.apk, config.arm64_v8a.apk 및 config.xxhdpi.apk 포함)인 경우:
- PC, Mac에서 또는 Meta Quest Browser 내에서 직접 XAPK to APK 변환기를 엽니다.
- 모든 분할을 단일 v1+v2 서명 .apk 파일로 병합하려면 .xapk 파일을 삭제하세요.
- PC나 Mac의 SideQuest(고급 설치 프로그램)에서 상단 바의 컴퓨터의 폴더에서 APK 파일 설치 아이콘을 클릭하고 변환된 .apk를 선택하세요.
3. OBB 확장 파일을 포함하는 VR 빌드 배포
많은 독립형 VR 경험과 Unity 빌드는 컴파일된 코드를 base.apk에 유지하고 3D 텍스처와 오디오 뱅크를 main.<version>.<package>.obb 확장 파일에 저장합니다. APK만 설치하면 헤드셋은 무한한 점 3개 로딩 화면으로 유지됩니다.
- APK와 OBB를 모두 추출합니다. .xapk 번들을 OBB 파일 추출기 또는 XAPK 아카이브 뷰어에 드롭하여 .apk 및 .obb 파일을 모두 컴퓨터에 다운로드하세요.
- APK를 설치하고 ADB 또는 SideQuest를 통해 OBB를 푸시합니다. USB-C를 통해 Quest 헤드셋을 연결하고 터미널에서 다음 두 명령을 실행하세요.
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/
Meta Horizon OS 내에서 사이드로드된 앱 실행
설치가 완료되면 헤드셋 내에서 범용 메뉴를 열고 앱 라이브러리를 열고 오른쪽 상단 모서리에 있는 필터 드롭다운(또는 최신 Horizon OS 빌드의 경우 왼쪽 사이드바)을 클릭한 다음 알 수 없는 소스를 선택합니다. 표준 2D Android 유틸리티는 가정 환경의 크기 조정이 가능한 부동 곡선 창 내부에서 자동으로 열립니다.