Flutter SDK（Dart）快速开始

Flutter 端 SDK。v0.5 为 Dart-only 实现（无 native 时降级路径），与 Web SDK 平齐范围： init / log / identify / flush，外加手动异常 helper captureFlutterError。

对应 SDK：sdks/flutter · 设计：docs/07-design/sdk-flutter.md

添加依赖

在 pubspec.yaml 加 argus_flutter（计划发布到 pub.dev；v0.5 可用 git / path 依赖）。要求 Flutter 3.16+。

初始化（main）


import 'package:argus_flutter/argus_flutter.dart';
 
Future<void> main() async {
  WidgetsFlutterBinding.ensureInitialized();
 
  await Argus.init(ArgusConfig(
    dsn: 'argus://demo-public:demo-secret@localhost:4318/demo',
  ));
 
  runApp(const MyApp());
}

上报


// 日志
Argus.log('Payment failed', level: Level.error);
 
// 用户
Argus.identify('user-123', traits: {'plan': 'pro'});
 
// 退后台 / 关键节点 flush
await Argus.flush();

异常捕获（手动）

v0.5 SDK 不自动注册 FlutterError.onError / runZonedGuarded（与 Sentry Flutter 行业惯例一致），改为暴露手动 helper，让你在 main() 显式接：


void main() {
  FlutterError.onError = (FlutterErrorDetails details) {
    Argus.captureFlutterError(details); // 显式上报到 Argus
    FlutterError.presentError(details);
  };
 
  // ... Argus.init + runApp
}

v0.5 范围：本期实施与 Web SDK 平齐（init / log / identify / flush + captureFlutterError）。Argus.track(...)（埋点）、MethodChannel 与 iOS/Android native plugin 推迟到 v1（依赖 iOS / Android SDK 同步实施）。

接入后

在 Console /logs 看日志、/issues 看异常聚合。