SuperAPI AI 工具集

sentry-cocoa-sdk

部署与运维

查看项目

更新于 10-15 21:51

技能介绍

用途:为 Apple 平台应用接入 Sentry Cocoa SDK,覆盖错误监控、追踪、性能分析、会话重放、日志与指标等。该技能先扫描项目,判断是否已存在 Sentry 依赖、使用 SwiftUI 还是 UIKit、目标平台与部署版本、现有日志库及是否有配套后端,再给出具体建议并逐步引导配置。

主要能力:错误监控(崩溃、App 挂起、看门狗终止、NSError/Swift 错误);追踪(自动埋点应用启动、网络、UIViewController、文件 I/O、Core Data);性能分析(iOS/macOS);会话重放;结构化日志;指标(Swift,SDK 9.12+);用户反馈。Cocoa 不支持 Crons 与 AI Monitoring。

安装方式:推荐官方向导 brew install getsentry/tools/sentry-wizard && sentry-wizard -i ios(需在终端交互执行)。也可用 Swift Package Manager,包地址为 https://github.com/getsentry/sentry-cocoa ,from 9.15.0,按目标仅选一个产品:Sentry(推荐)、Sentry-Dynamic、SentrySwiftUI(已弃用)、Sentry-WithoutUIKitOrAppKit;Swift 6.1+ 可用 traits: ["NoUIFramework"] 配合 SentrySPM 编译时移除 UIKit/AppKit/SwiftUI 链接。CocoaPods 已被弃用,计划 2026 年 6 月底停止发布,仅用于已有项目。纯 Objective-C/C++ 且不能启用 Clang modules 时可用 SentryObjC,需将头文件与类型前缀改为 SentryObjC。

初始化:在主线程调用 SentrySDK.start,至少设置 dsn、environment,按平台取舍各选项。常用字段包括 enableCrashHandler、enableAppHangTracking、enableWatchdogTerminationTracking、attachScreenshot、attachViewHierarchy、sendDefaultPii、tracesSampleRate、configureProfiling、sessionReplay 采样率、enableLogs、enableMetrics 等。生产环境应降低采样率,如 tracesSampleRate = 0.2。

限制:部分功能按平台不同(watchOS 无崩溃报告与追踪,tvOS/watchOS/visionOS 无性能分析,会话重放在 tvOS 未官方支持,macOS 无看门狗终止与启动追踪)。文档以 sentry-cocoa 9.15.0 为准,实施前应核对官方文档。iOS/tvOS/watchOS/visionOS 需显式设置 DSN、release 与环境变量,不可依赖自动回退。