Flutter地理位置获取插件fphonelocation的使用

Flutter地理位置获取插件fphonelocation的使用

fphonelocation 是一个用于获取手机原生地理位置信息的 Flutter 插件。通过此插件，您可以轻松地在 Flutter 应用中获取设备的经纬度。

Getting Started（开始使用）

要获取手机的原生位置信息，首先需要初始化并配置 fphonelocation 插件。

示例代码

以下是一个完整的示例代码，展示如何使用 fphonelocation 插件来获取设备的经纬度。

import 'package:flutter/material.dart';
import 'package:fphonelocation/fphonelocation.dart'; // 引入 fphonelocation 插件

void main() {
  runApp(const MyApp()); // 运行应用
}

class MyApp extends StatefulWidget {
  const MyApp({super.key}); // 构造函数

  @override
  State<MyApp> createState() => _MyAppState(); // 创建状态类
}

class _MyAppState extends State<MyApp> with WidgetsBindingObserver { // 使用 WidgetsBindingObserver 监听生命周期
  double? latitude; // 定义纬度变量
  double? longitude; // 定义经度变量

  @override
  void initState() {
    super.initState();

    // 初始化 fphonelocation 插件
    Fphonelocation.init(isSingle: false);

    // 设置位置回调函数
    Fphonelocation.setLocationCall(locationCall: (double lat, double lon) {
      print('---&gt;setLocationCall,latitude=$lat,longitude=$lon'); // 打印接收到的位置信息
      this.latitude = lat; // 更新纬度
      this.longitude = lon; // 更新经度
      setState(() {}); // 刷新界面
    });

    // 添加生命周期观察者
    WidgetsBinding.instance.addObserver(this);
  }

  @override
  void dispose() {
    // 停止定位服务
    Fphonelocation.stopLocation();
    // 移除生命周期观察者
    WidgetsBinding.instance.removeObserver(this);
    super.dispose();
  }

  @override
  void didChangeAppLifecycleState(AppLifecycleState state) {
    super.didChangeAppLifecycleState(state);

    // 根据应用生命周期状态调整定位服务
    switch (state) {
      case AppLifecycleState.inactive:
        // 应用不可见但仍可运行
        break;
      case AppLifecycleState.paused:
        // 应用已暂停，停止定位服务
        Fphonelocation.stopLocation();
        break;
      case AppLifecycleState.resumed:
        // 应用从后台返回前台，重新启动定位服务
        Fphonelocation.startLocation();
        break;
      case AppLifecycleState.detached:
        // 页面即将退出
        break;
      case AppLifecycleState.hidden:
        // TODO: 处理隐藏状态
        break;
    }
  }

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: const Text('fphonelocation 示例'), // 设置应用标题
        ),
        body: Center(
          child: Text( // 显示获取到的经纬度
            '原生传过来的经纬度为：${latitude ?? "未获取"}, ${longitude ?? "未获取"}',
            style: TextStyle(fontSize: 20), // 设置字体大小
          ),
        ),
      ),
    );
  }
}

代码说明

1. 初始化插件：

   • 调用 Fphonelocation.init(isSingle: false) 初始化插件，参数 isSingle 表示是否只获取一次位置信息。

2. 设置位置回调：

   • 使用 setLocationCall 方法设置位置回调函数，当插件接收到位置信息时会调用该函数，并将经纬度传递给回调函数。

3. 生命周期管理：

   • 使用 WidgetsBindingObserver 监听应用的生命周期状态，例如：
     • 当应用进入后台时，停止定位服务以节省资源。
     • 当应用回到前台时，重新启动定位服务。

4. UI更新：

   • 使用 setState 方法更新 UI，确保界面能够实时显示最新的经纬度。

运行效果

运行上述代码后，应用会显示设备的经纬度信息。如果设备支持 GPS 或网络定位，插件会自动获取当前位置并更新到界面上。

注意事项

• 确保设备已启用 GPS 或网络定位功能。
• 在 Android 设备上，需要在 AndroidManifest.xml 文件中添加权限：

  <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION"/>
  <uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION"/>
  

• 在 iOS 设备上，需要在 Info.plist 文件中添加权限描述：

  <key>NSLocationWhenInUseUsageDescription</key>
  <string>需要访问您的位置信息</string>