Flutter实现多设备每X小时向服务器发送状态更新请求

核心实现思路 #

• 前台定时：用Timer.periodic实现基础的定时触发逻辑，适配App前台运行时的状态上报需求
• 后台兼容：借助workmanager（Android）和background_fetch（iOS）插件突破系统后台限制，确保App在后台或设备休眠时仍能执行上报任务
• 状态采集：通过第三方插件获取电量、位置等设备状态数据
• 网络请求：用http或dio包将采集到的状态数据发送至服务器

关键代码示例 #

1. 依赖配置（pubspec.yaml） #

dependencies:
  flutter:
    sdk: flutter
  http: ^1.1.0
  battery: ^2.0.3
  geolocator: ^10.1.0
  workmanager: ^0.5.1
  background_fetch: ^1.2.4
  device_info_plus: ^9.0.2 # 用于获取设备唯一标识

2. 状态采集与上报核心方法 #

import 'dart:async';
import 'dart:convert';
import 'package:http/http.dart' as http;
import 'package:battery/battery.dart';
import 'package:geolocator/geolocator.dart';
import 'package:device_info_plus/device_info_plus.dart';
import 'package:flutter/foundation.dart';

// 获取设备唯一标识
Future<String> _getDeviceId() async {
  DeviceInfoPlugin deviceInfo = DeviceInfoPlugin();
  if (defaultTargetPlatform == TargetPlatform.android) {
    AndroidDeviceInfo androidInfo = await deviceInfo.androidInfo;
    return androidInfo.id;
  } else if (defaultTargetPlatform == TargetPlatform.iOS) {
    IosDeviceInfo iosInfo = await deviceInfo.iosInfo;
    return iosInfo.identifierForVendor!;
  }
  return 'unknown-device';
}

// 上报设备状态到服务器
Future<void> _uploadDeviceStatus() async {
  try {
    // 1. 采集电量数据
    Battery battery = Battery();
    int batteryLevel = await battery.batteryLevel;
    bool isCharging = await battery.isCharging;

    // 2. 采集位置数据
    Position? position;
    bool serviceEnabled = await Geolocator.isLocationServiceEnabled();
    if (serviceEnabled) {
      LocationPermission permission = await Geolocator.checkPermission();
      if (permission == LocationPermission.whileInUse || permission == LocationPermission.always) {
        position = await Geolocator.getCurrentPosition(desiredAccuracy: LocationAccuracy.low);
      }
    }

    // 3. 构造上报数据
    String deviceId = await _getDeviceId();
    Map<String, dynamic> statusData = {
      'device_id': deviceId,
      'battery_level': batteryLevel,
      'is_charging': isCharging,
      'latitude': position?.latitude,
      'longitude': position?.longitude,
      'timestamp': DateTime.now().toIso8601String()
    };

    // 4. 发送POST请求
    await http.post(
      Uri.parse('https://your-server-endpoint.com/api/update-status'),
      headers: {'Content-Type': 'application/json'},
      body: jsonEncode(statusData),
    );
  } catch (e) {
    print('状态上报失败: $e');
    // 可添加重试逻辑，比如失败后延迟30秒重试
    await Future.delayed(const Duration(seconds: 30));
    await _uploadDeviceStatus();
  }
}

3. 前台定时任务 #

// 启动前台定时上报，intervalHours为间隔小时数
void startForegroundUpdate(int intervalHours) {
  Duration interval = Duration(hours: intervalHours);
  Timer.periodic(interval, (timer) async {
    await _uploadDeviceStatus();
  });
}

4. 后台定时任务配置（跨平台） #

import 'package:workmanager/workmanager.dart';

// 后台任务回调
void callbackDispatcher() {
  Workmanager().executeTask((task, inputData) async {
    await _uploadDeviceStatus();
    return Future.value(true);
  });
}

// 初始化后台定时任务
void initializeBackgroundTask(int intervalHours) {
  Workmanager().initialize(
    callbackDispatcher,
    isInDebugMode: false,
  );

  // 注册周期性任务，间隔X小时执行
  Workmanager().registerPeriodicTask(
    'device-status-update',
    'statusUpdateTask',
    frequency: Duration(hours: intervalHours),
    initialDelay: const Duration(minutes: 1), // 首次执行延迟1分钟
    constraints: const Constraints(
      networkType: NetworkType.connected, // 仅在有网络时执行
    ),
  );
}

注意事项 #

• 权限配置：
  • Android：在AndroidManifest.xml中添加RECEIVE_BOOT_COMPLETED权限，以及后台任务相关权限
  • iOS：在Info.plist中添加UIBackgroundModes，包含fetch和location（若需后台定位）
• 电量优化：避免过于频繁的上报，可根据设备电量调整上报频率；后台任务尽量轻量化，减少耗电
• 稳定性保障：添加网络请求重试逻辑，避免单次网络波动导致状态丢失
• 设备标识：确保设备唯一标识的稳定性，避免卸载重装后标识变化
• 生命周期管理：App退出前台时取消前台定时器，避免内存泄漏

内容的提问来源于stack exchange，提问作者Mahmoud Nasser