feat(objc): Add SentryObjC wrapper SDK

.github/file-filters.yml

@@ -77,11 +77,13 @@ run_api_stability_for_prs: &run_api_stability_for_prs
   - "scripts/build-xcframework-slice.sh"
   - "scripts/assemble-xcframework.sh"
   - "scripts/update-api.sh"
+  - "scripts/extract-objc-api.sh"
   - "scripts/ci-diagnostics.sh"
 
   # API files
   - "sdk_api.json"
   - "sdk_api_sentryswiftui.json"
+  - "sdk_api_objc.json"
 
   # Build configuration
   - "Makefile"
@@ -271,6 +273,7 @@ run_release_for_prs: &run_release_for_prs
   - ".github/workflows/release-comment-issues.yml"
   - ".github/workflows/build-xcframework-variant-slices.yml"
   - ".github/workflows/assemble-xcframework-variant.yml"
+  - ".github/workflows/assemble-xcframework-sentryobjc.yml"
   - ".github/workflows/ui-tests-common.yml"
   - ".github/workflows/fast-pr-checks.yml"
   - ".github/file-filters.yml"
@@ -285,6 +288,8 @@ run_release_for_prs: &run_release_for_prs
   - "scripts/build-xcframework-slice.sh"
   - "scripts/build-xcframework-local.sh"
   - "scripts/assemble-xcframework.sh"
+  - "scripts/build-xcframework-sentryobjc-standalone.sh"
+  - "scripts/ci-arrange-xcframework-slices.sh"
   - "scripts/generate_release_matrix.sh"
   - "scripts/xcframework-generated-run.sh"
   - "scripts/prepare-package.sh"

.github/workflows/api-stability.yml

@@ -48,6 +48,7 @@ jobs:
         run: |
           mv sdk_api.json sdk_api_base.json
           mv sdk_api_sentryswiftui.json sdk_api_sentryswiftui_base.json
+          mv sdk_api_objc.json sdk_api_objc_base.json
           ./scripts/update-api.sh
 
       - name: Diagnose breaking changes for Sentry
@@ -56,7 +57,7 @@ jobs:
           if diff -q "sdk_api_base.json" "sdk_api.json" > /dev/null; then
             echo "No Sentry API changes detected."
           else
-            echo "❌ Sentry public API changes are detected. If they're intended run "make generate-public-api" and commit the changes."
+            echo "❌ Sentry public API changes are detected. If they're intended run 'make generate-public-api' and commit the changes."
             diff "sdk_api_base.json" "sdk_api.json" || true
             xcrun --sdk iphoneos swift-api-digester \
               -diagnose-sdk \
@@ -75,7 +76,7 @@ jobs:
           if diff -q "sdk_api_sentryswiftui_base.json" "sdk_api_sentryswiftui.json" > /dev/null; then
             echo "No SentrySwiftUI API changes detected."
           else
-            echo "❌ SentrySwiftUI public API changes are detected. If they're intended run "make generate-public-api" and commit the changes."
+            echo "❌ SentrySwiftUI public API changes are detected. If they're intended run 'make generate-public-api' and commit the changes."
             diff "sdk_api_sentryswiftui_base.json" "sdk_api_sentryswiftui.json" || true
             xcrun --sdk iphoneos swift-api-digester \
               -diagnose-sdk \
@@ -87,6 +88,18 @@ jobs:
             cat sentryswiftui_result.json
             exit 1
           fi
+
+      - name: Diagnose breaking changes for SentryObjC
+        if: always()
+        run: |
+          if diff -q "sdk_api_objc_base.json" "sdk_api_objc.json" > /dev/null; then
+            echo "No SentryObjC API changes detected."
+          else
+            echo "❌ SentryObjC public API changes are detected. If they're intended run 'make generate-public-api' and commit the changes."
+            diff "sdk_api_objc_base.json" "sdk_api_objc.json" || true
+            exit 1
+          fi
+
       - name: Run CI Diagnostics
         uses: ./.github/actions/ci-diagnostics
         if: failure()

.github/workflows/assemble-xcframework-sentryobjc.yml

@@ -0,0 +1,136 @@
+name: Assemble SentryObjC XCFramework
+
+on:
+  workflow_call:
+    inputs:
+      sdks:
+        description: |-
+          Comma-separated list of SDK slices to assemble.
+        required: false
+        type: string
+        default: "iphoneos,iphonesimulator,macosx,maccatalyst,appletvos,appletvsimulator,watchos,watchsimulator,xros,xrsimulator"
+
+      signed:
+        description: |-
+          Whether or not the assembled XCFramework should be signed.
+        required: false
+        type: boolean
+        default: false
+
+      release-version:
+        description: |-
+          For release workflows, the version to inject into the SDK.
+        required: false
+        type: string
+
+jobs:
+  assemble-xcframework-sentryobjc:
+    name: SentryObjC
+    runs-on: macos-15
+    steps:
+      - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
+      - uses: ./.github/actions/setup-xcode
+        with:
+          version: "16.4"
+
+      - name: Setup Ruby
+        uses: ruby/setup-ruby@4eb9f110bac952a8b68ecf92e3b5c7a987594ba6 # v1.292.0
+        if: ${{ inputs.signed }}
+        with:
+          bundler-cache: true
+
+      - name: "Download Fastlane Certificate"
+        if: ${{ inputs.signed }}
+        run: bundle exec fastlane prepare_xcframework_signing
+        env:
+          FASTLANE_KEYCHAIN_PASSWORD: ${{ secrets.FASTLANE_KEYCHAIN_PASSWORD }}
+          MATCH_GIT_PRIVATE_KEY: ${{ secrets.MATCH_GIT_PRIVATE_KEY }}
+          MATCH_PASSWORD: ${{ secrets.MATCH_PASSWORD }}
+          MATCH_USERNAME: ${{ secrets.MATCH_USERNAME }}
+
+      # Download all four sets of static library slices.
+      # Each artifact contains a {sdk}.xcarchive.zip for one platform.
+      - name: Download Sentry static slices
+        uses: actions/download-artifact@3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c # v8
+        with:
+          pattern: xcframework-sentry-static-slice-*
+          path: xcframework-slices/sentry-static
+
+      - name: Download SentryObjCTypes slices
+        uses: actions/download-artifact@3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c # v8
+        with:
+          pattern: xcframework-sentryobjc-types-slice-*
+          path: xcframework-slices/sentryobjc-types
+
+      - name: Download SentryObjCBridge slices
+        uses: actions/download-artifact@3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c # v8
+        with:
+          pattern: xcframework-sentryobjc-bridge-slice-*
+          path: xcframework-slices/sentryobjc-bridge
+
+      - name: Download SentryObjC slices
+        uses: actions/download-artifact@3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c # v8
+        with:
+          pattern: xcframework-sentryobjc-objc-slice-*
+          path: xcframework-slices/sentryobjc-objc
+
+      # Unzip slices into the directory layout expected by
+      # build-xcframework-sentryobjc-standalone.sh:
+      #   XCFrameworkBuildPath/archive/Sentry/{sdk}.xcarchive/...
+      #   XCFrameworkBuildPath/archive/SentryObjCTypes/{sdk}.xcarchive/...
+      #   XCFrameworkBuildPath/archive/SentryObjCBridge/{sdk}.xcarchive/...
+      #   XCFrameworkBuildPath/archive/SentryObjC/{sdk}.xcarchive/...
+      - name: Arrange slice archives
+        shell: bash
+        env:
+          SDKS: ${{ inputs.sdks }}
+        run: ./scripts/ci-arrange-xcframework-slices.sh --sdks "$SDKS"
+
+      - name: Link and assemble SentryObjC XCFrameworks
+        env:
+          SDKS: ${{ inputs.sdks }}
+        run: |
+          sdk_args=()
+          IFS=',' read -r -a sdk_list <<< "$SDKS"
+          for s in "${sdk_list[@]}"; do sdk_args+=(--sdk "$s"); done
+          ./scripts/build-xcframework-sentryobjc-standalone.sh "${sdk_args[@]}"
+        shell: bash
+
+      - name: Validate XCFramework structure
+        run: |
+          ./scripts/validate-xcframework-format.sh "SentryObjC-Static.xcframework"
+          ./scripts/validate-xcframework-format.sh "SentryObjC-Dynamic.xcframework"
+        shell: bash
+
+      - name: Zip XCFrameworks
+        env:
+          SIGNED: ${{ inputs.signed }}
+        run: |
+          if [ "$SIGNED" = "true" ]; then
+            ./scripts/compress-xcframework.sh --sign SentryObjC-Static
+            ./scripts/compress-xcframework.sh --sign SentryObjC-Dynamic
+          else
+            ./scripts/compress-xcframework.sh --not-signed SentryObjC-Static
+            ./scripts/compress-xcframework.sh --not-signed SentryObjC-Dynamic
+          fi
+        shell: bash
+
+      - name: Upload SentryObjC-Static XCFramework
+        uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7
+        with:
+          overwrite: true
+          name: xcframework-${{github.sha}}-sentryobjc-static
+          if-no-files-found: error
+          path: SentryObjC-Static.xcframework.zip
+
+      - name: Upload SentryObjC-Dynamic XCFramework
+        uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7
+        with:
+          overwrite: true
+          name: xcframework-${{github.sha}}-sentryobjc-dynamic
+          if-no-files-found: error
+          path: SentryObjC-Dynamic.xcframework.zip
+
+      - name: Run CI Diagnostics
+        if: failure()
+        run: ./scripts/ci-diagnostics.sh

.github/workflows/build-xcframework-variant-slices.yml

@@ -101,16 +101,37 @@ jobs:
         run: ./scripts/build-xcframework-slice.sh "$MATRIX_SDK" "$INPUT_NAME" "$INPUT_SUFFIX" "$INPUT_MACHO_TYPE" "$INPUT_CONFIG_SUFFIX"
         shell: bash
 
-      # The SentrySwiftUI archive build also builds Sentry.framework as a byproduct of the dependency. We need to remove that to avoid downstream assembly tasks from tripping on these extra files. In the future we could investigate using this byproduct instead of running a separate task for Sentry.framework, or use the one already built by that other task instead of rebuilding it here.
-      - name: Remove Sentry.framework from SentrySwiftUI build
-        if: inputs.name == 'SentrySwiftUI'
+      # Targets that depend on Sentry also build Sentry.framework as a byproduct.
+      # Remove it to avoid downstream assembly tasks from tripping on extra files.
+      - name: Remove Sentry.framework byproduct
+        if: inputs.name == 'SentrySwiftUI' || inputs.name == 'SentryObjCBridge' || inputs.name == 'SentryObjC'
         env:
           GITHUB_WORKSPACE: ${{ github.workspace }}
         run: |
           find "$GITHUB_WORKSPACE/XCFrameworkBuildPath/archive" -name "Sentry.framework" -print0 | xargs -t0 rm -rf
           find "$GITHUB_WORKSPACE/XCFrameworkBuildPath/archive" -name "Sentry.framework.dSYM" -print0 | xargs -t0 rm -rf
         shell: bash
 
+      # SentryObjCBridge and SentryObjC depend on SentryObjCTypes, which gets built as a byproduct.
+      - name: Remove SentryObjCTypes.framework byproduct
+        if: inputs.name == 'SentryObjCBridge' || inputs.name == 'SentryObjC'
+        env:
+          GITHUB_WORKSPACE: ${{ github.workspace }}
+        run: |
+          find "$GITHUB_WORKSPACE/XCFrameworkBuildPath/archive" -name "SentryObjCTypes.framework" -print0 | xargs -t0 rm -rf
+          find "$GITHUB_WORKSPACE/XCFrameworkBuildPath/archive" -name "SentryObjCTypes.framework.dSYM" -print0 | xargs -t0 rm -rf
+        shell: bash
+
+      # SentryObjC depends on SentryObjCBridge, which gets built as a byproduct.
+      - name: Remove SentryObjCBridge.framework byproduct
+        if: inputs.name == 'SentryObjC'
+        env:
+          GITHUB_WORKSPACE: ${{ github.workspace }}
+        run: |
+          find "$GITHUB_WORKSPACE/XCFrameworkBuildPath/archive" -name "SentryObjCBridge.framework" -print0 | xargs -t0 rm -rf
+          find "$GITHUB_WORKSPACE/XCFrameworkBuildPath/archive" -name "SentryObjCBridge.framework.dSYM" -print0 | xargs -t0 rm -rf
+        shell: bash
+
       # the upload action broke symlinks in the mac sdk slice's xcarchive
       - name: Zip xcarchive
         env:

.github/workflows/build.yml

@@ -107,6 +107,8 @@ jobs:
             config: Debug
           - scheme: iOS-ObjectiveC
             config: Debug
+          - scheme: iOS-ObjectiveCpp-NoModules
+            config: Debug
           - scheme: SPM
             config: Debug
           - scheme: DistributionSample
@@ -122,6 +124,7 @@ jobs:
       # sample projects don't use SPM for including Sentry. Only the DistributionSample uses local SPM.
       # Therefore, we only keep the local DistributionSample reference in the Package.swift as a workaround.
       - name: Only keep distribution lib and target in Package.swift
+        if: matrix.scheme == 'DistributionSample'
         run: ./scripts/prepare-package.sh --remove-binary-targets true
 
       - name: Setup Xcode

.github/workflows/release.yml

@@ -115,6 +115,19 @@ jobs:
       matrix:
         variant: ${{ fromJson(needs.setup-matrix.outputs.variants) }}
 
+  assemble-sentryobjc:
+    needs: [files-changed, build-xcframework-variant-slices, setup-matrix]
+    # Run the job only for PRs with related changes or non-PR events.
+    if: github.event_name != 'pull_request' || needs.files-changed.outputs.run_release_for_prs == 'true'
+    name: Assemble SentryObjC XCFramework
+    uses: ./.github/workflows/assemble-xcframework-sentryobjc.yml
+    secrets: inherit
+    with:
+      # Only sign the XCFramework on releases
+      signed: ${{ github.event_name != 'pull_request' }}
+      release-version: ${{ github.event.inputs.version }}
+      sdks: ${{ needs.setup-matrix.outputs.sdk-list-string }}
+
   validate-xcframework:
     name: Validate XCFramework
     runs-on: macos-15
@@ -451,6 +464,7 @@ jobs:
         files-changed,
         build-xcframework-variant-slices,
         assemble-xcframework-variant,
+        assemble-sentryobjc,
         validate-xcframework,
         validate-spm,
         validate-spm-dynamic,

.gitignore

@@ -105,12 +105,7 @@ Samples/watchOS-Swift/watchOS-Swift.xcodeproj
 TestSamples/SwiftUICrashTest/SwiftUICrashTest.xcodeproj
 TestSamples/SwiftUITestSample/SwiftUITestSample.xcodeproj
 
-Sentry.xcframework*
-Sentry-Dynamic.xcframework*
-Sentry-Dynamic-WithARM64e.xcframework*
-SentrySwiftUI.xcframework*
-Sentry-WithoutUIKitOrAppKit.xcframework*
-Sentry-WithoutUIKitOrAppKit-WithARM64e.xcframework*
+*.xcframework*
 
 current_package_diff.patch
 

AGENTS.md

@@ -54,6 +54,11 @@ SentrySDK (public entry point)
 | `SentryCrash/`        | C/C++ crash reporting (KSCrash fork)                                |
 | `SentryCppHelper/`    | C++ helpers (backtrace, sampling profiler, thread handle)           |
 | `SentrySwiftUI/`      | SwiftUI tracing (`TracedView`)                                      |
+| `SentryObjC/`         | Pure ObjC facade — behavior classes consumers invoke                |
+| `SentryObjCBridge/`   | Swift bridge — maps `SentryObjCTypes` ⇄ internal Swift types        |
+| `SentryObjCTypes/`    | Frozen public ObjC ABI — pure data carriers, Foundation-only        |
+
+> **Before touching `SentryObjC*` targets** (headers, types, bridge, build config), read [`develop-docs/SENTRY-OBJC.md`](develop-docs/SENTRY-OBJC.md). It defines the four-tier architecture, type placement rules, naming conventions, and stability contract. Violations (e.g., leaking SDK types into `SentryObjCTypes`) cause linker failures or ABI breaks.
 
 ## Skills & MCP (dotagents)
 

CHANGELOG.md

@@ -2,13 +2,19 @@
 
 ## Unreleased
 
+> [!IMPORTANT]
+> The new SentryObjC SDK introduced in this release should be considered experimental and may be subject to breaking changes.
+
+### Features
+
+- Add SentryObjC wrapper SDK to provide pure Objective-C compatibility layer that wraps the main Sentry SDK with stable, documented Objective-C interfaces. (#7598)
+  This SDK is designed for projects that require strict Objective-C compatibility without Swift dependencies. It ships as two xcframework variants — `SentryObjC-Static.xcframework.zip` and `SentryObjC-Dynamic.xcframework.zip` — and as a compile-from-source SPM library under the `SentryObjC` product.
+
 ### Fixes
 
 - Prevent memory strings in stack overflow crash reports (#7841)
 - Report crashed thread for null function calls (#7866)
 
-### Fixes
-
 ## 9.12.0
 
 > [!WARNING]