getsentry · philprime · Mar 4, 2026 · Mar 10, 2026 · Mar 10, 2026 · Mar 10, 2026
@@ -74,11 +74,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"

@@ -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
@@ -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
         if: failure()
         run: ./scripts/ci-diagnostics.sh

@@ -0,0 +1,146 @@
+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
+      - run: ./scripts/ci-select-xcode.sh 16.4
+        shell: bash
+
+      - 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 three sets of static library slices.
+      # Each artifact contains a {sdk}.xcarchive.zip for one platform.
+      - name: Download Sentry static slices
+        uses: actions/download-artifact@v8
+        with:
+          pattern: xcframework-sentry-static-slice-*
+          path: xcframework-slices/sentry-static
+
+      - name: Download SentryObjCBridge slices
+        uses: actions/download-artifact@v8
+        with:
+          pattern: xcframework-sentryobjc-bridge-slice-*
+          path: xcframework-slices/sentryobjc-bridge
+
+      - name: Download SentryObjC slices
+        uses: actions/download-artifact@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/SentryObjCBridge/{sdk}.xcarchive/...
+      #   XCFrameworkBuildPath/archive/SentryObjC/{sdk}.xcarchive/...
+      - name: Arrange slice archives
+        shell: bash
+        env:
+          SDKS: ${{ inputs.sdks }}
+        run: |
+          set -euo pipefail
+          mkdir -p XCFrameworkBuildPath/archive
+
+          arrange_slices() {
+            local variant_id="$1"
+            local slice_dir="$2"
+            local archive_name="$3"
+
+            IFS=',' read -r -a sdk_list <<< "$SDKS"
+            for sdk in "${sdk_list[@]}"; do
+              artifact_dir="${slice_dir}/xcframework-${variant_id}-slice-${sdk}"
+              zip_file=$(find "$artifact_dir" -name "*.xcarchive.zip" -type f | head -1)
+              if [ -z "$zip_file" ]; then
+                echo "ERROR: No xcarchive.zip found in $artifact_dir"
+                exit 1
+              fi
+              # Unzip into a temp location, then move the xcarchive into place
+              unzip_dir="/tmp/sentryobjc-unzip-${variant_id}-${sdk}"
+              rm -rf "$unzip_dir"
+              mkdir -p "$unzip_dir"
+              unzip -q "$zip_file" -d "$unzip_dir"
+              # The zip contains {sdk}.xcarchive/ (created with --keepParent)
+              mkdir -p "XCFrameworkBuildPath/archive/${archive_name}"
+              mv "$unzip_dir/${sdk}.xcarchive" "XCFrameworkBuildPath/archive/${archive_name}/${sdk}.xcarchive"
+              rm -rf "$unzip_dir"
+            done
+          }
+
+          arrange_slices "sentry-static" "xcframework-slices/sentry-static" "Sentry"
+          arrange_slices "sentryobjc-bridge" "xcframework-slices/sentryobjc-bridge" "SentryObjCBridge"
+          arrange_slices "sentryobjc-objc" "xcframework-slices/sentryobjc-objc" "SentryObjC"
+
+          echo "Archive layout:"
+          find XCFrameworkBuildPath/archive -maxdepth 3 -type d | head -30
+
+      - name: Link and assemble SentryObjC XCFramework
+        env:
+          SDKS: ${{ inputs.sdks }}
+        run: ./scripts/build-xcframework-sentryobjc-standalone.sh "$SDKS"
+        shell: bash
+
+      - name: Validate XCFramework structure
+        run: ./scripts/validate-xcframework-format.sh "SentryObjC.xcframework"
+        shell: bash
+
+      - name: Zip XCFramework
+        env:
+          SIGNED: ${{ inputs.signed }}
+        run: |
+          if [ "$SIGNED" = "true" ]; then
+            ./scripts/compress-xcframework.sh --sign SentryObjC
+          else
+            ./scripts/compress-xcframework.sh --not-signed SentryObjC
+          fi
+        shell: bash
+
+      - name: Upload XCFramework
+        uses: actions/upload-artifact@v7
+        with:
+          overwrite: true
+          name: xcframework-${{github.sha}}-sentryobjc
+          if-no-files-found: error
+          path: SentryObjC.xcframework.zip
+
+      - name: Run CI Diagnostics
+        if: failure()
+        run: ./scripts/ci-diagnostics.sh
@@ -100,16 +100,27 @@ 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
 
+      # 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:

@@ -104,6 +104,8 @@ jobs:
             config: Debug
           - scheme: iOS-ObjectiveC
             config: Debug
+          - scheme: iOS-ObjectiveCpp-NoModules
+            config: Debug
           - scheme: SPM
             config: Debug
           - scheme: DistributionSample

@@ -114,6 +114,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
@@ -414,6 +427,7 @@ jobs:
         files-changed,
         build-xcframework-variant-slices,
         assemble-xcframework-variant,
+        assemble-sentryobjc,
         validate-xcframework,
         validate-spm,
         validate-spm-dynamic,

@@ -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
 

@@ -2,6 +2,9 @@
 
 ## Unreleased
 
+- 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.
+
 ### Features
 
 - Add `SentrySDK.lastRunStatus` to distinguish unknown, no-crash and crash (#7469)

@@ -219,6 +219,31 @@ build-signed-xcframework:
 build-xcframework-sample:
 	xcodebuild -project "Samples/XCFramework-Validation/XCFramework.xcodeproj" -configuration Release CODE_SIGNING_ALLOWED="NO" build
 
+## Build SentryObjC framework for iOS Simulator
+#
+# Builds the SentryObjC framework target for iOS Simulator.
+# This is the Objective-C wrapper framework that provides a stable ABI for ObjC++ consumers.
+# The target must first be added to the Xcode project using: bundle exec ruby scripts/add-sentryobjc-target.rb
+.PHONY: build-sentryobjc
+build-sentryobjc:
+	@echo "--> Building SentryObjC for iOS Simulator"
+	set -o pipefail && xcodebuild build \
+		-project Sentry.xcodeproj \
+		-scheme SentryObjC \
+		-destination 'platform=iOS Simulator,OS=$(IOS_SIMULATOR_OS),name=$(IOS_DEVICE_NAME)' \
+		-configuration Release \
+		CODE_SIGNING_ALLOWED="NO" 2>&1 | xcbeautify --preserve-unbeautified
+
+## Build SentryObjC XCFramework for distribution (iOS only)
+#
+# Creates SentryObjC XCFramework for iOS platforms (device + simulator).
+# Uses the existing xcframework build infrastructure.
+# Outputs to XCFrameworkBuildPath/SentryObjC.xcframework.
+.PHONY: build-sentryobjc-xcframework
+build-sentryobjc-xcframework:
+	@echo "--> Creating SentryObjC xcframework (iOS only)"
+	./scripts/build-xcframework-variant.sh SentryObjC '' mh_dylib '' iOSOnly ''
+
 # ============================================================================
 # SAMPLE APPS
 # ============================================================================
@@ -230,6 +255,7 @@ build-xcframework-sample:
 build-samples: \
 	build-sample-DistributionSample \
 	build-sample-iOS-ObjectiveC \
+	build-sample-iOS-ObjectiveCpp-NoModules \
 	build-sample-iOS-Swift \
 	build-sample-iOS-Swift6 \
 	build-sample-iOS-SwiftUI \
@@ -324,9 +350,8 @@ build-sample-visionOS-SwiftUI-SPM:
 
 ## Build the iOS-ObjectiveCpp-NoModules sample app
 #
-# Builds the ObjC++ without-modules sample that reproduces #4543.
-# This target is expected to FAIL until the pure ObjC SDK wrapper (#6342)
-# is implemented. Use it to verify the fix.
+# Builds the ObjC++ without-modules sample that uses SentryObjC (#6342).
+# Uses #import <SentryObjC/SentryObjC.h> for ObjC++ without -fmodules.
 .PHONY: build-sample-iOS-ObjectiveCpp-NoModules
 build-sample-iOS-ObjectiveCpp-NoModules:
 	xcodegen --spec Samples/iOS-ObjectiveCpp-NoModules/iOS-ObjectiveCpp-NoModules.yml

@@ -96,7 +96,19 @@ targets += [
         name: "SentryObjCInternal",
         dependencies: ["SentrySwift"],
         path: "Sources",
-        exclude: ["Sentry/SentryDummyPublicEmptyClass.m", "Sentry/SentryDummyPrivateEmptyClass.m", "Swift", "SentrySwiftUI", "Resources", "Configuration", "SentryCppHelper", "SentryDistribution", "SentryDistributionTests"],
+        exclude: [
+            "Sentry/SentryDummyPublicEmptyClass.m", 
+            "Sentry/SentryDummyPrivateEmptyClass.m", 
+            "Swift", 
+            "SentrySwiftUI", 
+            "Resources", 
+            "Configuration", 
+            "SentryCppHelper", 
+            "SentryDistribution", 
+            "SentryDistributionTests", 
+            "SentryObjC", 
+            "SentryObjCBridge"
+        ],
         cSettings: [
             .headerSearchPath("Sentry"),
             .headerSearchPath("SentryCrash/Recording"),
@@ -107,6 +119,28 @@ targets += [
             .headerSearchPath("SentryCrash/Reporting/Filters/Tools")])
 ]
 
+// Swift bridge that exposes SDK functionality to pure ObjC code (no modules)
+products.append(.library(name: "SentryObjC", targets: ["SentryObjCInternal", "SentryObjCBridge", "SentryObjC"]))
+targets += [
+    .target(
+        name: "SentryObjCBridge",
+        dependencies: ["SentryObjCInternal"],
+        path: "Sources/SentryObjCBridge",
+        swiftSettings: [
+            .unsafeFlags(["-enable-library-evolution"])
+        ]),
+
+    .target(
+        name: "SentryObjC",
+        dependencies: ["SentryObjCBridge"],
+        path: "Sources/SentryObjC",
+        publicHeadersPath: "Public",
+        cSettings: [
+            .headerSearchPath("Public")
+        ]
+    )
+]
+
 let package = Package(
     name: "Sentry",
     platforms: [.iOS(.v15), .macOS(.v10_14), .tvOS(.v15), .watchOS(.v8), .visionOS(.v1)],