Flutter安卓使用统计插件android_usage_stats的使用

在 Flutter 中使用 android_usage_stats 插件可以帮助你获取 Android 设备上的应用使用统计信息。以下是如何在 Flutter 项目中使用 android_usage_stats 插件的步骤：

1. 添加依赖

首先，你需要在 pubspec.yaml 文件中添加 android_usage_stats 插件的依赖：

dependencies:
  flutter:
    sdk: flutter
  android_usage_stats: ^1.0.0

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

2. 获取使用统计权限

在 Android 设备上获取应用使用统计信息需要 android.permission.PACKAGE_USAGE_STATS 权限。你需要在 AndroidManifest.xml 文件中添加以下权限：

<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    package="com.example.your_package_name">

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

    <application
        android:label="Your App Name"
        android:icon="@mipmap/ic_launcher">
        <!-- Your other configurations -->
    </application>
</manifest>

3. 请求权限

在 Flutter 中，你需要请求用户授予 PACKAGE_USAGE_STATS 权限。你可以使用以下代码来请求权限：

import 'package:android_usage_stats/android_usage_stats.dart';

void requestUsageStatsPermission() async {
  bool hasPermission = await AndroidUsageStats.checkUsageStatsPermission();
  if (!hasPermission) {
    AndroidUsageStats.requestUsageStatsPermission();
  }
}

4. 获取使用统计信息

你可以使用 AndroidUsageStats 插件来获取应用的使用统计信息。以下是一个简单的示例，展示如何获取过去一天的应用使用情况：

import 'package:android_usage_stats/android_usage_stats.dart';

void getUsageStats() async {
  DateTime endDate = DateTime.now();
  DateTime startDate = endDate.subtract(Duration(days: 1));

  List<UsageStatsInfo> usageStats = await AndroidUsageStats.queryUsageStats(
    startDate: startDate,
    endDate: endDate,
  );

  for (var stats in usageStats) {
    print('Package Name: ${stats.packageName}');
    print('Last Time Used: ${stats.lastTimeUsed}');
    print('Total Time In Foreground: ${stats.totalTimeInForeground}');
    print('-----------------------------');
  }
}

5. 处理返回的数据

UsageStatsInfo 对象包含了应用的使用统计信息，包括包名、最后使用时间、前台总时间等。你可以根据这些数据进行处理或展示。

6. 注意事项

• android.permission.PACKAGE_USAGE_STATS 是一个特殊权限，无法通过运行时权限请求直接获取。用户需要在系统设置中手动授予该权限。
• android_usage_stats 插件仅适用于 Android 平台，因此在 iOS 上无法使用。

7. 完整示例

以下是一个完整的示例，展示了如何在 Flutter 中请求权限并获取应用使用统计信息：

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

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

class MyApp extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: UsageStatsScreen(),
    );
  }
}

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

class _UsageStatsScreenState extends State<UsageStatsScreen> {
  List<UsageStatsInfo> usageStats = [];

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

  void requestUsageStatsPermission() async {
    bool hasPermission = await AndroidUsageStats.checkUsageStatsPermission();
    if (!hasPermission) {
      AndroidUsageStats.requestUsageStatsPermission();
    } else {
      getUsageStats();
    }
  }

  void getUsageStats() async {
    DateTime endDate = DateTime.now();
    DateTime startDate = endDate.subtract(Duration(days: 1));

    List<UsageStatsInfo> stats = await AndroidUsageStats.queryUsageStats(
      startDate: startDate,
      endDate: endDate,
    );

    setState(() {
      usageStats = stats;
    });
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('Usage Stats'),
      ),
      body: ListView.builder(
        itemCount: usageStats.length,
        itemBuilder: (context, index) {
          var stats = usageStats[index];
          return ListTile(
            title: Text(stats.packageName),
            subtitle: Text('Last Used: ${stats.lastTimeUsed}'),
            trailing: Text('Foreground: ${stats.totalTimeInForeground} ms'),
          );
        },
      ),
    );
  }
}