Swift Package Manager (SPM)

To integrate Sentry into your Xcode project using Swift Package Manager (SPM), open your App in Xcode and open File > Add Packages. Then add the SDK by entering the git repo url in the top right search field:

https://github.com/getsentry/sentry-cocoa.git

You can define your dependency rule by selecting the SDK version (or branch), and then click the "Add Package" button. You will then be prompted to choose one of the options Sentry, Sentry-Dynamic or SentrySwiftUI.

• Sentry is the static framework, which is the recommended option if you prefer a fast app start time.
• Sentry-Dynamic is the dynamic framework.
• SentrySwiftUI is used to track performance of SwiftUI views, see more information in the docs.

Alternatively, when your project uses a Package.swift file to manage dependencies, you can specify the target with:

.package(url: "https://github.com/getsentry/sentry-cocoa", from: "9.10.0"),

Building Without UIKit or AppKit

If you're building a command-line tool, a headless server app, or any other target where UIKit or AppKit isn't available, you can use the NoUIFramework package trait to strip out UI framework dependencies entirely. This requires Sentry SDK 9.7.0+, Swift 6.1+, and Xcode 26.4+. When enabled, the SDK compiles from source without linking UIKit, AppKit, or SwiftUI. UI-related features like UIViewController tracing and screenshot capture are excluded.

Xcode

1. Add the Sentry package as described above.
2. Select the SentrySPM product instead of Sentry or Sentry-Dynamic.
3. In your project settings, go to Package Dependencies, select the Sentry package, and enable the NoUIFramework trait.

Package.swift

Add the dependency with the NoUIFramework trait and depend on the SentrySPM product:

let package = Package(
    name: "MyApp",
    dependencies: [
        .package(
            url: "https://github.com/getsentry/sentry-cocoa",
            from: "9.10.0",
            traits: ["NoUIFramework"]
        ),
    ],
    targets: [
        .executableTarget(
            name: "MyApp",
            dependencies: [
                .product(name: "SentrySPM", package: "sentry-cocoa"),
            ]
        ),
    ]
)