配置ARCore启用Geospatial功能报位置服务库未链接错误

错误码AR_ERROR_GOOGLE_PLAY_SERVICES_LOCATION_LIBRARY_NOT_LINKED属于构建配置类错误，触发逻辑是ARCore Geospatial模块初始化时，未检测到项目中正确链接的Google Play服务定位库，和运行时定位权限申请逻辑无关。

• 检查app模块下的build.gradle依赖配置，确认已引入兼容版本的Google Play服务定位库。Geospatial功能要求定位库版本不低于18.0.0，参考配置如下：

dependencies {
    // Google Play服务定位库，必须添加
    implementation 'com.google.android.gms:play-services-location:21.0.1'
    // 配套ARCore SDK，建议使用1.30以上稳定版本
    implementation 'com.google.ar:core:1.39.0'
}

• 若已添加依赖仍报错，检查代码混淆规则，确认定位库、ARCore的必要类没有被R8/ProGuard移除。在模块的proguard-rules.pro中追加以下规则：

-keep class com.google.android.gms.location.** { *; }
-keep class com.google.ar.core.** { *; }

• 检查清单文件配置冲突：打开AndroidManifest.xml，确认<application>标签没有配置错误的tools:node="replace"属性，避免覆盖依赖库自带的必要元数据、服务声明。
• 清理构建缓存重新打包：执行Android Studio菜单栏的Build > Clean Project，完成后执行Build > Rebuild Project，排除旧构建缓存导致依赖未被正确打入APK的问题。
• 多模块项目额外检查：不要在公共基础模块中用compileOnly方式引入定位库、ARCore依赖，compileOnly配置的依赖不会被带入最终打包的APK，统一在app主模块用implementation配置即可。

修复配置后，测试设备需要安装最新版本的Google Play服务；首次启动应用时，先完成精确定位权限的申请流程，再初始化ARCore Geospatial能力，即可正常启动。

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