traccar_gennissi 是一个用于 Flutter 的位置追踪与设备管理插件，它允许开发者集成 Traccar 位置追踪服务到 Flutter 应用中。Traccar 是一个开源的 GPS 追踪平台，支持多种设备和协议。

以下是如何在 Flutter 项目中使用 traccar_gennissi 插件的基本步骤：

1. 添加依赖

首先，在 pubspec.yaml 文件中添加 traccar_gennissi 插件的依赖：

dependencies:
  flutter:
    sdk: flutter
  traccar_gennissi: ^1.0.0  # 请使用最新的版本号

然后运行 flutter pub get 来获取依赖。

2. 配置 Android 和 iOS 项目

由于位置追踪涉及到权限和后台服务，因此需要在 Android 和 iOS 项目中进行一些配置。

Android

在 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" />

iOS

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

<key>NSLocationAlwaysUsageDescription</key>
<string>We need access to your location to track your device.</string>
<key>NSLocationWhenInUseUsageDescription</key>
<string>We need access to your location to track your device.</string>

3. 初始化插件

在 Flutter 应用中初始化 traccar_gennissi 插件。通常在 main.dart 文件中进行初始化：

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

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  await TraccarGenissi.initialize(
    serverUrl: 'https://your-traccar-server.com',
    deviceId: 'your-device-id',
    interval: 10, // 位置更新间隔，单位：秒
  );
  runApp(MyApp());
}

class MyApp extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Traccar Flutter Demo',
      home: HomeScreen(),
    );
  }
}

4. 启动和停止追踪

你可以在应用中的任何地方启动和停止位置追踪服务：

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

class HomeScreen extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('Traccar Flutter Demo'),
      ),
      body: Center(
        child: Column(
          mainAxisAlignment: MainAxisAlignment.center,
          children: [
            ElevatedButton(
              onPressed: () async {
                await TraccarGenissi.startTracking();
                ScaffoldMessenger.of(context).showSnackBar(
                  SnackBar(content: Text('Tracking started')),
                );
              },
              child: Text('Start Tracking'),
            ),
            SizedBox(height: 20),
            ElevatedButton(
              onPressed: () async {
                await TraccarGenissi.stopTracking();
                ScaffoldMessenger.of(context).showSnackBar(
                  SnackBar(content: Text('Tracking stopped')),
                );
              },
              child: Text('Stop Tracking'),
            ),
          ],
        ),
      ),
    );
  }
}

5. 处理位置更新

你可以监听位置更新事件并处理位置数据：

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

class LocationScreen extends StatefulWidget {
  @override
  _LocationScreenState createState() => _LocationScreenState();
}

class _LocationScreenState extends State<LocationScreen> {
  Position? _currentPosition;

  @override
  void initState() {
    super.initState();
    TraccarGenissi.onPositionChanged.listen((position) {
      setState(() {
        _currentPosition = position;
      });
    });
  }

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('Current Location'),
      ),
      body: Center(
        child: _currentPosition != null
            ? Text(
                'Lat: ${_currentPosition!.latitude}, Lon: ${_currentPosition!.longitude}')
            : Text('Waiting for location...'),
      ),
    );
  }
}

6. 处理权限

在使用位置追踪功能之前，确保你已经请求并获得了必要的位置权限。你可以使用 permission_handler 插件来处理权限请求。

import 'package:permission_handler/permission_handler.dart';

Future<void> requestLocationPermission() async {
  var status = await Permission.location.request();
  if (status.isGranted) {
    // 权限已授予
  } else {
    // 权限被拒绝
  }
}