You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

使用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
}

第三步:验证配置与环境

重新编译项目后,可以通过这些方式排查:

  1. 解压生成的APK,反编译查看AndroidManifest.xml,确认com.google.ar.core.min_apk_version元数据已存在
  2. 在创建AR会话前,先调用ArCoreApk.getInstance().requestInstall(this, true),确保设备上安装了符合版本要求的ARCore服务

额外排查点

如果还是报错,可以检查:

  • 设备是否在ARCore兼容列表中(可以直接在Google Play搜索ARCore查看设备兼容性)
  • 项目的targetSdkVersion是否符合ARCore要求(目前推荐33及以上)

内容的提问来源于stack exchange,提问作者Hongkun Wang

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.05.25 03:36:12