Oculus Quest安装Unity开发自定义APK异常问题求助

核心配置修正（APK打包阶段必查） #

• API等级适配：Quest 1 最高支持Android API 29（Android 10），Unity Player Settings中不要将Target API Level设置为30及以上，否则APK会因系统版本不兼容被设备自动过滤，安装后也不会出现在应用列表。固定配置为Minimum API Level = 23、Target API Level = 29，不要选择“Automatic (highest installed)”选项。
• CPU架构配置：Quest 1仅支持arm64-v8a指令集，需在Other Settings > Target Architectures中仅勾选ARM64，取消armeabi-v7a、x86等其他架构选项，架构不匹配的APK无法完成安装，自然不会在设备中显示。
• VR应用声明配置：必须勾选Player Settings中的Virtual Reality Supported选项，VR SDK列表仅保留Oculus，移除Cardboard等其他冗余SDK；同时确认AndroidManifest.xml中已添加com.oculus.intent.category.VR意图分类、android.hardware.vr.headtracking硬件特性声明，缺失这类配置的APK会被系统识别为无效VR应用直接过滤。

设备侧安装问题解决（找不到文件夹安装APK选项的说明） #

• 该选项并非开发者权限未开导致：Quest系统v35及以上版本已彻底移除系统自带文件管理器直接安装本地APK的入口，在系统设置中无法找到对应选项是正常现象，无需反复重置开发者模式。
• 可行安装方式仅两类：
  • 命令行安装：电脑配置ADB环境后，用USB线连接Quest，在设备弹出的调试授权弹窗点击允许，在APK所在目录执行命令adb install -r 你的项目APK文件名.apk，命令行返回Success即为安装完成。
  • 工具侧载：使用Quest通用侧载工具，识别到已连接的设备后，直接拖拽APK到工具窗口即可自动完成安装，无需手动输入命令。

安装后定位应用的注意事项 #

侧载的开发版APK不会出现在系统主应用列表，需进入设备应用库，点击右上角筛选按钮，选择「未知来源」分类，即可找到已安装的开发应用。
如果安装时报错，可根据ADB返回的错误码直接定位问题：返回INSTALL_FAILED_NO_MATCHING_ABIS为架构配置错误，返回INSTALL_FAILED_OLDER_SDK为API等级配置过高，对应修改打包配置重新编译即可。

内容的提问来源于stack exchange，提问作者Mars