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

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

本插件用于在Android和iOS上处理地理位置获取。它还提供了位置变化时的回调。

插件安装

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

dependencies:
  location_fams: ^5.0.0

然后运行flutter pub get以安装依赖项。

Android平台配置

要使用后台模式，请确保在AndroidManifest.xml文件中添加必要的权限：

<uses-permission android:name="android.permission.FOREGROUND_SERVICE" />
<uses-permission android:name="android.permission.ACCESS_BACKGROUND_LOCATION"/>

用户需要手动将位置权限设置为“始终允许”，以使用后台位置功能。更多详情可以查看Android开发者文档。

iOS平台配置

在Info.plist文件中添加以下权限描述：

<key>NSLocationWhenInUseUsageDescription</key>
<string>This app needs access to location when open.</string>

<key>NSLocationAlwaysAndWhenInUseUsageDescription</key>
<string>This app needs access to location when in the background.</string>

为了在应用后台运行时接收位置信息，还需要在Info.plist文件中添加以下属性：

<key>UIBackgroundModes</key>
<array>
  <string>location</string>
</array>

Web平台配置

无需任何额外配置，插件可以直接使用。

macOS平台配置

确保应用程序正确地进行了沙箱处理，并启用了位置访问权限。具体步骤如下：

1. 在项目导航器中，点击应用的目标。
2. 点击“能力”选项卡。
3. 打开“应用沙箱”并展开其详细信息。
4. 选择“位置”。

在Info.plist文件中添加以下权限描述：

<key>NSLocationWhenInUseUsageDescription</key>
<string>This app needs access to location when open.</string>

<key>NSLocationAlwaysUsageDescription</key>
<string>This app needs access to location when in the background.</string>

使用方法

首先，导入插件：

import 'package:location_fams/location_fams.dart';

请求位置前，需要检查位置服务状态和权限状态：

Location location = new Location();

bool _serviceEnabled;
PermissionStatus _permissionGranted;
LocationData _locationData;

_serviceEnabled = await location.serviceEnabled();
if (!_serviceEnabled) {
  _serviceEnabled = await location.requestService();
  if (!_serviceEnabled) {
    return;
  }
}

_permissionGranted = await location.hasPermission();
if (_permissionGranted == PermissionStatus.denied) {
  _permissionGranted = await location.requestPermission();
  if (_permissionGranted != PermissionStatus.granted) {
    return;
  }
}

_locationData = await location.getLocation();

获取到当前位置后，可以通过监听位置变化来实时更新位置信息：

location.onLocationChanged.listen((LocationData currentLocation) {
  // 使用当前的位置数据
});

要在应用后台运行时启用位置更新，可以使用以下方法：

location.enableBackgroundMode(enable: true);

完整示例

以下是一个完整的示例代码，展示了如何使用location_fams插件获取和监听位置信息：

import 'package:example/change_settings.dart';
import 'package:example/enable_in_background.dart';
import 'package:flutter/material.dart';
import 'package:location_fams/location_fams.dart';
import 'package:url_launcher/url_launcher.dart';

const _url = 'https://github.com/Lyokone/flutterlocation';

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

class MyApp extends StatelessWidget {
  const MyApp({super.key});

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Flutter Location',
      theme: ThemeData(
        primarySwatch: Colors.amber,
      ),
      home: const MyHomePage(title: 'Flutter Location Demo'),
    );
  }
}

class MyHomePage extends StatefulWidget {
  const MyHomePage({super.key, this.title});
  final String? title;

  [@override](/user/override)
  _MyHomePageState createState() => _MyHomePageState();
}

class _MyHomePageState extends State<MyHomePage> {
  final Location location = Location();

  Future<void> _showInfoDialog() {
    return showDialog<void>(
      context: context,
      builder: (context) {
        return AlertDialog(
          title: const Text('Demo Application'),
          content: SingleChildScrollView(
            child: ListBody(
              children: <Widget>[
                const Text('Created by Guillaume Bernos'),
                InkWell(
                  child: const Text(
                    _url,
                    style: TextStyle(
                      decoration: TextDecoration.underline,
                    ),
                  ),
                  onTap: () => launchUrl(Uri.parse(_url)),
                ),
              ],
            ),
          ),
          actions: <Widget>[
            TextButton(
              child: const Text('Ok'),
              onPressed: () {
                Navigator.of(context).pop();
              },
            ),
          ],
        );
      },
    );
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text(widget.title!),
        actions: <Widget>[
          IconButton(
            icon: const Icon(Icons.info_outline),
            onPressed: _showInfoDialog,
          )
        ],
      ),
      body: SingleChildScrollView(
        child: Container(
          padding: const EdgeInsets.all(32),
          child: Column(
            children: [
              const PermissionStatusWidget(),
              const Divider(height: 32),
              const ServiceEnabledWidget(),
              const Divider(height: 32),
              const GetLocationWidget(),
              const Divider(height: 32),
              const ListenLocationWidget(),
              const Divider(height: 32),
              const ChangeSettings(),
              const Divider(height: 32),
              const EnableInBackgroundWidget(),
              const Divider(height: 32),
              const ChangeNotificationWidget()
            ],
          ),
        ),
      ),
    );
  }
}