bg_location 是一个用于在 Flutter 应用中实现后台定位的插件。它允许应用在后台持续获取设备的位置信息，即使应用不在前台运行。这对于需要持续跟踪用户位置的应用（如健身应用、导航应用等）非常有用。

安装 bg_location 插件

首先，你需要在 pubspec.yaml 文件中添加 bg_location 插件的依赖：

dependencies:
  flutter:
    sdk: flutter
  bg_location: ^2.0.0  # 请检查最新版本

然后运行 flutter pub get 来安装插件。

配置 Android 和 iOS

Android 配置

1. 权限配置：在 AndroidManifest.xml 文件中添加以下权限：

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

2. 后台服务配置：在 AndroidManifest.xml 文件中添加以下服务声明：

   <service
       android:name="com.rekab.app.background_locator.IsolateHolderService"
       android:foregroundServiceType="location" />

3. ProGuard 配置（如果需要）：如果你启用了 ProGuard，请在 proguard-rules.pro 文件中添加以下规则：

   -keep class com.rekab.app.background_locator.** { *; }

iOS 配置

1. 权限配置：在 Info.plist 文件中添加以下键值对以请求定位权限：

   <key>NSLocationAlwaysAndWhenInUseUsageDescription</key>
   <string>我们需要您的位置信息来提供更好的服务。</string>
   <key>NSLocationWhenInUseUsageDescription</key>
   <string>我们需要您的位置信息来提供更好的服务。</string>

2. 后台模式配置：在 Info.plist 文件中启用后台定位模式：

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

使用 bg_location 插件

初始化插件

在 main.dart 文件中初始化 bg_location 插件：

import 'package:bg_location/bg_location.dart';

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  await BgLocation.initialize();
  runApp(MyApp());
}

启动后台定位服务

你可以使用 BgLocation.start() 方法来启动后台定位服务：

await BgLocation.start();

停止后台定位服务

你可以使用 BgLocation.stop() 方法来停止后台定位服务：

await BgLocation.stop();

监听位置更新

你可以通过 BgLocation.onLocationUpdate 来监听位置更新：

BgLocation.onLocationUpdate.listen((LocationDto location) {
  print('Latitude: ${location.latitude}, Longitude: ${location.longitude}');
});

处理后台任务

bg_location 插件使用 Dart 的 Isolate 来处理后台任务。你可以在 callbackDispatcher 中定义后台任务的逻辑：

void callbackDispatcher() {
  BgLocation.setupIsolate();

  BgLocation.onLocationUpdate.listen((LocationDto location) {
    // 处理位置更新
    print('Background Location: ${location.latitude}, ${location.longitude}');
  });
}

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  await BgLocation.initialize(callbackDispatcher);
  runApp(MyApp());
}

示例代码

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

import 'package:flutter/material.dart';
import 'package:bg_location/bg_location.dart';

void callbackDispatcher() {
  BgLocation.setupIsolate();

  BgLocation.onLocationUpdate.listen((LocationDto location) {
    print('Background Location: ${location.latitude}, ${location.longitude}');
  });
}

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  await BgLocation.initialize(callbackDispatcher);
  runApp(MyApp());
}

class MyApp extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: Text('Background Location Example'),
        ),
        body: Center(
          child: Column(
            mainAxisAlignment: MainAxisAlignment.center,
            children: <Widget>[
              ElevatedButton(
                onPressed: () async {
                  await BgLocation.start();
                  print('Background location started');
                },
                child: Text('Start Background Location'),
              ),
              ElevatedButton(
                onPressed: () async {
                  await BgLocation.stop();
                  print('Background location stopped');
                },
                child: Text('Stop Background Location'),
              ),
            ],
          ),
        ),
      ),
    );
  }
}