使用Visual Studio开发原生Android ARCore应用时会话创建失败求助
解决AR会话创建失败:缺失
com.google.ar.core.min_apk_version元数据 我之前也遇到过一模一样的问题,这个报错的核心就是你的AndroidManifest.xml里漏掉了ARCore强制要求的关键元数据配置,几步就能搞定:
第一步:补全AndroidManifest.xml配置
你需要在<application>标签内部添加这条元数据:
<meta-data android:name="com.google.ar.core.min_apk_version" android:value="1" />
这里的value="1"是基础兼容的最低ARCore APK版本,如果你需要适配更高版本的ARCore特性,可以根据官方文档调整数值,但1足以解决当前的报错问题。
同时别忘了补上ARCore必备的其他清单配置:
- 相机权限和AR硬件特性声明:
<uses-permission android:name="android.permission.CAMERA" /> <uses-feature android:name="android.hardware.camera.ar" android:required="true" />
- 如果你的应用需要支持非AR设备(可选兼容),可以把
android:required改为false,并添加ARCore依赖声明:
<meta-data android:name="com.google.ar.core" android:value="optional" />
第二步:确认ARCore依赖正确打包
因为你是手动配置ARCore依赖,要确保这两点:
- 已经将ARCore的aar文件(比如
arcore_client.aar)放到项目的libs目录下 - 在Module级的build.gradle中添加本地aar的依赖:
dependencies { implementation files('libs/arcore_client.aar') // 同时确保项目依赖了必要的AndroidX库,比如appcompat }
第三步:验证配置与环境
重新编译项目后,可以通过这些方式排查:
- 解压生成的APK,反编译查看AndroidManifest.xml,确认
com.google.ar.core.min_apk_version元数据已存在 - 在创建AR会话前,先调用
ArCoreApk.getInstance().requestInstall(this, true),确保设备上安装了符合版本要求的ARCore服务
额外排查点
如果还是报错,可以检查:
- 设备是否在ARCore兼容列表中(可以直接在Google Play搜索ARCore查看设备兼容性)
- 项目的
targetSdkVersion是否符合ARCore要求(目前推荐33及以上)
内容的提问来源于stack exchange,提问作者Hongkun Wang
相关产品推荐
相关产品推荐

