Flutter应用使用统计插件usage_stats_new的功能

Flutter应用使用统计插件usage_stats_new的功能

简介

usage_stats 是一个用于查询 Android 使用统计数据的 Flutter 插件，包括配置、事件和应用程序使用情况。它允许开发者获取设备上应用程序的使用历史、网络流量统计等信息。需要注意的是，该插件仅适用于 API 级别 22 及以上版本的 Android 设备。

安装

要在 Flutter 项目中使用 usage_stats 插件，首先需要在 pubspec.yaml 文件中添加依赖：

dependencies:
  usage_stats: ^最新版本号

Android 配置

为了使用 usage_stats 插件，你需要在 AndroidManifest.xml 文件中添加以下权限：

<uses-permission
    android:name="android.permission.PACKAGE_USAGE_STATS"
    tools:ignore="ProtectedPermissions" />

使用方法

以下是一个完整的示例代码，展示了如何使用 usage_stats 插件来查询应用程序的使用统计信息，并将其显示在 Flutter 应用中。

import 'package:flutter/material.dart';
import 'dart:async';
import 'package:usage_stats/usage_stats.dart';

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

class MyApp extends StatefulWidget {
  [@override](/user/override)
  _MyAppState createState() => _MyAppState();
}

class _MyAppState extends State<MyApp> {
  List<EventUsageInfo> events = [];
  Map<String?, NetworkInfo?> _netInfoMap = {};

  [@override](/user/override)
  void initState() {
    super.initState();
    initUsage();
  }

  Future<void> initUsage() async {
    try {
      // 请求使用权限
      UsageStats.grantUsagePermission();

      // 设置查询的时间范围
      DateTime endDate = DateTime.now();
      DateTime startDate = endDate.subtract(Duration(days: 1));

      // 查询事件
      List<EventUsageInfo> queryEvents =
          await UsageStats.queryEvents(startDate, endDate);

      // 查询网络使用统计
      List<NetworkInfo> networkInfos = await UsageStats.queryNetworkUsageStats(
        startDate,
        endDate,
        networkType: NetworkType.all,
      );

      // 将网络信息映射到包名
      Map<String?, NetworkInfo?> netInfoMap = Map.fromIterable(
        networkInfos,
        key: (v) => v.packageName,
        value: (v) => v,
      );

      // 查询应用程序使用统计
      List<UsageInfo> usageStats =
          await UsageStats.queryUsageStats(startDate, endDate);

      // 打印每个应用程序的详细使用信息
      for (var info in usageStats) {
        if (double.parse(info.totalTimeInForeground!) > 0) {
          print(
              "First Time: ${DateTime.fromMillisecondsSinceEpoch(int.parse(info.firstTimeStamp!)).toIso8601String()}");
          print(
              "Last Time: ${DateTime.fromMillisecondsSinceEpoch(int.parse(info.lastTimeStamp!)).toIso8601String()}");
          print("Package Name: ${info.packageName}");
          print(
              "Last Used: ${DateTime.fromMillisecondsSinceEpoch(int.parse(info.lastTimeUsed!)).toIso8601String()}");
          print("Total Time In Foreground: ${int.parse(info.totalTimeInForeground!) / 1000 / 60} minutes");
          print('-----\n');
        }
      }

      // 更新 UI
      setState(() {
        events = queryEvents.reversed.toList();
        _netInfoMap = netInfoMap;
      });
    } catch (err) {
      print("Error: $err");
    }
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: const Text("Usage Stats"),
          actions: [
            IconButton(
              onPressed: UsageStats.grantUsagePermission,
              icon: Icon(Icons.settings),
            )
          ],
        ),
        body: Container(
          child: RefreshIndicator(
            onRefresh: initUsage,
            child: ListView.separated(
              itemBuilder: (context, index) {
                var event = events[index];
                var networkInfo = _netInfoMap[event.packageName];
                return ListTile(
                  title: Text(event.packageName!),
                  subtitle: Column(
                    crossAxisAlignment: CrossAxisAlignment.start,
                    children: [
                      Text(
                          "Last time used: ${DateTime.fromMillisecondsSinceEpoch(int.parse(event.timeStamp!)).toIso8601String()}"),
                      networkInfo == null
                          ? Text("Unknown network usage")
                          : Text(
                              "Received bytes: ${networkInfo.rxTotalBytes}\nTransfered bytes: ${networkInfo.txTotalBytes}"),
                    ],
                  ),
                  trailing: Text(event.eventType!),
                );
              },
              separatorBuilder: (context, index) => Divider(),
              itemCount: events.length,
            ),
          ),
        ),
      ),
    );
  }
}