搜索插件、代码仓与 APP 分类

插件详情v0.13.2

background_location

一个 Flutter 插件,可在 Android 和 iOS 上获取后台位置更新。iOS 使用 CoreLocation,Android 使用 FusedLocationProvider。

AndroidiOS
近 30 天下载
478
喜欢数
397
Pub 分数
130

安装插件

flutter pub add background_location

插件介绍

基于插件公开信息、社区数据与项目使用情况整理的选型参考。

background_location 包为 Android 和 iOS 平台提供持续的后台位置跟踪功能。它利用原生 API——iOS 上的 CoreLocation 和 Android 上的 FusedLocationProvider,即使在应用处于非活动或终止状态时,也能提供准确且高效的定位更新。该包专为需要持久地理定位功能的应用(如健身追踪器、拼车服务或资产监控)的开发者设计,确保在各种设备上都能可靠运行。该插件简化了集成过程,只需最少的设置,并支持可配置的更新间隔和精度设置。

适合场景

  • 健身追踪应用
  • 拼车服务
  • 资产监控
  • 地理围栏应用
  • 配送跟踪

主要特点

  • 后台位置更新
  • 跨平台支持(Android 和 iOS)
  • 原生 API 集成
  • 可配置的精度和频率
  • 所需设置最少

适合对象

  • 需要持续位置跟踪的应用程序
  • 开发实时位置功能的开发者
  • 需要地理围栏的移动应用
  • 可穿戴设备或物联网设备跟踪
  • 现场服务或物流软件

使用建议

  • 电池消耗可能增加
  • 需要用户权限才能在后台访问
  • iOS 后台模式必须在 Xcode 中启用
  • Android 前台服务通知是必需的
  • 准确性取决于设备硬件和设置

原始 README

以下为关联源码仓库的 README 原文快照,最新内容请访问源码仓库。

Background Location

A Flutter plugin to get location updates in the background for both Android and iOS (Requires iOS 10.0+). Uses CoreLocation for iOS and FusedLocationProvider for Android

Getting Started

1: Add this to your pubspec.yaml file:

dependencies:
  background_location: ^0.13.0

2: Install packages from the command line:

flutter pub get

Alternatively, your editor might support flutter packages get. Check the docs for your editor to learn more.

Configuration

For using background_location package you need to add permissions to use location service. Add these permission to your platform.

iOS Platform Permission

in ios/Runner/Info.plist add:

<key>NSLocationAlwaysAndWhenInUseUsageDescription</key>
<string>[Describe your purpose for using this permission]</string>
<key>NSLocationAlwaysUsageDescription</key>
<string>[Describe your purpose for using this permission]</string>
<key>NSLocationWhenInUseUsageDescription</key>
<string>[Describe your purpose for using this permission]</string>
<key>UIBackgroundModes</key>
<array>
    <string>fetch</string>
    <string>location</string>
</array>

Note: You need to describe your purpose for using the permission in to string value. If not, attempts to access the resource fail, and might even cause your app to crash. And when publishing to the App Store, this can cause your app to be rejected by Apple. Refer to Provide a purpose string (Apple Docummentation).

Android Platform Permission

In android/app/src/main/AndroidManifest.xml add:

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

How to use

Import the package where you wanna use it.

import 'package:background_location/background_location.dart';

Request permissions from the user. You can use permission_handler for this.

Set the notification title, message and icon (Android only). Use await or .then if you wanna start the location service immediately after because it's an asynchronous method

BackgroundLocation.setAndroidNotification(
  title: "Notification title",
  message: "Notification message",
  icon: "@mipmap/ic_launcher",
);

Set the interval between localizations in milliseconds (Android only). Use await or .then if you wanna start the location service immediately after because it's an asynchronous method

BackgroundLocation.setAndroidConfiguration(1000);

Start the location service. This will also ask the user for permission if not asked previously by another package.

// To ensure that previously started services have been stopped, if desired
BackgroundLocation.stopLocationService();

// Then start the service
BackgroundLocation.startLocationService();

Note: There is currently an open issue (#10) where, if the location service is started multiple times, the location callback will get called repeatedly. This can be worked around by calling BackgroundLocation.stopLocationService(); to stop any previous running services (such as from a previous run of the app) before starting a new one.

Start location service by specifying distanceFilter. Defaults to 0 if not specified

BackgroundLocation.startLocationService(distanceFilter : 10);

You can also force the use of Android LocationManager instead of Google's FusedLocationProvider by setting the forceAndroidLocationManager property to true. If not specified, this defaults to false, which uses FusedLocationProvider if it is available, treating LocationManager as a fallback. This setting has no effect on iOS devices.

BackgroundLocation.startLocationService(forceAndroidLocationManager: true);

getLocationUpdates will triggered whenever the location is updated on the device. Provide a callback function to getLocationUpdates to handle location updates.

BackgroundLocation.getLocationUpdates((location) {
  print(location);
});

location is a Class exposing the following properties.

double latitude;
double longitude;
double altitude;
double bearing;
double accuracy;
double speed;
double time;
bool isMock;

To stop listening to location changes you can execute.

BackgroundLocation.stopLocationService();

所属分类

源码仓库

使用此插件的项目

暂无相关数据。