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

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

官方SDK

这是官方的ShipBook SDK用于Flutter。ShipBook可以让你远程收集、搜索和分析用户的日志和异常，并在云端进行用户和会话级别的分析。

关于ShipBook

ShipBook可以让你远程收集、搜索和分析用户的日志和异常，并在云端进行用户和会话级别的分析。

资源

• Shipbook文档

作者

Elisha Sterngold（ShipBook Ltd.）

许可证

ShipBookSDK 可供使用MIT许可证。更多详情请查看LICENSE文件。

示例代码

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

// 获取日志记录器实例
final log = Shipbook.getLogger("main");

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

  // 启用内部日志记录
  Shipbook.enableInnerLog(true);

  // 初始化ShipBook，传入应用ID和应用密钥
  Shipbook.start("appId", "appKey");
}

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

  [@override](/user/override)
  // ignore: library_private_types_in_public_api
  _RegisterButtonState createState() => _RegisterButtonState();
}

class _RegisterButtonState extends State<RegisterButton> {
  bool isUserRegistered = false;
  int counter = 0;

  [@override](/user/override)
  Widget build(BuildContext context) {
    return TextButton(
      onPressed: () {
        setState(() {
          if (isUserRegistered) {
            Shipbook.logout(); // 注销当前用户
            isUserRegistered = false;
          } else {
            isUserRegistered = true;
            Shipbook.registerUser('test$counter', fullName: 'Test User $counter', email: 'test$counter@test.com'); // 注册新用户
            counter++;
          }
        });
      },
      child: Text(!isUserRegistered ? '注册用户 [test$counter]' : '从ShipBook注销'),
    );
  }
}

class ScreenButton extends StatelessWidget {
  const ScreenButton({super.key, required this.screenName});

  final String screenName;

  [@override](/user/override)
  Widget build(BuildContext context) {
    return TextButton(
      onPressed: () {
        Shipbook.screen(screenName); // 设置当前屏幕名称
      },
      child: Text('设置屏幕为 $screenName'),
    );
  }
}

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

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Flutter Demo',
      theme: ThemeData(
        colorScheme: ColorScheme.fromSeed(seedColor: Colors.deepPurple),
        useMaterial3: true,
      ),
      home: const MyHomePage(title: 'Flutter Demo Home Page'),
    );
  }
}

class MyHomePage extends StatefulWidget {
  const MyHomePage({super.key, required this.title});

  final String title;

  [@override](/user/override)
  State<MyHomePage> createState() => _MyHomePageState();
}

class _MyHomePageState extends State<MyHomePage> {
  int _counter = 0;

  void _incrementCounter() {
    log.i('正在增加计数器 $_counter'); // 记录日志信息
    log.d('计数器增加到 $_counter'); // 记录详细日志信息
    setState(() {
      _counter++;
    });
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        backgroundColor: Theme.of(context).colorScheme.inversePrimary,
        title: Text(widget.title),
      ),
      body: Center(
        child: Column(
          mainAxisAlignment: MainAxisAlignment.center,
          children: [
            const RegisterButton(),
            const ScreenButton(screenName: 'Home'),
            const Text(
              '你已经按了按钮这么多次：',
            ),
            Text(
              '$_counter',
              style: Theme.of(context).textTheme.headlineMedium,
            ),
          ],
        ),
      ),
      floatingActionButton: FloatingActionButton(
        onPressed: _incrementCounter,
        tooltip: '增加',
        child: const Icon(Icons.add),
      ),
    );
  }
}