为何Vuforia Magic Leap 2示例无法在设备上正常运行？

环境与配置校验 #

• 确认Unity版本兼容性：核对Unity 2022.2.0f1与Magic Leap SDK 1.3.0、Vuforia 10.14.4的官方兼容矩阵，版本不匹配可能导致底层交互异常。
• 检查Vuforia许可证状态：在Unity的Vuforia Configuration面板中，确认许可证密钥正确输入且激活（无红色警告）；若许可证绑定设备ID，需确保当前设备ID已添加至许可证列表。
• 验证权限配置完整性：确认AndroidManifest.xml中已生成com.magicleap.permission.SPATIAL_MAPPING、android.permission.CAMERA等必要权限，可解压构建后的APK直接查看该文件。

项目导入与场景设置 #

• 保持项目纯净性：新建项目导入示例时，避免额外导入旧版本Vuforia/Magic Leap SDK，直接使用示例自带的com.magicleap.unitysdk.tgz和com.ptc.vuforia.engine.tgz包，防止依赖版本冲突。
• 检查Vuforia组件状态：打开示例场景，确认ARCamera对象的Vuforia Behaviour组件已启用，Device Tracker设置为Magic Leap模式，且Spatial Mapping模块处于开启状态。
• 确认目标数据库配置：示例中的图像目标/VU标记需已导入Vuforia Target Manager，对应的数据库已下载并添加至项目Vuforia Configuration，且数据库设置为Active状态。

设备端操作与调试 #

• 确保空间地图有效性：设备完成空间扫描后需保存地图，启动应用时选择正确的已扫描地图（部分示例依赖空间锚点）。
• 抓取设备运行日志：通过Magic Leap Hub连接设备，导出应用运行日志，搜索Vuforia或MagicLeap相关报错（如相机权限未授予、跟踪初始化失败、数据库加载错误），定位问题根源。
• 检查相机权限：在设备应用权限设置中，确认已授予示例应用相机权限，首次启动未授权需手动开启。

构建流程检查 #

• 验证构建平台与架构：Unity Build Settings中目标平台设为Android，架构选择ARM64（Magic Leap 2仅支持64位）。
• 避免手动配置覆盖：若手动修改过AndroidManifest.xml或Gradle文件，需确保未覆盖Vuforia和Magic Leap的自动配置项，建议重新构建并禁用手动修改的配置。

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