feat: build kit xcframeworks from SPM packages instead of Xcode projects

[thomson-t]

Summary

• Remove all 29 kit-level .xcodeproj directories and 5 tvOS-specific header directories (mParticle-*-tvOS/), replacing the xcodeproj-based xcframework build with Scripts/build_kit_xcframework.sh that archives directly from each kit's Package.swift using xcodebuild -skipPackagePluginValidation
• Simplify Kits/matrix.json from separate per-platform schemes to a single scheme + module + platforms[] per kit
• Update release-publish.yml and build-kits.yml workflows to use the new SPM-based build approach

Motivation

Kit .xcodeproj files were only used to generate xcframeworks during release. Every kit already has a Package.swift that defines the same targets and dependencies. By building directly from SPM, we:

• Eliminate ~16,000 lines of generated Xcode project files
• Remove the need to maintain separate tvOS Xcode schemes (SPM handles multi-platform with a single scheme)
• Align the xcframework build with how consumers actually integrate kits (via SPM)

Key changes

New: Scripts/build_kit_xcframework.sh

Reusable script that builds an xcframework from an SPM package for one or more platforms. Handles:

• xcodebuild archive with -skipPackagePluginValidation (no .xcodeproj needed)
• Post-processing to copy public headers and generate module.modulemap into framework bundles
• Multi-platform builds (iOS + tvOS) from a single SPM scheme
• Sets BUILD_XCFRAMEWORK=1 to signal Package.swift to use dynamic library type

Updated: Kits/matrix.json

Simplified from:

"schemes": [
  {"scheme": "mParticle-Braze", "module": "mParticle_Braze", "destination": "iOS"},
  {"scheme": "mParticle-Braze-tvOS", "module": "mParticle_Braze", "destination": "tvOS"}
]

To:

"scheme": "mParticle-Braze",
"module": "mParticle_Braze",
"platforms": ["iOS", "tvOS"]

Updated: 29 kit Package.swift files

• Added BUILD_XCFRAMEWORK env var to conditionally set .dynamic library type (required for framework output from SPM)
• Added explicit name: "mparticle-apple-sdk" on local path dependency for SPM identity resolution
• No changes to remote dependency resolution or public API

Deleted

• 29 kit .xcodeproj directories (project files + shared schemes)
• 5 mParticle-*-tvOS/ directories from Braze (3) and Kochava (2) kits — only contained tvOS headers/plists used by the Xcode project's tvOS target

Test plan

• Verify Scripts/build_kit_xcframework.sh produces valid xcframeworks for an iOS-only kit (e.g., Adjust) and a multi-platform kit (e.g., Braze)
• Trigger Release – Publish workflow with dry_run: true to validate the full CI pipeline
• Verify Build Kits CI workflow passes for all 29 kits
• Confirm xcframework zip contents include headers, module maps, and dSYMs
• Verify SPM consumers can still resolve kit packages (no public API change)

[cursor]

PR Summary

Medium Risk
Medium risk because it rewires the kit build/release pipeline (xcframework generation, scheme/platform matrix, Xcode selection), which could break CI or published kit binaries if any kit’s SPM scheme/headers differ from expectations.

Overview
Kit xcframework generation is migrated to SPM-only builds. Release publishing now calls Scripts/build_kit_xcframework.sh to archive device+simulator slices per platform from each kit’s Package.swift, then -create-xcframework and zip outputs.

CI workflows and kit metadata are simplified. Kits/matrix.json moves from per-destination scheme entries to a single scheme + module + platforms[] per kit, build-kits.yml builds/test via xcodebuild schemes from the package directory, and release-publish.yml adds per-kit Xcode version selection.

Kits are updated to support the new build path. Kit Package.swift files add a BUILD_XCFRAMEWORK flag to force .dynamic products during xcframework builds and set the local core SDK dependency identity via .package(name: "mparticle-apple-sdk", path: "../../../"), while kit .xcodeproj files (and tvOS-only header/plist directories) are removed.

^{Reviewed by Cursor Bugbot for commit 1ed9bea. Bugbot is set up for automated code reviews on this repo. Configure here.}

[github-actions]

📦 SDK Size Impact Report

Measures how much the SDK adds to an app's size (with-SDK minus without-SDK).

Metric	Target Branch	This PR	Change
App Bundle Impact	1.75 MB	1.75 MB	+N/A
Executable Impact	848 bytes	848 bytes	+N/A
XCFramework Size	6.38 MB	6.38 MB	+N/A

➡️ SDK size impact change is minimal.

Raw measurements

Target branch (main):

{"baseline_app_size_kb":84,"baseline_executable_size_bytes":75464,"with_sdk_app_size_kb":1876,"with_sdk_executable_size_bytes":76312,"sdk_impact_kb":1792,"sdk_executable_impact_bytes":848,"xcframework_size_kb":6528}

This PR:

{"baseline_app_size_kb":84,"baseline_executable_size_bytes":75464,"with_sdk_app_size_kb":1876,"with_sdk_executable_size_bytes":76312,"sdk_impact_kb":1792,"sdk_executable_impact_bytes":848,"xcframework_size_kb":6528}

[cursor]

Cursor Bugbot has reviewed your changes and found 1 potential issue.

^{❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, have a team admin enable autofix in the Cursor dashboard.}

^{Reviewed by Cursor Bugbot for commit a2f4b2a. Configure here.}

[cursor]

Wrong framework name: uses SCHEME instead of MODULE

High Severity

FRAMEWORK_NAME is set to "${SCHEME}.framework" (e.g., mParticle-Braze.framework) but xcodebuild archive from an SPM package produces framework bundles using the c99 extended identifier form with underscores (e.g., mParticle_Braze.framework). The existing Scripts/xcframework.sh and the deleted old workflow code both correctly use $MODULE.framework for the -framework argument. This mismatch causes the header/modulemap post-processing to silently skip (the -d check fails) and xcodebuild -create-xcframework to fail because it can't find the framework. Affects all 29 kits.

Additional Locations (1)

• Scripts/build_kit_xcframework.sh#L117-L135

 

^{Reviewed by Cursor Bugbot for commit a2f4b2a. Configure here.}

[thomson-t]

The module name inside the framework uses underscores (mParticle_Adjust), but the bundle name uses hyphens