Flutter应用性能监控插件flutter_insights的使用

Flutter应用性能监控插件flutter_insights的使用

Periculum Insight插件（Flutter） 此插件允许Flutter应用程序生成移动数据分析和可负担性分析。

平台支持

• Android

安装和使用

1. 在pubspec.yaml文件中添加插件的最新版本，并运行pub get：

dependencies:
  flutter_insights: ^0.0.2

1. 导入插件并在Flutter应用中使用：

import 'package:flutter_insights/flutter_insights.dart';

必需权限

在调用包中的方法之前，需要在AndroidManifest.xml中请求以下权限：

<uses-permission android:name="android.permission.LOCAL_MAC_ADDRESS" />
<uses-permission android:name="android.permission.READ_SMS" />
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
<uses-permission android:name="android.permission.INTERNET"/>

生成移动分析（SDK版本1）

参数表：

返回一个PericulumResponse对象：

var flutterPericulum = await FlutterInsights.generateMobileAnalysis(
  publicKey: 'publicKey',
  bvn: '1234567890123',
  phoneNumber: '090********',
);

返回类型为PericulumResponse：

{
   "insightKey":"mobileInsightKey", // 数字
   "statusCode":"statusCode",       // 数字
   "status":"status",               // 布尔值
   "message":"message"              // 字符串
}

生成移动洞察（SDK版本2）

参数表：

返回一个PericulumResponse对象：

PericulumResponse flutterPericulum = await FlutterInsights.generateMobileInsightV2(
  publicKey: 'publicKey',
  bvn: '1234567890123',
  phoneNumber: '090********',
);

更新现有的移动分析（SDK版本2）

参数表：

返回一个包含PericulumResponse的Json对象：

PericulumResponse flutterPericulum = await FlutterInsights.patchMobileAnalysisV2(
  publicKey: 'publicKey',
  overviewkey: 'overviewKey',
  bvn: '12345678908765',
  phoneNumber: '090********',
);

示例代码：

ElevatedButton(
  onPressed: () async {
    try {
      var flutterPericulum = await FlutterInsights.generateMobileInsightV2(
        publicKey: 'nucleusis123',
        bvn: '344983985053053',
        phoneNumber: '09098983930',
      );

      setState(() {
        responseOutput = flutterPericulum.toString();
      });
    } on Exception catch (e) {
      throw e.toString();
    }
  },
  child: const Text('Mobile Analysis V2'),
),

兼容性

• 最小Android SDK：Periculum需要最低API级别为21。

信息

为了使该插件正常工作，您必须拥有一个Periculum账户，并且需要使用您的Client Id和secret key从Periculum API生成一个token。详情请参阅文档。

SDK用户流程

   +-----------------------------------------------------+
   |                用户流程图                           |
   +-----------------------------------------------------+
   |                                                     |
   v                                                     |
   [1]    商户应用请求客户端设备权限                    |
   |                                                     |
   |                                                     |
   v                                                     |
   [2]    商户应用调用后端服务器生成访问令牌            |
   |                                                     |
   |                                                     |
   v                                                     |
   [3]    数据从客户设备拉取，商户应用调用SDK处理数据    |
   |                                                     |
   |                                                     |
   v                                                     |
   [4]    SDK调用Insights API生成移动洞察                |
   |                                                     |
   |                                                     |
   v                                                     |
   [End]  用户流程结束                                    |
   |                                                     |
   +-----------------------------------------------------+

开始使用

有关如何开始使用Flutter的信息，请参阅我们的在线文档，其中包含教程、示例、移动开发指南和完整的API参考。

完整示例Demo

import 'dart:developer';

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

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

class MyApp extends StatefulWidget {
  const MyApp({Key? key}) : super(key: key);

  [@override](/user/override)
  State<MyApp> createState() => _MyAppState();
}

class _MyAppState extends State<MyApp> {
  bool isLoading = false;
  String responseOutput = "";

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

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: const Text('插件示例应用'),
        ),
        body: isLoading
            ? const CircularProgressIndicator()
            : SingleChildScrollView(
                physics: const BouncingScrollPhysics(),
                child: Column(
                  mainAxisAlignment: MainAxisAlignment.center,
                  children: [
                    ElevatedButton(
                      onPressed: () async {
                        try {
                          var flutterPericulum = await FlutterInsights.generateMobileAnalysisV1(
                            publicKey: 'insert',
                            bvn: 'insert',
                            phoneNumber: 'insert',
                          );
                          setState(() {
                            responseOutput = flutterPericulum.toString();
                          });
                        } catch (e) {
                          rethrow;
                        }
                      },
                      child: const Text('移动分析V1'),
                    ),
                    ElevatedButton(
                      onPressed: () async {
                        try {
                          var flutterPericulum = await FlutterInsights.generateMobileInsightV2(
                            publicKey: 'insert',
                            bvn: 'insert',
                            phoneNumber: 'insert',
                          );

                          setState(() {
                            responseOutput = flutterPericulum.toString();
                          });
                        } on Exception catch (_) {
                          rethrow;
                        }
                      },
                      child: const Text('移动分析V2'),
                    ),
                    ElevatedButton(
                      onPressed: () async {
                        try {
                          var flutterPericulum = await FlutterInsights.patchMobileAnalysisV2(
                            publicKey: 'insert',
                            overviewkey: 'insert',
                            bvn: 'insert',
                            phoneNumber: 'insert',
                          );

                          setState(() {
                            responseOutput = flutterPericulum.toString();
                          });
                        } on Exception catch (e) {
                          log(e.toString());
                          // throw e.toString();
                        }
                      },
                      child: const Text('补丁分析V2'),
                    ),
                    Text("结果: $responseOutput"),
                  ],
                ),
              ),
      ),
    );
  }
}