getsentry/sentry-cocoa

What is it?

Key features

• 01Captures crashes and errors from iOS, macOS, tvOS, watchOS and visionOS apps.
• 02Installs via Swift Package Manager or pre-built XCFrameworks.
• 03Provides both Swift and Objective-C initialization APIs.
• 04Forwards logs from swift-log, CocoaLumberjack, Pulse and SwiftyBeaver to Sentry Logs.
• 05Includes a Sentry Wizard command that configures the project automatically.

Use cases

• Monitoring crashes and errors in a production iOS or macOS app.
• Tracking runtime errors across Apple devices such as Apple Watch or Apple Vision Pro apps.
• Sending existing swift-log or CocoaLumberjack logs to Sentry for centralized debugging.

Quick start

1. 1

   Run the Sentry Wizard to patch your project and configure the SDK automatically

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

   Or add the SDK in Xcode via File > Add Packages using the repository URL

3. 3

   Call SentrySDK.start with your DSN as early as possible, such as in applicationDidFinishLaunching

Things to know

• !CocoaPods support has been dropped; migrate to Swift Package Manager or XCFrameworks.
• !watchOS has limited symbolication support and no crash handling.

Topics

FAQ

What is sentry-cocoa?

Official Sentry SDK for Apple platforms that reports crashes and errors from iOS, macOS, tvOS, watchOS and visionOS apps to Sentry. sentry-cocoa is the official Sentry SDK for Apple platforms, covering iOS, iPadOS, tvOS, macOS, watchOS and visionOS. It captures crashes and errors in an app and sends them to Sentry, where developers can inspect stack traces and diagnose production issues.

Is sentry-cocoa free to use? What license does it have?

sentry-cocoa is open source under the MIT license. Check the license terms before using it in commercial products.

Is sentry-cocoa still maintained?

Actively maintained. The last commit to sentry-cocoa was on Oct 21, 2026.

What can I use sentry-cocoa for?

Monitoring crashes and errors in a production iOS or macOS app. Tracking runtime errors across Apple devices such as Apple Watch or Apple Vision Pro apps. Sending existing swift-log or CocoaLumberjack logs to Sentry for centralized debugging.

How do I install sentry-cocoa?

Run the Sentry Wizard to patch your project and configure the SDK automatically: brew install getsentry/tools/sentry-wizard && sentry-wizard -i ios Or add the SDK in Xcode via File > Add Packages using the repository URL Call SentrySDK.start with your DSN as early as possible, such as in applicationDidFinishLaunching

Where can I get sentry-cocoa?

The source code and installation instructions are on GitHub: https://github.com/getsentry/sentry-cocoa