Connect your Objective-C project to GlitchTip


The SDK can be installed using CocoaPods or Carthage. This is the recommended client for both Swift and Objective-C.

We recommend installing SDK with CocoaPods.

To integrate the SDK into your Xcode project using CocoaPods, specify it in your Podfile:

source ''
platform :ios, '8.0'

target 'YourApp' do
    pod 'Sentry', :git => ''

Afterwards run pod install. In case you encounter problems with dependencies and you are on a newer CocoaPods you might have to run pod repo update first.

To integrate Sentry into your Xcode project using Carthage, specify it in your Cartfile:

github "getsentry/sentry-cocoa"

Run carthage update to download the framework and drag the built Sentry.framework into your Xcode project.

We also provide a pre-built version for every release which can be downloaded at releases on GitHub.


To use the client, change your AppDelegate’s application method to instantiate the SDK:

import Sentry

func application(_ application: UIApplication,
    didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {

    // Create a client and start crash handler
    do {
        Client.shared = try Client(dsn: "your DSN here")
        try Client.shared?.startCrashHandler()
    } catch let error {

    return true

If you prefer to use Objective-C you can do so like this:

@import Sentry;

NSError *error = nil;
SentryClient *client = [[SentryClient alloc] initWithDsn:@"your DSN here" didFailWithError:&error];
SentryClient.sharedClient = client;
[SentryClient.sharedClient startCrashHandlerWithError:&error];
if (nil != error) {
    NSLog(@"%@", error);

Debug Symbols

Before you can start capturing crashes you will need to tell the SDK about the debug information by uploading dSYM files. Depending on your setup this can be done in different ways.