getsentry/sentry-cocoa

这是什么？

核心功能

• 01捕获 iOS、macOS、tvOS、watchOS 和 visionOS 应用中的崩溃与错误。
• 02支持通过 Swift Package Manager 或预编译 XCFramework 安装。
• 03同时提供 Swift 和 Objective-C 的初始化接口。
• 04可将 swift-log、CocoaLumberjack、Pulse、SwiftyBeaver 的日志转发到 Sentry Logs。
• 05提供 Sentry 向导命令，可自动完成项目配置。

适用场景

• 监控线上 iOS 或 macOS 应用的崩溃与错误。
• 跟踪 Apple Watch、Apple Vision Pro 等设备应用中的运行时错误。
• 将已有的 swift-log 或 CocoaLumberjack 日志集中发送到 Sentry 排查问题。

快速上手

1. 1

   运行 Sentry 向导，自动修改项目并配置 SDK

   brew install getsentry/tools/sentry-wizard && sentry-wizard -i ios
2. 2

   或者在 Xcode 中通过 File > Add Packages 使用仓库地址添加 SDK

3. 3

   尽早调用 SentrySDK.start 并传入你的 DSN，例如在 applicationDidFinishLaunching 中

使用前须知

• !已停止支持 CocoaPods，请迁移到 Swift Package Manager 或 XCFrameworks。
• !watchOS 的符号化支持有限，且不支持崩溃处理。

标签

常见问题

sentry-cocoa 是什么？

Sentry 官方 SDK，用于将 iOS、macOS、tvOS、watchOS 和 visionOS 应用的崩溃与错误上报到 Sentry。 sentry-cocoa 是 Sentry 官方提供的 Apple 平台 SDK，覆盖 iOS、iPadOS、tvOS、macOS、watchOS 和 visionOS。它负责捕获应用中的崩溃和错误，并将其发送到 Sentry，方便开发者查看堆栈信息并排查线上问题。

sentry-cocoa 可以免费使用吗？用的什么许可证？

sentry-cocoa 以 MIT 许可证开源。用于商业产品前，请先确认许可证条款。

sentry-cocoa 还在维护吗？

活跃维护中。sentry-cocoa 最近一次提交是在 2026年10月21日。

sentry-cocoa 适合用来做什么？

监控线上 iOS 或 macOS 应用的崩溃与错误。 跟踪 Apple Watch、Apple Vision Pro 等设备应用中的运行时错误。 将已有的 swift-log 或 CocoaLumberjack 日志集中发送到 Sentry 排查问题。

sentry-cocoa 怎么安装和运行？

运行 Sentry 向导，自动修改项目并配置 SDK: brew install getsentry/tools/sentry-wizard && sentry-wizard -i ios 或者在 Xcode 中通过 File > Add Packages 使用仓库地址添加 SDK 尽早调用 SentrySDK.start 并传入你的 DSN，例如在 applicationDidFinishLaunching 中

在哪里获取 sentry-cocoa？

源代码和安装说明在 GitHub 上：https://github.com/getsentry/sentry-cocoa