Flutter未知功能插件glance的使用

Flutter未知功能插件glance的使用

插件介绍

glance 是一个用于检测Flutter中UI卡顿的APM库，适用于Android和iOS设备。它可以帮助开发者收集堆栈跟踪信息，以便定位导致性能问题的具体函数，从而有效地解决问题。

使用指南

开始UI卡顿检测

为了接收UI卡顿信息，需要实现自己的报告器（JankDetectedReporter）。一旦获得卡顿信息，可以将其保存到文件中，或上传到服务器，并使用 flutter symbolize 命令进行符号化处理。

// 实现自定义的 `JankDetectedReporter`
class MyJankDetectedReporter extends JankDetectedReporter {
  [@override](/user/override)
  void report(JankReport info) {
    final stackTrace = info.stackTrace.toString();
    // 保存堆栈跟踪到文件，或上传到服务器，并使用 `flutter symbolize` 命令进行符号化处理。
  }
}

void main() {
  // 确保 `GlanceWidgetBinding` 初始化
  GlanceWidgetBinding.ensureInitialized();
  // 启动UI卡顿检测
  Glance.instance.start(config: GlanceConfiguration(reporters: [MyJankDetectedReporter()]));

  runApp(const MyApp());
}

自动符号化

一些工具，如Firebase和Sentry，可以在你上传符号时自动符号化堆栈跟踪。这在没有自托管服务器的情况下非常有用。更多详情请参阅：

• Firebase: https://firebase.google.com/docs/crashlytics/get-deobfuscated-reports?platform=flutter
• Sentry: https://docs.sentry.io/platforms/flutter/upload-debug/

示例代码

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

import 'package:flutter/foundation.dart';
import 'package:flutter/material.dart';
import 'package:flutter/services.dart';
import 'package:glance/glance.dart';
import 'package:path_provider/path_provider.dart';
import 'package:path/path.dart' as path;
import 'package:permission_handler/permission_handler.dart';

class MyJankDetectedReporter extends JankDetectedReporter {
  [@override](/user/override)
  void report(JankReport info) {
    compute((msg) async {
      final token = (msg as List)[0];
      final info = (msg)[1];
      BackgroundIsolateBinaryMessenger.ensureInitialized(token!);

      late Directory? docDir;
      if (defaultTargetPlatform == TargetPlatform.iOS) {
        docDir = await getApplicationDocumentsDirectory();
      } else {
        docDir = await getExternalStorageDirectory();
      }
      final stacktraceFilePath = path.join(
        docDir!.absolute.path,
        'jank_trace',
        'jank_trace_${DateTime.now().microsecondsSinceEpoch}.txt',
      );
      // 我们希望在非调试模式下打印日志
      // ignore: avoid_print
      print('[MyJankDetectedReporter] stacktraceFilePath: $stacktraceFilePath');
      final file = File(stacktraceFilePath);
      file.createSync(recursive: true);
      File(stacktraceFilePath).writeAsStringSync(
        info.stackTrace.toString(),
        flush: true,
      );
    }, [RootIsolateToken.instance, info]);
  }
}

void main() {
  GlanceWidgetBinding.ensureInitialized();
  FlutterError.onError = (details {
    FlutterError.presentError(details);
    // ignore: avoid_print
    print('FlutterError.onError:\n${details.toString()}');
  };
  PlatformDispatcher.instance.onError = (error, stack {
    // ignore: avoid_print
    print('PlatformDispatcher.instance.onError:\n$error\n$stack');
    return true;
  };

  _startGlance();
  runApp(const MyApp());
}

Future<void> _startGlance() async {
  Glance.instance.start(
    config: GlanceConfiguration(
      reporters: [MyJankDetectedReporter()],
    ),
  );

  await Permission.storage.request();
}

class MyApp extends StatelessWidget {
  // ignore: use_super_parameters
  const MyApp({Key? key}) : super(key: key);

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      showPerformanceOverlay: true,
      title: 'Flutter Demo',
      theme: ThemeData(
        primarySwatch: Colors.blue,
      ),
      home: const MyHomePage(title: 'Flutter Demo Home Page'),
    );
  }
}

class MyHomePage extends StatefulWidget {
  // ignore: use_super_parameters
  const MyHomePage({Key? key, required this.title}) : super(key: key);

  final String title;

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

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

  void _expensiveCall() {
    final watch = Stopwatch();
    watch.start();
    for (int i = 0; i < 1000; ++i) {
      jsonEncode({
        for (int i = 0; i < 10000; ++i) 'aaa': 0,
      });
    }
    watch.stop();
    // ignore: avoid_print
    print('[_expensiveCall] spent: ${watch.elapsedMilliseconds}');
  }

  void _incrementCounter() {
    _expensiveCall();
    setState(() {
      _counter++;
    });
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text(widget.title),
      ),
      body: Center(
        child: Column(
          mainAxisAlignment: MainAxisAlignment.center,
          children: [
            const Text(
              'You have pushed the button this many times:',
            ),
            Text('$_counter'),
          ],
        ),
      ),
      floatingActionButton: FloatingActionButton(
        onPressed: _incrementCounter,
        tooltip: 'Increment',
        child: const Icon(Icons.add),
      ),
    );
  }
}