欢迎加入开源鸿蒙跨平台社区： https://openharmonycrossplatform.csdn.net

Flutter 三方库 geolocator 鸿蒙化定位服务实战

摘要

geolocator 是 Flutter 生态中最常用的地理位置定位插件，支持获取当前位置、监听位置变化、获取位置信息等功能。本文基于 OpenHarmony TPC 仓库的适配版本，详细讲解 geolocator 在鸿蒙项目中的接入流程、权限配置、核心 API 使用及常见问题排查。

核心要点：

• 配置 LOCATION 定位权限
• 掌握位置获取、监听、信息查询 API
• 解决定位服务常见问题

一、定位服务架构

二、参考来源

三、接入步骤

3.1 配置 pubspec.yaml

dependencies:
  flutter:
    sdk: flutter
  
  geolocator:
    git:
      url: https://atomgit.com/openharmony-tpc/flutter_packages.git
      path: packages/geolocator/geolocator

3.2 配置定位权限（module.json5）

{
  "module": {
    "requestPermissions": [
      {
        "name": "ohos.permission.LOCATION",
        "reason": "$string:location_reason",
        "usedScene": {
          "abilities": ["EntryAbility"],
          "when": "inuse"
        }
      }
    ]
  }
}

3.3 核心代码示例

import 'package:geolocator/geolocator.dart';

class LocationService {
  Future<Position> getCurrentLocation() async {
    // 检查定位服务是否启用
    bool serviceEnabled = await Geolocator.isLocationServiceEnabled();
    if (!serviceEnabled) {
      throw Exception('定位服务未启用');
    }

    // 检查定位权限
    LocationPermission permission = await Geolocator.checkPermission();
    if (permission == LocationPermission.denied) {
      permission = await Geolocator.requestPermission();
      if (permission == LocationPermission.denied) {
        throw Exception('定位权限被拒绝');
      }
    }

    // 获取当前位置
    return await Geolocator.getCurrentPosition(
      locationSettings: const LocationSettings(
        accuracy: LocationAccuracy.high,
        distanceFilter: 10,
      ),
    );
  }

  // 监听位置变化
  Stream<Position> getLocationStream() {
    return Geolocator.getPositionStream(
      locationSettings: const LocationSettings(
        accuracy: LocationAccuracy.best,
        distanceFilter: 5,
      ),
    );
  }
}

四、验证步骤

五、常见问题排查

六、总结

geolocator 在 OpenHarmony 平台的适配需要重点关注定位权限的配置和定位服务的状态检查。通过合理配置定位精度和更新频率，可以满足不同场景的定位需求，是开发位置相关应用的必备插件。

附录：Schema.org 结构化数据

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "BlogPosting",
  "headline": "Flutter 三方库 geolocator 鸿蒙化定位服务实战",
  "description": "基于 OpenHarmony TPC 仓库，详细讲解 geolocator 在鸿蒙项目中的接入流程、权限配置与定位功能实现。",
  "author": { "@type": "Person", "name": "OpenHarmony 跨平台开发者" },
  "publisher": { "@type": "Organization", "name": "OpenHarmony 跨平台社区", "url": "https://openharmonycrossplatform.csdn.net" },
  "datePublished": "2026-05-07",
  "dateModified": "2026-05-07",
  "mainEntityOfPage": "https://openharmonycrossplatform.csdn.net",
  "keywords": ["开源鸿蒙", "OpenHarmony", "Flutter for OpenHarmony", "geolocator", "定位服务", "三方库适配"],
  "inLanguage": "zh-CN"
}
</script>