Repository navigation
docs(kmp): Update Kotlin Multiplatform docs for 0.28.0 - #19857
Conversation
Document the 0.28.0 changes: Sentry Cocoa is installed through SwiftPM (official Kotlin SwiftPM import or spm4Kmp) instead of CocoaPods, Apple deployment minimums are raised, watchosArm32 becomes a no-op target, and new trace continuation options are available. Co-Authored-By: Claude <noreply@anthropic.com> Co-authored-by: Cursor <cursoragent@cursor.com>
|
The latest updates on your projects. Learn more about Vercel for GitHub.
1 Skipped Deployment
|
|
The plan checks client errors on the changed guide pages, pageload latency, and HTTP status on those URLs. An issue escalates when those pages throw new errors or when pageload latency rises above the measured band. Monitoring in Services: Mention PlanWhat changedReaders of the Kotlin Multiplatform guides now see SwiftPM as the Apple install path. The pages document SDK 0.28.0 options, Apple OS floors, and CocoaPods migration. The Compose Multiplatform getting-started install include matches that copy. This change is live after RiskA broken MDX include or PlatformLink can fail those pages at runtime. The Gradle plugin page added large code samples and alerts. Those can throw in the code-tab UI. Removed CocoaPods sections can strand readers who still use CocoaPods. That install failure happens off this site. Sibling Kotlin Multiplatform pages share the same layout. A render break can hit them too. Intended effectTelemetry cannot confirm the new SwiftPM copy or the 0.28.0 options. This is a docs edit. Page loads only show that the routes still resolve. They do not show the new text. Record intended effect as unknown unless someone inspects the live HTML. Absent would look like the live Gradle and getting-started pages still teaching CocoaPods as the primary Apple install path. Regression watchFilter by The prior 7d window had 36 events titled
If the error rate rises, inspect code tabs and PlatformLink markup on the Gradle plugin page first. Not observableThe live HTML that would prove SwiftPM replaced CocoaPods. Reader install success after they follow the new steps. Pageload volume on the Gradle plugin and manual-setup pages is too low to baseline. LCP is not sliced by these URLs. Compose Multiplatform traffic was 3 navigations and 0 pageloads in the 24h window, so latency there is not usable. Get Slack DMs about this change: cursor.com/automations/rollouts |
There was a problem hiding this comment.
🟡 Changes recommended
Installation and trace-continuation guidance still misstates required configuration and native SDK behavior.
2 open findings
What changed in this PR
Updates Kotlin and Compose Multiplatform documentation for SDK 0.28.0 and its transition to Sentry Cocoa 9.
Changes:
- Replaces CocoaPods installation guidance with SwiftPM workflows and migration instructions.
- Updates Apple platform requirements and supported targets.
- Documents new tracing options and Apple user-feedback behavior.
| File | Description |
|---|---|
| platform-includes/getting-started-install/kotlin.kotlin-multiplatform.mdx | Updates KMP installation guidance. |
| platform-includes/getting-started-install/kotlin.compose-multiplatform.mdx | Updates Compose installation guidance. |
| docs/platforms/kotlin/guides/kotlin-multiplatform/user-feedback/index.mdx | Explains separate Apple feedback events. |
| docs/platforms/kotlin/guides/kotlin-multiplatform/native-access-sdk.mdx | Removes the CocoaPods export example. |
| docs/platforms/kotlin/guides/kotlin-multiplatform/manual-setup/index.mdx | Introduces manual SwiftPM setup. |
| docs/platforms/kotlin/guides/kotlin-multiplatform/features/index.mdx | Updates Apple requirements and watchOS support. |
| docs/platforms/kotlin/guides/kotlin-multiplatform/configuration/options.mdx | Adds tracing configuration options. |
| docs/platforms/kotlin/guides/kotlin-multiplatform/configuration/gradle.mdx | Documents Apple providers, linker settings, and migration. |
🧠 Review effort: Balanced
Give feedback about Copilot approvals in this survey to enter a drawing for a $150 gift card.
itaybre
left a comment
itaybre
left a comment
There was a problem hiding this comment.
LGTM with a small question
Clarify that strictTraceContinuation still continues a trace when both organization IDs are missing, and that the option has no effect on Apple. Tell readers who added Sentry Cocoa in Xcode to set the Apple provider to NONE so the plugin doesn't install it twice. Co-Authored-By: Claude <noreply@anthropic.com> Co-authored-by: Cursor <cursoragent@cursor.com>
![sentry[bot]](https://avatars.githubusercontent.com/in/12637?s=60&v=4){kind=small}
Co-Authored-By: Claude <noreply@anthropic.com> Co-authored-by: Cursor <cursoragent@cursor.com>
Co-Authored-By: Claude <noreply@anthropic.com> Co-authored-by: Cursor <cursoragent@cursor.com>
|
Verified in
|
DESCRIBE YOUR PR
Updates the Kotlin Multiplatform docs for SDK 0.28.0 (changelog: getsentry/sentry-kotlin-multiplatform#586).
0.28.0 moves to Sentry Cocoa 9, which drops CocoaPods support. The install, Gradle plugin, manual setup, and native access pages now use SwiftPM (official Kotlin SwiftPM import or spm4Kmp) instead of CocoaPods. The Gradle plugin page adds a CocoaPods migration section. Other changes:
watchosArm32is now a no-op targetenablePropagateTraceparent,strictTraceContinuation,orgIdPlease merge only after 0.28.0 is released, since the install snippets inject the latest released plugin version.
IS YOUR CHANGE URGENT?
PRE-MERGE CHECKLIST