HMS Core Location Kit在Ionic/Vue项目调用getFusedLocationProviderClient报错

问题根源 #

出现TypeError: Cannot read properties of undefined (reading 'getFusedLocationProviderClient')的核心原因是错误的插件实例化方式，以及未等待Cordova插件加载完成就调用方法。

修复方案 #

1. 修正HMSLocation实例化逻辑 #

Ionic Native封装的HMS Location插件不需要手动new实例，直接调用类的静态方法即可。修改你的代码：

import { HMSLocation } from "@hmscore/ionic-native-hms-location/ngx";

export default {
    data() {
        return {
            fusedClient: null,
            locationResult: null,
        };
    },
    mounted() {
        // 等待Cordova设备就绪后再执行位置获取
        document.addEventListener('deviceready', this.getLocation);
    },
    methods: {
        async getLocation() {
            // 直接调用静态方法获取客户端实例
            this.fusedClient = HMSLocation.getFusedLocationProviderClient();
            // 注意：getLastLocation是异步方法，必须加括号调用
            this.locationResult = await this.fusedClient.getLastLocation();
        },
    },
    // ...
}

2. 确保插件正确加载 #

• 验证插件安装：执行npm list @hmscore/ionic-native-hms-location确认依赖已安装；执行cordova plugin list查看cordova-plugin-hms-location存在。
• 必须等待deviceready事件：Cordova插件只有在设备就绪后才能正常调用，直接在mounted中调用会导致插件未初始化完成。

3. 修复方法调用错误 #

原代码中this.fusedClient.getLastLocation缺少调用括号，会导致获取的是方法引用而非执行结果，必须改为this.fusedClient.getLastLocation()。

额外验证项 #

• 确认设备安装了符合版本要求的HMS Core服务。
• 检查AndroidManifest.xml中已添加位置权限（ACCESS_COARSE_LOCATION、ACCESS_FINE_LOCATION）及HMS配置信息。

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