watchOS

Features:

• Multiple types of errors are captured, including:
  • Mach exceptions
  • Fatal signals
  • Unhandled exceptions
  • C++ exceptions
  • Objective-C exceptions
  • Main thread deadlock (experimental)
  • Out of memory
• Events enriched with device data
• Offline caching when a device is unable to connect; we send a report once we receive another event
• Breadcrumbs automatically captured for
  • Application lifecycle events (didBecomeActive, didEnterBackground, viewDidAppear)
  • Touch events
  • System events (battery level or state changed, memory warnings, device orientation changed, keyboard did show and did hide, screenshot taken)
• Release Health tracks crash free users and sessions
• Attachments enrich your event by storing additional files, such as config or log files
• User Feedback provides the abiity to collect user information when an event occurs

The minimum version for watchOS is 2.0. Our SDK has limited symbolication support and no crash handling for watchOS.

We recommend installing the SDK with CocoaPods. To integrate Sentry into your Xcode project, specify it in your Podfile:

platform :watchos, '2.0'
use_frameworks! # This is important

target 'YourApp' do
  pod 'Sentry', :git => 'https://github.com/getsentry/sentry-cocoa.git', :tag => '7.1.3'
end

Then run pod install.

We also support alternate installation methods.

You should also initialize the SDK as soon as possible, such as in your AppDelegate application:didFinishLaunchingWithOptions method:

import Sentry // Make sure you import Sentry

// ....

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

    SentrySDK.start { options in
        options.dsn = "https://examplePublicKey@o0.ingest.sentry.io/0"
        options.debug = true // Enabled debug when first installing is always helpful
    }

    return true
}

Provide Debug Information

Before capturing crashes, you need to provide debug information to Sentry. Debug information is provided by uploading dSYM files using one of two methods, dependent on your setup:

• With Bitcode
• Without Bitcode

import Sentry

SentrySDK.crash()

Crash Handling

Our SDK hooks into all signal and exception handlers, except for MacOS. If you are using MacOS, please follow the additional steps documented in Capturing Uncaught Exceptions in macOS.

To try it out, the SDK provides a test crash function:

import Sentry

SentrySDK.crash()

Crashes are submitted only upon re-launch of the application. If you crash with a debugger attached, nothing will happen. To view the crash in Sentry, close your app and re-launch it.