用途：为 iOS/Swift 项目配置 Sentry iOS SDK（sentry-cocoa），适用于 Swift 与 SwiftUI 应用的错误监控、崩溃报告、追踪、会话回放、结构化日志与性能分析。
主要能力：通过 SentrySDK.start 初始化 DSN、环境、调试开关、截图与视图层级附加；配置 tracesSampleRate 追踪、configureProfiling 性能分析、sessionReplay 会话回放采样与 errorSample 采样，以及 enableLogs 结构化日志。日志支持 trace/debug/info/warn/error/fatal 级别、属性与字符串插值，并可用 beforeSendLog 过滤。会话回放默认遮挡全部文本、图片和输入，可用 .sentryReplayMask() / .sentryReplayUnmask() 修饰符或 maskedViewClasses / unmaskedViewClasses 控制。追踪会自动instrument应用启动、URLSession、UI 转场、文件 I/O、Core Data 与卡顿，也支持 SentrySDK.span 自定义 span。可设置用户上下文、手动捕获错误并附加标签与额外数据。
使用方式：先检测是否 iOS/Swift 项目（检查 .xcodeproj、.xcworkspace、Package.swift 及已有 sentry-cocoa 引用）。SDK 通过 Swift Package Manager（Package.swift 依赖 from: "9.0.0" 或 Xcode 添加包）或 CocoaPods（pod 'Sentry', '~> 9.0' 后 pod install）安装。最低要求 iOS 13.0+、Xcode 15.0+、Swift 5.0+，SDK 9.0.0+（当前稳定 9.3.0）。在 SwiftUI 的 @main 或 UIKit 的 AppDelegate 中初始化。生产环境建议降低采样率并关闭 debug。验证可发送测试消息与日志，在 Sentry 的 Issues、Performance、Replays、Logs 中查看。
限制：结构化日志需 SDK 8.55.0+，追踪、分析、会话回放需 8.0.0+；未提供具体收费或定价信息。常见问题包括事件未出现（检查 DSN、网络、等待处理）、回放未录制（检查采样率与遮挡）、span 缺失（检查采样率与 finish）、日志缺失（检查 enableLogs 与版本）、CocoaPods 安装失败（更新仓库或清理重装）。