Skip to content

docs(cocoa): Add v9 to v10 migration guide - #18940

Draft
itaybre wants to merge 1 commit into
masterfrom
itay/docs-cocoa-v9-to-v10-migration
Draft

docs(cocoa): Add v9 to v10 migration guide#18940
itaybre wants to merge 1 commit into
masterfrom
itay/docs-cocoa-v9-to-v10-migration

Conversation

@itaybre

@itaybre itaybre commented Aug 4, 2026

Copy link
Copy Markdown
Contributor

DESCRIBE YOUR PR

Add a migration guide for upgrading from Sentry Cocoa SDK 9.x to 10.x, covering all confirmed breaking changes:

  • Minimum OS version bumps (macOS 12.0, watchOS 9.0)
  • SPM target renames (SentrySPM -> Sentry, Sentry -> Sentry-Static)
  • Pre-built binaries moved to sentry-apple-binaries repo
  • SentrySwiftUI module removal
  • sendDefaultPii replaced by granular dataCollection options
  • SentrySDK ObjC changes (now Swift enum, use SentryObjCSDK)
  • Removed deprecated APIs (feedback widget, onCrashedLastRun, etc.)
  • Behavioral changes (SentryRequest.cookies type, CPU normalization)

Only includes confirmed/merged changes and items on the v10 branch. Open issues (frames tracking opt-in, Breadcrumb.data read-only, SentryDebugMeta rename, enableSigtermReporting removal) are excluded and can be added later.

Related: getsentry/sentry-cocoa#8487, getsentry/sentry-cocoa#8623

IS YOUR CHANGE URGENT?

Help us prioritize incoming PRs by letting us know when the change needs to go live.

  • Urgent deadline (GA date, etc.):
  • Other deadline:
  • None: Not urgent, can wait up to 1 week+

SLA

  • Teamwork makes the dream work, so please add a reviewer to your PRs.
  • Please give the docs team up to 1 week to review your PR unless you've added an urgent due date to it.
    Thanks in advance for your help!

PRE-MERGE CHECKLIST

Make sure you've checked the following before merging your changes:

  • Checked Vercel preview for correctness, including links
  • PR was reviewed and approved by any necessary SMEs (subject matter experts)
  • PR was reviewed and approved by a member of the Sentry docs team

Cover confirmed breaking changes: minimum OS bumps, SPM target renames,
pre-built binaries moved to sentry-apple-binaries, SentrySwiftUI removal,
sendDefaultPii replaced by dataCollection, SentrySDK ObjC changes,
removed deprecated APIs, and behavioral changes.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@vercel

vercel Bot commented Aug 4, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
sentry-docs Ready Ready Preview Aug 4, 2026 9:12pm
1 Skipped Deployment
Project Deployment Actions Updated (UTC)
develop-docs Ignored Ignored Aug 4, 2026 9:12pm

Request Review

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant