Flutter 日志与崩溃采集 SDK

下载并添加依赖

下载 SDK 源码包解压到你的项目旁边，在 pubspec.yaml 中添加本地依赖：

dependencies:
  log_sdk:
    path: ../log_sdk

在 main() 中初始化

import 'package:log_sdk/log_sdk.dart';

void main() {
  LogSDK.runGuarded(() async {
    WidgetsFlutterBinding.ensureInitialized();

    await LogSDK.instance.init(const LogConfig(
      appId: 'your-app-id',       // 在管理后台创建App后获取
      appSecret: 'your-app-secret',
      serverUrl: 'https://app-data.tensnuk.com',
      environment: LogEnv.prod,
    ));

    // 建议尽早设置(比如App启动时/用户登录成功后)，之后上报的事件都会自动带上
    LogSDK.instance.setUuid('your-business-device-uuid');  // 业务方自己的设备/安装UUID
    LogSDK.instance.setUid('1000123');                     // 业务方内部数字用户ID
    LogSDK.instance.setUserId('user@example.com');         // 用户名/邮箱等可读标识(可选)

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

上报日志 / 埋点 / 异常

调用下面的方法只是把数据写入本地队列，SDK 会在后台自动定时（默认15秒）批量上传， 崩溃/致命异常会额外触发一次立即上传；不需要手动处理网络请求。

// 日志
LogSDK.instance.i('Network', 'request success');

// 行为埋点
LogSDK.instance.trackEvent('button_click', params: {'btn_id': 'submit'});
LogSDK.instance.trackPage('HomePage');

// 手动上报异常(比如 try/catch 里捕获的业务异常)
try {
  await doSomething();
} catch (e, st) {
  LogSDK.instance.reportException(e, st);
}

// 如果想立刻看到效果(比如联调测试)，可以强制触发一次上传：
await LogSDK.instance.flush();