Flutter位置服务插件awareframework_locations的使用

安装插件到项目

1. 编辑 pubspec.yaml

在项目的 pubspec.yaml 文件中添加以下依赖：

dependencies:
  awareframework_locations

2. 在源代码中导入包

在需要使用的 Dart 文件中导入以下包：

import 'package:awareframework_locations/awareframework_locations.dart';
import 'package:awareframework_core/awareframework_core.dart';

3. 配置 iOS 权限

打开你的 Xcode 项目（*.xcworkspace），并在 Info.plist 文件中添加以下权限描述：

• NSLocationAlwaysAndWhenInUseUsageDescription
• NSLocationWhenInUseUsageDescription
• NSLocationAlwaysUsageDescription

公共函数

位置传感器

Locations Sensor

• start()：开始监听位置更新。
• stop()：停止监听位置更新。
• sync(bool force)：同步位置数据。
• enable()：启用传感器。
• disable()：禁用传感器。
• isEnable()：检查传感器是否已启用。
• setLabel(String label)：设置传感器标签。

配置键

以下是位置传感器的一些配置键及其默认值：

• geoFences: String?：定义地理围栏。如果设备位于这些围栏范围内，则接受该位置更新。如果为 null，则接受所有位置更新。格式为 (?:latitude),(?:longitude)[ \t;]+。（默认 = null）
• statusGps: Boolean：是否激活 GPS 位置。（默认 = true）^{[Android Only]}
• statusNetwork: Boolean：是否激活网络位置。（默认 = true）^{[Android Only]}
• statusPassive: Boolean：是否激活被动位置。（默认 = true）^{[Android Only]}
• frequencyGps: Int：GPS 定位的频率，单位为秒。（默认 = 180）
• minGpsAccuracy: Int：GPS 定位的最小可接受精度，单位为米。（默认 = 150）
• frequencyNetwork: Int：网络定位的频率，单位为秒。（默认 = 300）^{[Android Only]}
• minNetworkAccuracy: Int：网络定位的最小可接受精度，单位为米。（默认 = 1500）^{[Android Only]}
• expirationTime: Long：位置数据过期的时间，单位为秒。（默认 = 300）
• saveAll: Boolean：是否保存所有位置更新。（默认 = false）
• enabled: Boolean：传感器是否已启用。（默认 = false）
• debug: Boolean：是否启用日志记录。（默认 = false）
• label: String：传感器的标签。（默认 = “”）
• deviceId: String：与事件和传感器关联的设备 ID。（默认 = “”）
• dbEncryptionKey：数据库加密密钥。（默认 = null）
• dbType: Engine：用于保存数据的数据库引擎。（默认 = Engine.DatabaseType.NONE）
• dbPath: String：数据库路径。（默认 = “aware_locations”）
• dbHost: String：用于同步数据库的主机。（默认 = null）

数据表示

位置数据在 Android 和 iOS 上的表现形式有所不同。以下是相关链接：

• Android
• iOS

示例代码

以下是一个完整的示例代码，展示如何使用 awareframework_locations 插件：

import 'package:flutter/material.dart';

import 'package:awareframework_locations/awareframework_locations.dart';

void main() => runApp(new MyApp());

class MyApp extends StatefulWidget {
  late LocationSensor sensor;
  LocationData data = LocationData();
  [@override](/user/override)
  _MyAppState createState() => new _MyAppState();
}

class _MyAppState extends State<MyApp> {
  bool sensorState = true;

  [@override](/user/override)
  void initState() {
    super.initState();

    // 初始化配置
    var config = LocationSensorConfig()
      ..debug = true
      ..label = "label";

    // 初始化传感器
    widget.sensor = new LocationSensor.init(config);
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return new MaterialApp(
      home: new Scaffold(
        appBar: new AppBar(
          title: const Text('位置服务插件示例'),
        ),
        body: Column(
          children: [
            // 启动按钮
            TextButton(
                onPressed: () {
                  // 监听位置变化
                  widget.sensor.onLocationChanged.listen((event) {
                    setState(() {
                      Text("纬度:\t${event.latitude}");
                      Text("经度:\t${event.longitude}");
                    });
                  });
                  // 开始监听位置
                  widget.sensor.start();
                },
                child: Text("启动")),

            // 停止按钮
            TextButton(
                onPressed: () {
                  // 停止监听位置
                  widget.sensor.stop();
                },
                child: Text("停止")),

            // 同步按钮
            TextButton(
                onPressed: () {
                  // 同步位置数据
                  widget.sensor.sync();
                },
                child: Text("同步")),
          ],
        ),
      ),
    );
  }
}