Flutter位置打卡插件junny_location_punch的使用

Flutter位置打卡插件junny_location_punch的使用

Features

这是为项目抽取的定位打卡功能库。目前定位功能使用高德。

Getting started

Android

在 android/src/main/AndroidManifest.xml 文件中添加以下内容：

<manifest>
    <application>
        /// 需要配置的
        <meta-data android:name="com.amap.api.v2.apikey" android:value="您的Key" />
    </application>
</manifest>

iOS

1. 在 Info.plist 中增加:

<key>NSLocationWhenInUseUsageDescription</key>
<string>要用定位</string>

如果iOS定位没有返回逆地理信息，添加以下内容：

<key>NSAppTransportSecurity</key>
<dict>
    <key>NSAllowsArbitraryLoads</key>
    <true/>
    <key>NSAllowsArbitraryLoadsForMedia</key>
    <true/>
    <key>NSAllowsArbitraryLoadsInWebContent</key>
    <true/>
    /// 解决ios HTTP 警告，需要添加的
    <key>NSExceptionDomains</key>
    <dict>
        <key>restios.amap.com</key>
        <dict>
            <key>NSExceptionAllowsInsecureHTTPLoads</key>
            <true/>
            <key>NSIncludesSubdomains</key>
            <true/>
            <key>NSExceptionMinimumTLSVersion</key>
            <string>TLSv1.2</string>
        </dict>
    </dict>
</dict>

1. iOS 9及以上版本使用后台定位功能，需要保证"Background Modes"中的"Location updates"处于选中状态。

2. 使用地理围栏

iOS14及以上版本使用地理围栏功能，需要在 Info.plist 中配置 NSLocationTemporaryUsageDescriptionDictionary 字典描述，并添加自定义Key描述地理围栏的使用场景。此描述会在申请临时精确定位权限的弹窗中展示。该回调触发条件：拥有定位权限，但是没有获得精确定位权限的情况下，会触发该回调。此方法实现调用申请临时精确定位权限API即可。

**需要注意，在iOS9及之后版本的系统中，如果您希望程序在后台持续检测围栏触发行为，需要保证manager的 allowsBackgroundLocationUpdates 为 YES，设置为 YES 的时候必须保证 “Background Modes” 中的 “Location updates” 处于选中状态，否则会抛出异常。

完整示例代码

以下是使用 junny_location_punch 插件的完整示例代码：

import 'package:flutter/material.dart';
import 'package:junny_location_punch/junny_location_punch.dart'; // 导入位置打卡插件

void main() {
  runApp(const MyApp());
}

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

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Flutter Demo',
      theme: ThemeData(
        colorScheme: ColorScheme.fromSeed(seedColor: Colors.deepPurple),
        useMaterial3: true,
      ),
      home: const MyHomePage(title: 'Flutter Demo Home Page'),
    );
  }
}

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

  final String title;

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

class _MyHomePageState extends State<MyHomePage> {
  int _counter = 0;

  // 初始化定位插件
  late JunnyLocationPunch junnyLocationPunch;

  [@override](/user/override)
  void initState() {
    super.initState();
    junnyLocationPunch = JunnyLocationPunch(); // 创建定位插件实例
  }

  void _incrementCounter() {
    setState(() {
      _counter++;
    });
  }

  // 打卡函数
  Future<void> punchIn() async {
    try {
      var result = await junnyLocationPunch.punchIn(); // 执行打卡操作
      print('打卡结果: $result');
    } catch (e) {
      print('打卡失败: $e');
    }
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        backgroundColor: Theme.of(context).colorScheme.inversePrimary,
        title: Text(widget.title),
      ),
      body: Center(
        child: Column(
          mainAxisAlignment: MainAxisAlignment.center,
          children: <Widget>[
            const Text(
              'You have pushed the button this many times:',
            ),
            Text(
              '$_counter',
              style: Theme.of(context).textTheme.headlineMedium,
            ),
          ],
        ),
      ),
      floatingActionButton: FloatingActionButton(
        onPressed: () {
          _incrementCounter();
          punchIn(); // 点击按钮时进行打卡操作
        },
        tooltip: 'Increment',
        child: const Icon(Icons.add),
      ),
    );
  }
}