# 下载 SDK 核心文件到项目 libs 目录 mkdir -p app/src/main/java/io/crashsight/sdk curl -o app/src/main/java/io/crashsight/sdk/CrashSight.java \ /sdk/android/src/main/java/io/crashsight/sdk/CrashSight.java curl -o app/src/main/java/io/crashsight/sdk/CrashSightConfig.java \ /sdk/android/src/main/java/io/crashsight/sdk/CrashSightConfig.java curl -o app/src/main/java/io/crashsight/sdk/CrashEvent.java \ /sdk/android/src/main/java/io/crashsight/sdk/CrashEvent.java curl -o app/src/main/java/io/crashsight/sdk/Breadcrumb.java \ /sdk/android/src/main/java/io/crashsight/sdk/Breadcrumb.java curl -o app/src/main/java/io/crashsight/sdk/CrashReporter.java \ /sdk/android/src/main/java/io/crashsight/sdk/CrashReporter.java curl -o app/src/main/java/io/crashsight/sdk/CrashUncaughtExceptionHandler.java \ /sdk/android/src/main/java/io/crashsight/sdk/CrashUncaughtExceptionHandler.java curl -o app/src/main/java/io/crashsight/sdk/AnrMonitor.java \ /sdk/android/src/main/java/io/crashsight/sdk/AnrMonitor.java curl -o app/src/main/java/io/crashsight/sdk/HeartbeatScheduler.java \ /sdk/android/src/main/java/io/crashsight/sdk/HeartbeatScheduler.java curl -o app/src/main/java/io/crashsight/sdk/PackageInfoHelper.java \ /sdk/android/src/main/java/io/crashsight/sdk/PackageInfoHelper.java curl -o app/src/main/java/io/crashsight/sdk/NetworkMonitor.java \ /sdk/android/src/main/java/io/crashsight/sdk/NetworkMonitor.java

public class MyApplication extends Application { @Override public void onCreate() { super.onCreate(); CrashSight.init( this, "" ); } }

// 上报自定义异常 CrashSight.reportException(exception); // 设置用户 ID CrashSight.setUserId("uid_12345"); // 添加自定义键值 CrashSight.putCustomInfo( "scene", "checkout" );

// 在网络请求回调中记录面包屑（适用于任何 HTTP 客户端） NetworkMonitor.onRequest("GET", url); NetworkMonitor.onResponse("GET", url, statusCode); NetworkMonitor.onError("GET", url, "TimeoutException");

# 下载 SDK 文件到项目目录 mkdir -p CrashSightSDK/Sources curl -o CrashSightSDK/CrashSight.swift \ /sdk/ios/Sources/CrashSightSDK/CrashSight.swift curl -o CrashSightSDK/CrashSightConfig.swift \ /sdk/ios/Sources/CrashSightSDK/CrashSightConfig.swift curl -o CrashSightSDK/CrashEvent.swift \ /sdk/ios/Sources/CrashSightSDK/CrashEvent.swift curl -o CrashSightSDK/CrashReporter.swift \ /sdk/ios/Sources/CrashSightSDK/CrashReporter.swift # 将 CrashSightSDK 目录拖入 Xcode 项目

import CrashSightSDK @UIApplicationMain class AppDelegate: UIResponder { func application(_ application: UIApplication, didFinishLaunchingWithOptions...) { CrashSight.start(appKey: "") return true } }

// AppDelegate.m @import CrashSightSDK; [CrashSight startWithAppKey:@""]; // 上报自定义异常 [CrashSight reportException:exception];

# 上传 dSYM 文件（Xcode Build Phase） ./CrashSightSymbolTool \ --appkey \ --dsym ${DWARF_DSYM_FOLDER_PATH} \ --version ${MARKETING_VERSION}

<script src="/sdk/web/crashsight.min.js"></script> <script> CrashSight.init({ appKey: '' }) </script>

# 下载 SDK 文件到项目 curl -o ./src/lib/crashsight.esm.js \ /sdk/web/crashsight.esm.js import CrashSight from './lib/crashsight.esm.js' CrashSight.init({ appKey: '', captureUnhandledRejections: true, captureConsoleErrors: true, })

// 上报错误 CrashSight.captureException(new Error('支付失败')) // 设置用户 CrashSight.setUserId('uid_12345') // 自定义信息 CrashSight.putCustomInfo('scene', 'checkout') // 添加面包屑 CrashSight.addBreadcrumb('点击支付')

# 下载类型声明文件 curl -o ./src/lib/crashsight.d.ts \ /sdk/web/crashsight.d.ts // 在 tsconfig.json 中配置 // compilerOptions.types 可自动识别

# 下载到小程序 utils 目录 curl -o ./utils/crashsight-miniapp.js \ /sdk/miniapp/crashsight-miniapp.js

const CrashSight = require('./utils/crashsight-miniapp') App(CrashSight.wrapApp({ onLaunch() { CrashSight.init({ appKey: '', platform: 'weapp' }) } }))

# 下载到项目 utils 目录 mkdir -p src/lib curl -o src/lib/crashsight-rn.js \ /sdk/react-native/src/index.js # 下载类型声明 curl -o src/lib/crashsight-rn.d.ts \ /sdk/react-native/src/index.d.ts

import { CrashSight } from './lib/crashsight-rn' CrashSight.init({ appKey: '', enableJSErrorHandler: true, enablePromiseRejection: true, })

// 上报 JS 异常 CrashSight.captureException( new Error('支付模块异常') ) // 设置用户标识 CrashSight.setUserId('uid_12345') // 附加自定义信息 CrashSight.putCustomInfo('scene', 'checkout')

// Android: MainApplication.java CrashSight.init(this, "YOUR_APP_KEY"); // iOS: AppDelegate.swift CrashSight.start(appKey: "YOUR_APP_KEY") // JS 侧自动捕获 ErrorUtils // + Promise rejection 全局监听

# 下载 Dart 文件到项目 lib 目录 mkdir -p lib/crashsight curl -o lib/crashsight/crashsight_flutter.dart \ /sdk/flutter/lib/crashsight_flutter.dart

import './crashsight/crashsight_flutter.dart'; void main() { CrashSight.init( appKey: '', enableDartError: true, enableFlutterError: true, ); runApp(MyApp()); }

// 捕获 Dart 异常 CrashSight.captureException( exception, stackTrace ) // 设置用户 CrashSight.setUserId('uid_12345') // 自定义信息 CrashSight.putCustomInfo('level', 'boss')

// 自动捕获 FlutterError // 自动捕获 runZonedGuarded 异常 // 手动 Zone 包装 runZonedGuarded(() { runApp(MyApp()); }, (error, stack) { CrashSight.captureException(error, stack); });