feat: Add SentrySPM compile-from-source product and multi-platform sample apps by philprime · Pull Request #7430 · getsentry/sentry-cocoa

philprime · 2026-02-11T09:57:44Z

Summary

Adds a new SentrySPM SPM product that compiles Sentry directly from source via a thin Swift wrapper module (Sources/SentrySPM/) using @_exported import, so consumers only need import SentrySPM
Restructures the compile-from-source targets: renames SentryObjc to SentryObjCInternal (reserving SentryObjC for a future public wrapper), adds extensive inline documentation in Package.swift
Adds SwiftUI sample apps for all supported platforms (iOS, watchOS, tvOS, macOS, visionOS) using SentrySPM with XcodeGen specs, Makefile build targets, and CI workflow integration

Architecture

SentryHeaders      → public ObjC headers (Sources/Sentry/Public/)
_SentryPrivate     → internal ObjC headers (Sources/Sentry/include/)
SentrySwift        → all Swift source (Sources/Swift/)
SentryObjCInternal → all ObjC/C source (Sources/Sentry/, Sources/SentryCrash/)
SentrySPM          → thin re-export wrapper (@_exported import of ObjC + Swift)

Test plan

CI builds all five platform sample apps (iOS, watchOS, tvOS, macOS, visionOS) via build-sample-spm matrix job
Verify make build-sample-iOS-SwiftUI-SPM succeeds locally
Verify existing SPM/xcframework products are unaffected
Verify import SentrySPM provides access to both ObjC types (SentrySDK, Breadcrumb) and Swift types (.sentryTrace())

#skip-changelog

Closes #7431

…mple apps Add a new "SentrySPM" SPM product that allows consumers to compile Sentry directly from source, as an alternative to the pre-built xcframework binary targets. The product uses a thin Swift wrapper module (Sources/SentrySPM/) that re-exports both the ObjC and Swift modules via @_exported import, so consumers only need `import SentrySPM`. Architecture: - SentryHeaders: public ObjC headers - _SentryPrivate: internal ObjC headers - SentrySwift: all Swift source - SentryObjCInternal: all ObjC/C source (renamed from SentryObjc) - SentrySPM: thin re-export wrapper Also adds SwiftUI sample apps for all supported platforms (iOS, watchOS, tvOS, macOS, visionOS) that use the SentrySPM product with XcodeGen, along with Makefile build targets and CI workflow integration.

github-actions · 2026-02-11T09:58:05Z

Semver Impact of This PR

🟡 Minor (new features)

📋 Changelog Preview

This is how your changes will appear in the changelog.
Entries from this PR are highlighted with a left border (blockquote style).

This PR will not appear in the changelog.

_{🤖 This preview updates automatically when you update the PR.}

github-actions · 2026-02-11T09:58:12Z

	Messages
📖	Do not forget to update Sentry-docs with your feature once the pull request gets approved.

Generated by 🚫 dangerJS against 822836d

codecov · 2026-02-11T10:04:16Z

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 85.321%. Comparing base (b9e1a29) to head (822836d).
✅ All tests successful. No failed tests found.

Additional details and impacted files

@@              Coverage Diff              @@
##              main     #7430       +/-   ##
=============================================
+ Coverage   85.301%   85.321%   +0.020%     
=============================================
  Files          480       480               
  Lines        28621     28620        -1     
  Branches     12383     12385        +2     
=============================================
+ Hits         24414     24419        +5     
+ Misses        4157      4154        -3     
+ Partials        50        47        -3

see 7 files with indirect coverage changes

Continue to review full report in Codecov by Sentry.

Legend - Click here to learn more
Δ = absolute <relative> (impact), ø = not affected, ? = missing data
Powered by Codecov. Last update b9e1a29...822836d. Read the comment docs.

philprime · 2026-02-11T10:07:49Z

See techprimate/Flinky#92 for additional real-world sample

- Override IOS_SIMULATOR_OS=latest and IOS_DEVICE_NAME for the build-sample-spm CI job since macos-26 runners have Xcode 26.x simulators, not 18.4/iPhone 16 Pro - Update prepare-package.sh to keep SentrySPM product in the products array when --remove-binary-targets is used, so the existing Samples/SPM project can resolve its SentrySPM dependency during workspace builds

github-actions · 2026-02-11T10:46:22Z

Performance metrics 🚀

	Plain	With Sentry	Diff
Startup time	1228.68 ms	1259.87 ms	31.19 ms
Size	24.14 KiB	1.11 MiB	1.09 MiB

Baseline results on branch: main

Startup times

Revision	Plain	With Sentry	Diff
`79e2bb8`	1216.37 ms	1242.42 ms	26.05 ms
`a180235`	1222.87 ms	1255.10 ms	32.23 ms
`4b41eee`	1209.96 ms	1243.12 ms	33.16 ms
`3bff9ff`	1217.72 ms	1246.43 ms	28.71 ms
`24ac927`	1218.04 ms	1242.02 ms	23.98 ms
`870ddae`	1224.24 ms	1249.45 ms	25.21 ms
`79cee27`	1214.65 ms	1238.66 ms	24.01 ms
`0e4b033`	1203.74 ms	1249.71 ms	45.97 ms
`47c9f79`	1216.57 ms	1240.94 ms	24.37 ms
`c796e6d`	1226.33 ms	1247.33 ms	21.00 ms

App size

Revision	Plain	With Sentry	Diff
`79e2bb8`	24.14 KiB	1.04 MiB	1.02 MiB
`a180235`	24.14 KiB	1.11 MiB	1.09 MiB
`4b41eee`	24.14 KiB	1.09 MiB	1.07 MiB
`3bff9ff`	24.14 KiB	1.11 MiB	1.09 MiB
`24ac927`	24.14 KiB	1.06 MiB	1.04 MiB
`870ddae`	24.14 KiB	1.10 MiB	1.08 MiB
`79cee27`	24.14 KiB	1.10 MiB	1.08 MiB
`0e4b033`	24.14 KiB	1.11 MiB	1.09 MiB
`47c9f79`	24.14 KiB	1.09 MiB	1.06 MiB
`c796e6d`	24.14 KiB	1.11 MiB	1.09 MiB

Previous results on branch: philprime/spm-sample

Startup times

Revision	Plain	With Sentry	Diff
`7c06d0a`	1188.40 ms	1210.33 ms	21.94 ms
`becdd0e`	1228.96 ms	1257.13 ms	28.17 ms
`4a23cfb`	1226.64 ms	1252.13 ms	25.50 ms

App size

Revision	Plain	With Sentry	Diff
`7c06d0a`	24.14 KiB	1.11 MiB	1.09 MiB
`becdd0e`	24.14 KiB	1.11 MiB	1.09 MiB
`4a23cfb`	24.14 KiB	1.11 MiB	1.09 MiB

Package.swift

Sources/SentrySPM/SentrySPM.swift

Package.swift

cursor

Cursor Bugbot has reviewed your changes and found 2 potential issues.

^{Bugbot Autofix is OFF. To automatically fix reported issues with Cloud Agents, enable Autofix in the Cursor dashboard.}

scripts/prepare-package.sh

Package.swift

philprime requested review from itaybre, noahsmartin and philipphofmann as code owners February 11, 2026 09:57

github-actions bot mentioned this pull request Feb 11, 2026

feat: Add SentrySPM compile-from-source product and multi-platform sample apps #7431

Open

4 tasks

philprime mentioned this pull request Feb 11, 2026

Research state of support for SPM from source #7303

Closed

4 tasks

philprime self-assigned this Feb 11, 2026

philprime added the ready-to-merge Use this label to trigger all PR workflows label Feb 11, 2026

philprime mentioned this pull request Feb 11, 2026

feat: Switch from Sentry xcframework to SentrySPM compile-from-source techprimate/Flinky#92

Merged

4 tasks

noahsmartin reviewed Feb 11, 2026

View reviewed changes

Package.swift Show resolved Hide resolved

noahsmartin reviewed Feb 11, 2026

View reviewed changes

Sources/SentrySPM/SentrySPM.swift Outdated Show resolved Hide resolved

itaybre reviewed Feb 11, 2026

View reviewed changes

Package.swift Outdated Show resolved Hide resolved

Package.swift Outdated Show resolved Hide resolved

philprime added 2 commits February 12, 2026 11:30

replace sentryspm with sentryswift

66e3293

fix in build.yml

2727d6a

philprime requested review from itaybre and noahsmartin February 12, 2026 10:41

philprime enabled auto-merge (squash) February 12, 2026 10:42

philprime mentioned this pull request Feb 12, 2026

feat: Add iOS-ObjectiveCpp-NoModules sample reproducing #4543 #7433

Open

3 tasks

cursor bot reviewed Feb 12, 2026

View reviewed changes

scripts/prepare-package.sh Show resolved Hide resolved

Package.swift Outdated Show resolved Hide resolved

philprime added 2 commits February 12, 2026 12:57

cleanup

b4748ff

Merge remote-tracking branch 'origin/main' into philprime/spm-sample

822836d

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

feat: Add SentrySPM compile-from-source product and multi-platform sample apps#7430

feat: Add SentrySPM compile-from-source product and multi-platform sample apps#7430
philprime wants to merge 6 commits intomainfrom
philprime/spm-sample

philprime commented Feb 11, 2026 •

edited

Loading

Uh oh!

github-actions bot commented Feb 11, 2026 •

edited

Loading

Uh oh!

github-actions bot commented Feb 11, 2026 •

edited

Loading

Uh oh!

codecov bot commented Feb 11, 2026 •

edited

Loading

Uh oh!

philprime commented Feb 11, 2026

Uh oh!

github-actions bot commented Feb 11, 2026 •

edited

Loading

Baseline results on branch: main

Startup times

App size

Previous results on branch: philprime/spm-sample

Startup times

App size

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

cursor bot left a comment

Uh oh!

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

Uh oh!

Conversation

philprime commented Feb 11, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Summary

Architecture

Test plan

Uh oh!

github-actions bot commented Feb 11, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Semver Impact of This PR

Uh oh!

github-actions bot commented Feb 11, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

codecov bot commented Feb 11, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Codecov Report

Uh oh!

philprime commented Feb 11, 2026

Uh oh!

github-actions bot commented Feb 11, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Performance metrics 🚀

Baseline results on branch: main

Startup times

App size

Previous results on branch: philprime/spm-sample

Startup times

App size

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

cursor bot left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

philprime commented Feb 11, 2026 •

edited

Loading

github-actions bot commented Feb 11, 2026 •

edited

Loading

github-actions bot commented Feb 11, 2026 •

edited

Loading

codecov bot commented Feb 11, 2026 •

edited

Loading

github-actions bot commented Feb 11, 2026 •

edited

Loading