_Bad software is everywhere, and we're tired of it. Sentry is on a mission to help developers write better software faster, so we can get back to enjoying technology. If you want to join us [**Check out our open positions**](https://sentry.io/careers/)_
> [!NOTE]
> You are currently viewing the **`v8.x`** branch which contains the latest **v8** release.
>
> For the upcoming **v9** release, please switch to the [`main` branch](https://github.com/getsentry/sentry-cocoa/tree/main) and refer to the [v9 CHANGELOG](https://github.com/getsentry/sentry-cocoa/blob/main/CHANGELOG.md).
# Official Sentry SDK for iOS / tvOS / macOS / watchOS (1)
[](https://github.com/getsentry/sentry-cocoa/actions/workflows/build.yml?query=branch%3Amain)
[](https://codecov.io/gh/getsentry/sentry-cocoa)
[](https://cocoapods.org/pods/Sentry)
[](https://github.com/Carthage/Carthage)
[](https://swift.org/package-manager)
[](https://swiftpackageindex.com/getsentry/sentry-cocoa)
[](https://discord.com/invite/sentry)
# Installation
SPM is the recommended way to include Sentry into your project, but we also support [CocoaPods](https://cocoapods.org/pods/Sentry) and Carthage, and provide pre-built XCFrameworks on [our GitHub Releases page](https://github.com/getsentry/sentry-cocoa/releases).
# Initialization
_Remember to call this as early in your application life cycle as possible_
Ideally in `applicationDidFinishLaunching` in `AppDelegate`
```swift
import Sentry
// ....
SentrySDK.start { options in
options.dsn = "___PUBLIC_DSN___"
options.debug = true // Helpful to see what's going on
}
```
```objc
@import Sentry;
// ....
[SentrySDK startWithConfigureOptions:^(SentryOptions *options) {
options.dsn = @"___PUBLIC_DSN___";
options.debug = @YES; // Helpful to see what's going on
}];
```
For more information checkout the [docs](https://docs.sentry.io/platforms/apple).
(1)limited symbolication support and no crash handling.
# Blog posts
[Mobile Vitals - Four Metrics Every Mobile Developer Should Care About](https://blog.sentry.io/2021/08/23/mobile-vitals-four-metrics-every-mobile-developer-should-care-about/).
[How to use Sentry Attachments with Mobile Applications](https://blog.sentry.io/2021/02/03/how-to-use-sentry-attachments-with-mobile-applications/?utm_source=github&utm_medium=readme&utm_campaign=sentry-cocoa).
[Close the Loop with User Feedback](https://blog.sentry.io/2021/02/16/close-the-loop-with-user-feedback/?utm_source=github&utm_medium=readme&utm_campaign=sentry-cocoa).
[A Sanity Listicle for Mobile Developers](https://blog.sentry.io/2021/03/30/a-sanity-listicle-for-mobile-developers/?utm_source=github&utm_medium=readme&utm_campaign=sentry-cocoa).
# Resources
- [](https://docs.sentry.io/platforms/apple/)
- [](https://github.com/getsentry/sentry-cocoa/discussions)
- [](https://discord.com/invite/sentry)
- [](http://stackoverflow.com/questions/tagged/sentry)
- [](https://github.com/getsentry/.github/blob/master/CODE_OF_CONDUCT.md)
- [](https://twitter.com/intent/follow?screen_name=getsentry)
