Flutter堆叠布局插件allstack_flutter的使用

AllStack Flutter SDK 是一款功能强大的堆叠布局插件，专为 Flutter 应用开发设计。它支持 Android、iOS、Web 和桌面平台，并提供了丰富的功能来帮助开发者更好地管理和监控应用的运行状态。

🎉 版本发布

🎉 Version 1.0.0 已正式发布！
我们很高兴地宣布 AllStack Flutter SDK 的第一个稳定版本。这款插件旨在为 Flutter 应用提供一个健壮且易于使用的错误跟踪和监控解决方案。

🚀 主要功能

异常跟踪

• 自动捕获并报告运行时异常。
• 包括详细的错误上下文，如堆栈跟踪、设备详情和操作系统信息。

设备和应用上下文

• 收集设备特定的数据，如平台、操作系统版本和屏幕尺寸。
• 记录应用特定的详细信息，包括应用版本、构建号和包名。

HTTP 请求监控

• 跟踪和记录 HTTP 请求的详细信息，如请求头、查询参数和响应时间。
• 与流行的 HTTP 库（如 http 和 dio）无缝集成。

速率限制

• 使用内置的速率限制器防止过度报告。
• 通过控制错误报告频率，避免使监控系统不堪重负。

Flutter 集成

• 专为 Flutter 应用设计的简单设置。
• 支持 Android、iOS、Web 和桌面平台。

自定义选项

• 配置开发、测试或生产环境。
• 将自定义字段（如用户 ID、会话 ID 或发布版本）附加到错误日志中。

📦 安装

在您的项目中添加 AllStack Flutter SDK，请将其包含在 pubspec.yaml 文件中：

dependencies:
  allstack_flutter: ^1.0.0

然后运行以下命令以安装依赖项：

flutter pub get

示例代码

以下是一个完整的示例，展示如何使用 AllStack Flutter 插件进行堆叠布局和错误监控。

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

void main() {
  // 初始化 AllStack 插件
  AllStack.init(
    apiKey: "your_api_key_here", // 替换为您的 API 密钥
    environment: Environment.production, // 设置当前环境
  );

  runApp(MyApp());
}

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

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

class _StackExampleState extends State<StackExample> {
  int _counter = 0;

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

    // 模拟异常
    if (_counter == 5) {
      throw Exception("模拟异常：计数器达到 5");
    }

    // 记录事件
    AllStack.logEvent("Counter Incremented", {"count": _counter});
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text("AllStack Flutter 示例"),
      ),
      body: Center(
        child: Column(
          mainAxisAlignment: MainAxisAlignment.center,
          children: <Widget>[
            Text(
              '你已经点击按钮 $_counter 次:',
            ),
            ElevatedButton(
              onPressed: _incrementCounter,
              child: Text('点击我'),
            ),
          ],
        ),
      ),
    );
  }
}