SuperAPI AI 工具集

build-sentry-macos-swift

通用与其它

查看项目

更新于 10-16 06:16

技能介绍

用途:为原生 macOS 或 Swift 应用接入或审计 Sentry(sentry-cocoa)崩溃上报,包括崩溃、未捕获 NSException、卡顿、追踪、结构化日志、发布健康,以及 dSYM 上传与符号化、隐私脱敏。

主要能力与流程:技能按四阶段推进。第一阶段探查仓库,记录依赖管理方式(SPM、Package.swift、CocoaPods)、应用生命周期(SwiftUI App 或 AppKit AppDelegate)、是否沙盒、分发方式(App Store、公证 DMG、Sparkle)、是否有 CI、已有日志(os.Logger 等)、是否有配套后端、数据敏感度,共八项信号,先出事实清单再动安装。第二阶段按 macOS 支持矩阵取舍功能:原生 macOS 可用崩溃、未捕获 NSException(需开启)、v1 卡顿、网络/文件/Core Data 追踪、性能剖析、MetricKit、结构化日志、发布健康、面包屑/作用域/tags、反馈 API;而看门狗/OOM、Session Replay、截图、视图层级、点击面包屑、UIViewController/启动与 TTID-TTFD 插桩、反馈组件 UI 均不可用。第三阶段深度集成,按安装、初始化、崩溃与卡顿、隐私底线、深度信号、追踪与发布六层自上而下推进,每层先编译再继续。第四阶段以运行时证据验证:脱离调试器触发测试事件与真实崩溃、确认符号化、审计载荷无 PII。

必要用法与命令:使用 SPM 添加 sentry-cocoa 产品,在主线程最早时机执行 SentrySDK.start,配置 enableUncaughtNSExceptionReporting = true,设置 sendDefaultPii = false 并用 beforeSend/beforeBreadcrumb 脱敏;dSYM 上传使用 sentry-cli(资料提及作者写作时基于 9.21.0 / sentry-cli 3.6.0,需自行核对当前版本)。注意 SDK 9.0.0 移除了 profilesSampleRate、integrations、enableTracing,应改用 configureProfiling、enable* 标志和 tracesSampleRate。DSN 可嵌入,而 SENTRY_AUTH_TOKEN 属机密,需置于 gitignore 的 .sentryclirc 或环境变量。

适用场景:为 Mac 应用添加错误监控、审计加固既有 Sentry 配置、解决 macOS 崩溃符号化问题、按需添加追踪或日志。

限制:iOS/iPadOS 优先的 UIKit 项目、非 Apple 的 Sentry SDK(JS、Python、Go)以及仅排查线上问题不宜使用;能否获取官方参考文档、具体收费与价格暂未提供。