Skip to content

docs(apple): Remove CocoaPods as supported install method #18600

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Draft
philprime wants to merge 1 commit into
base: master
Choose a base branch
from
+5 −45
Draft

docs(apple): Remove CocoaPods as supported install method #18600

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
23 changes: 5 additions & 18 deletions docs/platforms/apple/common/install/cocoapods.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,24 +1,11 @@
---
title: CocoaPods (Deprecated)
description: "Learn about installing the Sentry SDK with CocoaPods."
title: CocoaPods (No Longer Supported)
description: "CocoaPods is no longer a supported installation method for the Sentry Apple SDK."
sidebar_order: 2000
---

<Alert level="warning" title="Deprecated">
We will stop publishing to CocoaPods at the end of June 2026. We recommend migrating to <PlatformLink to="/install/swift-package-manager/">Swift Package Manager (SPM)</PlatformLink> 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.
</Alert>

To integrate Sentry into your Xcode project using CocoaPods, specify it in your _Podfile_:

```ruby
platform :ios, '11.0'
use_frameworks! # This is required
<Alert level="warning" title="No Longer Supported">

target 'YourApp' do
pod 'Sentry', :git => 'https://github.com/getsentry/sentry-cocoa.git', :tag => '{{@inject packages.version('sentry.cocoa') }}'
end
```
We no longer publish to CocoaPods. Please migrate to <PlatformLink to="/install/swift-package-manager/">Swift Package Manager (SPM)</PlatformLink> or manually install the [pre-built XCFramework from GitHub releases](https://github.com/getsentry/sentry-cocoa/releases). All versions published before July 2026 remain available on CocoaPods.

Afterwards run `pod install`.

If you're using Xcode 14 or later, your project might fail to build due to `error: Sandbox: rsync.samba(42924)`. To resolve this you have to disable the "Enable User Script Sandbox" option in the target settings by setting it to `NO`. See <PlatformLink to="/troubleshooting#sandbox-error-using-cocoapods">Troubleshooting</PlatformLink> for more information.
</Alert>
27 changes: 0 additions & 27 deletions docs/platforms/apple/common/troubleshooting/index.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -155,33 +155,6 @@ If the release health page shows fewer events in the unhandled tab, your events

We introduced a bug with a refactoring [#4101](https://github.com/getsentry/sentry-cocoa/pull/4101) released in 8.30.1, that caused unhandled/crash events to have the unhandled property and mach info missing, which is required for release health to show events in the unhandled tab. It's essential to mention that this bug doesn't impact release health statistics, such as crash-free session or user rates.

## Sandbox Error Using Cocoapods

<Alert level="warning" title="Deprecated">
We will stop publishing to CocoaPods at the end of June 2026. We recommend migrating to <PlatformLink to="/install/swift-package-manager/">Swift Package Manager (SPM)</PlatformLink> or manually installing the [pre-built XCFramework from GitHub releases](https://github.com/getsentry/sentry-cocoa/releases).
</Alert>

After setting up Cocoapods using a `Podfile` and running `pod install` to set up the project, you might see the following error when building the target:

```
error: Sandbox: rsync.samba(42924) deny(1) file-read-data <path/to/your/app>/Frameworks/Sentry.framework/Sentry.bundle (in target 'test' from project 'test')
error: Sandbox: rsync.samba(42925) deny(1) file-read-data <path/to/your/app>/Frameworks/Sentry.framework/_CodeSignature/CodeResources (in target 'test' from project 'test')
error: Sandbox: rsync.samba(42925) deny(1) file-write-create <path/to/your/app>/Frameworks/Sentry.framework/_CodeSignature/.CodeResources.a2sA9v (in target 'test' from project 'test')
mkdir -p <path/to/your/app>/Frameworks
rsync --delete -av --filter P .*.?????? --links --filter "- CVS/" --filter "- .svn/" --filter "- .git/" --filter "- .hg/" --filter "- Headers" --filter "- PrivateHeaders" --filter "- Modules" "<path/to/derived/data>/Sentry/Sentry.framework" "<path/to/your/app>/Frameworks"
building file list ... done
rsync: opendir "<path/to/your/app>/Frameworks/Sentry.framework/Sentry.bundle" failed: Operation not permitted (1)
IO error encountered -- skipping file deletion
Sentry.framework/_CodeSignature/CodeResources
rsync: mkstemp "<path/to/your/app>/Frameworks/Sentry.framework/_CodeSignature/.CodeResources.a2sA9v" failed: Operation not permitted (1)

sent 15034 bytes received 42 bytes 30152.00 bytes/sec
total size is 4950281 speedup is 328.36
rsync error: some files could not be transferred (code 23) at /AppleInternal/Library/BuildRoots/5bb93434-bef0-11ef-bef2-d285688f7a47/Library/Caches/com.apple.xbs/Sources/rsync/rsync/main.c(996) [sender=2.6.9]
```

While it seems to be related to Sentry, it is actually caused by the user script sandbox feature introduced in [Xcode 14](https://developer.apple.com/documentation/xcode-release-notes/xcode-14-release-notes), which is enabled by default. In order to fix this, you need to head to the target settings of your project and set the "Enable User Script Sandbox" option to `NO`.

## 'required' initializer 'init(from:)' must be provided by subclass

Since Cocoa SDK version [8.45.0](https://github.com/getsentry/sentry-cocoa/blob/main/CHANGELOG.md#8450) and above,
Expand Down
Loading