From 4a3707e31e4531eae5856dc8a63c2ae60f30cfd4 Mon Sep 17 00:00:00 2001 From: Philip Niedertscheider Date: Tue, 12 May 2026 09:29:52 +0200 Subject: [PATCH] docs(apple): Document SentrySPM and clarify CocoaPods deprecation Add SentrySPM as a documented product option on the SPM install page, explaining it compiles from source and is useful for debugging. Clarify in the CocoaPods deprecation notice that existing published versions will remain available. Co-Authored-By: Claude Opus 4.6 --- docs/platforms/apple/common/install/cocoapods.mdx | 2 +- .../apple/common/install/swift-package-manager.mdx | 7 ++++--- 2 files changed, 5 insertions(+), 4 deletions(-) diff --git a/docs/platforms/apple/common/install/cocoapods.mdx b/docs/platforms/apple/common/install/cocoapods.mdx index 7af940224c9271..7ef92d4923094f 100644 --- a/docs/platforms/apple/common/install/cocoapods.mdx +++ b/docs/platforms/apple/common/install/cocoapods.mdx @@ -5,7 +5,7 @@ sidebar_order: 2000 --- -We will stop publishing to CocoaPods at the end of June 2026. We recommend migrating to Swift Package Manager (SPM) or manually installing the [pre-built XCFramework from GitHub releases](https://github.com/getsentry/sentry-cocoa/releases). +We will stop publishing to CocoaPods at the end of June 2026. We recommend migrating to Swift Package Manager (SPM) or manually installing the [pre-built XCFramework from GitHub releases](https://github.com/getsentry/sentry-cocoa/releases). All versions published before that date will remain available on CocoaPods. To integrate Sentry into your Xcode project using CocoaPods, specify it in your _Podfile_: diff --git a/docs/platforms/apple/common/install/swift-package-manager.mdx b/docs/platforms/apple/common/install/swift-package-manager.mdx index 3279ef2b728f1f..1c8a3e4524a96e 100644 --- a/docs/platforms/apple/common/install/swift-package-manager.mdx +++ b/docs/platforms/apple/common/install/swift-package-manager.mdx @@ -11,11 +11,12 @@ 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`. +You will then be prompted to choose one of the options `Sentry`, `Sentry-Dynamic`, `SentrySwiftUI`, or `SentrySPM`. -- `Sentry` is the static framework, which is the recommended option if you prefer a fast app start time. -- `Sentry-Dynamic` is the dynamic framework. +- `Sentry` is the static pre-built framework, which is the recommended option if you prefer a fast app start time. +- `Sentry-Dynamic` is the dynamic pre-built framework. - `SentrySwiftUI` is used to track performance of SwiftUI views, see more information in the [docs](/platforms/apple/guides/ios/tracing/instrumentation/swiftui-instrumentation/). +- `SentrySPM` compiles the SDK from source as part of your project build instead of using a pre-built binary. This is useful if you want to step through SDK code while debugging. Not all product variants are available yet with this option. Xcode allows you to choose many options, but you should choose only one of the