Flutter应用分析插件app_analysis的使用

app_analysis

app_analysis 是一个Flutter插件，用于跟踪设备统计信息，包括CPU、RAM、电池和流量。

Getting Started

注意：目前仅支持Android操作系统！

安装

在 pubspec.yaml 文件中添加 app_analysis 依赖：

dependencies:
  flutter:
    sdk: flutter
  app_analysis: ^latest_version

初始化

在你的应用程序入口处初始化 AppAnalyser：

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

void main() {
  WidgetsFlutterBinding.ensureInitialized();
  AppAnalyser().initialise();
  runApp(MyApp());
}

Examples

以下是一个完整的示例，展示了如何使用 app_analysis 插件来获取和显示设备的各种统计信息。

示例代码

import 'dart:convert';
import 'dart:io';

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

void main() {
  WidgetsFlutterBinding.ensureInitialized();
  AppAnalyser().initialise();
  runApp(const App());
}

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

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'AppAnalysis Example',
      theme: ThemeData(
        primarySwatch: Colors.blue,
      ),
      home: const HomePage(),
    );
  }
}

class HomePage extends StatefulWidget {
  const HomePage({super.key});

  @override
  _HomePageState createState() => _HomePageState();
}

class _HomePageState extends State<HomePage> {
  AnalysisInfoInterface? info;
  String? cpuInfo;
  String? memInfo;
  String? btrInfo;

  String getInfoData() {
    final raw = info?.toMap() ?? {};
    const encoder = JsonEncoder.withIndent('  ');
    return encoder.convert(raw);
  }

  @override
  void initState() {
    super.initState();
  }

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: const Text('AppAnalysis Example'),
      ),
      body: ListView(
        children: [
          const SizedBox(height: 24),
          Padding(
            padding: const EdgeInsets.symmetric(horizontal: 16),
            child: ElevatedButton(
              onPressed: () => AppAnalyser().start(),
              child: const Text('Start Analysis'),
            ),
          ),
          const SizedBox(height: 16),
          Padding(
            padding: const EdgeInsets.symmetric(horizontal: 16),
            child: ElevatedButton(
              onPressed: () async {
                info = await AppAnalyser().stop();
                setState(() {});
              },
              child: const Text('Stop Analysis'),
            ),
          ),
          const SizedBox(height: 16),
          Padding(
            padding: const EdgeInsets.symmetric(horizontal: 16),
            child: ElevatedButton(
              onPressed: () async {
                final rq = await HttpClient().getUrl(
                  Uri.parse('https://dummy-json.mock.beeceptor.com/continents'),
                );
                final rs = await rq.close();
                AppAnalyser().collectTraffic(
                  HttpClientTrafficConsumptionAdapter(
                    HttpClientRequestResponse(rq.toExtended(), rs.toExtended()),
                  ),
                );
                setState(() {});
              },
              child: const Text('Make Dummy HttpClient Request'),
            ),
          ),
          const SizedBox(height: 16),
          Padding(
            padding: const EdgeInsets.symmetric(horizontal: 16),
            child: SelectableText(getInfoData()),
          ),
          const SizedBox(height: 16),
          Padding(
            padding: const EdgeInsets.symmetric(horizontal: 16),
            child: ElevatedButton(
              onPressed: () async {
                final provider = CpuInfoProvider();
                cpuInfo = 'Temp: ${await provider.temperature}\n'
                    'Avg Temp: ${await provider.averageTemperature}\n'
                    'Curr Freq: ${await provider.currentFrequency}\n'
                    'Extremum Freq: ${await provider.extremumFrequency}';
                setState(() {});
              },
              child: const Text('Get Cpu Info'),
            ),
          ),
          const SizedBox(height: 16),
          Padding(
            padding: const EdgeInsets.symmetric(horizontal: 16),
            child: SelectableText(cpuInfo ?? '-'),
          ),
          const SizedBox(height: 16),
          Padding(
            padding: const EdgeInsets.symmetric(horizontal: 16),
            child: ElevatedButton(
              onPressed: () async {
                final info = await RamInfoProvider().info;
                memInfo = 'Total: ${info.total.inMiB.toInt()}\n'
                    'Free: ${info.available.inMiB.toInt()}\n'
                    'Used: ${info.used.inMiB.toInt()}';
                setState(() {});
              },
              child: const Text('Get Memory Info'),
            ),
          ),
          const SizedBox(height: 16),
          Padding(
            padding: const EdgeInsets.symmetric(horizontal: 16),
            child: SelectableText(memInfo ?? '-'),
          ),
          Padding(
            padding: const EdgeInsets.symmetric(horizontal: 16),
            child: ElevatedButton(
              onPressed: () async {
                final temperature = await BatteryInfoProvider().temperature;
                final chargeLevel = await BatteryInfoProvider().chargeLevel;
                btrInfo = 'Temp: $temperature\n'
                    'Level: $chargeLevel';
                setState(() {});
              },
              child: const Text('Get Battery Info'),
            ),
          ),
          const SizedBox(height: 16),
          Padding(
            padding: const EdgeInsets.symmetric(horizontal: 16),
            child: SelectableText(btrInfo ?? '-'),
          ),
          const SizedBox(height: 24),
        ],
      ),
    );
  }
}

Feature Requests and Bug Reports

如果你有任何功能请求或发现任何问题，请在 GitHub Issues 中提交。

TODO

• 添加文档
• 迁移到平台无关的文件操作
• 移除对外部 battery_info 依赖，改为自定义数据提供者
• 基于分析结果在 AnalysisInfo 模型中添加有趣的数据

希望这个示例能帮助你更好地理解和使用 app_analysis 插件。如果有任何问题或建议，欢迎随时联系。