SuperAPI AI 工具集

sentry-android-sdk

通用与其它

查看项目

更新于 10-15 21:51

技能介绍

用途:为 Android 应用接入 Sentry SDK(io.sentry:sentry-android),用于错误监控、崩溃与 ANR 检测、原生 NDK 崩溃、性能追踪、性能分析、会话回放和结构化日志等。适用于 Kotlin/Java 的 Android 项目,包括 Jetpack Compose 应用。

主要能力:自动捕获未捕获异常、ANR 与 NDK 崩溃;追踪 Activity 生命周期、应用启动、HTTP 请求与数据库查询;会话回放记录屏幕与用户交互(需 API 26+,低版本静默不生效);性能分析支持持续 UI 性能分析或基于事务采样;通过 Sentry.logger() 写结构化日志;可接入 OkHttp、Room/SQLite、Timber、Fragment、Jetpack Navigation 等可选集成。

使用方式:先检测项目结构(Gradle DSL、版本目录 gradle/libs.versions.toml、语言、minSdk、Compose、OkHttp、Room 等),再给出建议。推荐路径是运行向导:npx @sentry/wizard@latest -i android,处理登录、组织/项目选择、Gradle 插件、依赖、DSN 与 ProGuard/R8 映射上传。也可手动配置:在版本目录或 build 文件加入 BOM 与依赖,项目级与应用级 Gradle 插件,配置 sentry {} 块(org、projectName、authToken、tracingInstrumentation、autoUploadProguardMapping、includeSourceContext),在 Application 类中调用 SentryAndroid.init(this) 设置 dsn、tracesSampleRate、profileSessionSampleRate、sessionReplay 采样与掩码、logs.isEnabled 等,并在 AndroidManifest.xml 注册 Application。不使用插件时,需手动配置 ProGuard/R8 并用 sentry-cli 上传 mapping。

限制:会话回放要求 API 26 及以上;版本与 API 以写作时文档为准(如 io.sentry:sentry-android:8.33.0、Gradle 插件 6.1.0),实施前应核对官方文档。向导需人工交互登录,代理无法代跑。采样率、组织与项目标识、DSN、authToken 等具体值需使用者自行提供。