Add script to build the Swift XCFramework

.github/scripts/build-swift-xcframework.sh

@@ -0,0 +1,106 @@
+#!/usr/bin/env bash
+# Builds DemucsFramework.xcframework and the matching UniFFI Swift bindings for
+# github.com/SplitFireAI/demucs-swift. Run on macOS with Xcode, the stable
+# toolchain (with the iOS and macOS targets) and a nightly with rust-src.
+#
+# Outputs, under dist/swift/:
+#   DemucsFramework.xcframework(.zip)   the binary target
+#   DemucsFramework.checksum.txt        `swift package compute-checksum` of the zip
+#   Package/Sources/Demucs/demucs_ffi.swift  the generated bindings
+#   version.txt                         the demucs-ffi crate version
+set -euo pipefail
+
+ROOT_DIR=$(cd -- "$(dirname -- "${BASH_SOURCE[0]}")/../.." && pwd)
+cd "$ROOT_DIR"
+
+DIST_DIR="$ROOT_DIR/dist/swift"
+PACKAGE_DIR="$DIST_DIR/Package"
+HEADERS_DIR="$DIST_DIR/Headers"
+FRAMEWORK_DIR="$DIST_DIR/DemucsFramework.xcframework"
+ZIP_PATH="$DIST_DIR/DemucsFramework.xcframework.zip"
+CHECKSUM_PATH="$DIST_DIR/DemucsFramework.checksum.txt"
+VERSION_PATH="$DIST_DIR/version.txt"
+BINDGEN="$ROOT_DIR/target/release/uniffi-bindgen"
+MANIFEST="$ROOT_DIR/demucs-ffi/Cargo.toml"
+APPLE_TARGET_DIR="$ROOT_DIR/target/apple"
+LIB_NAME="libdemucs_ffi.a"
+
+IOS_DEPLOYMENT_TARGET="${IOS_DEPLOYMENT_TARGET:-16.0}"
+MACOS_DEPLOYMENT_TARGET="${MACOS_DEPLOYMENT_TARGET:-14.0}"
+TVOS_DEPLOYMENT_TARGET="${TVOS_DEPLOYMENT_TARGET:-16.0}"
+VISIONOS_DEPLOYMENT_TARGET="${VISIONOS_DEPLOYMENT_TARGET:-1.0}"
+
+# .cargo/config.toml builds macOS with `-C target-cpu=native` for the CLI. A
+# distributed framework must run on every Apple silicon Mac, not just the CI
+# runner's, so clear it (the release workflow does the same for the CLI).
+export CARGO_TARGET_AARCH64_APPLE_DARWIN_RUSTFLAGS=""
+
+rm -rf "$FRAMEWORK_DIR" "$ZIP_PATH" "$CHECKSUM_PATH" "$VERSION_PATH" "$PACKAGE_DIR" "$HEADERS_DIR"
+mkdir -p "$PACKAGE_DIR/Sources/Demucs" "$HEADERS_DIR"
+
+cargo build --manifest-path uniffi-bindgen/Cargo.toml --release
+
+# cargo never prints the target it is building, so a bare `error: could not
+# compile` deep in the log cannot be attributed without counting `Finished`
+# lines. Announce every target.
+#
+# The tvOS and visionOS targets are tier 3: no prebuilt std ships for them,
+# hence nightly and -Z build-std.
+build_target() {
+  local target="$1" deployment="$2"
+  shift 2
+  echo "::group::cargo rustc --target $target"
+  env "$deployment" cargo "$@" rustc \
+    --target-dir "$APPLE_TARGET_DIR" \
+    --manifest-path "$MANIFEST" \
+    --target "$target" \
+    --release --lib --crate-type staticlib
+  echo "::endgroup::"
+}
+
+build_target aarch64-apple-ios          "IPHONEOS_DEPLOYMENT_TARGET=$IOS_DEPLOYMENT_TARGET"
+build_target aarch64-apple-ios-sim      "IPHONEOS_DEPLOYMENT_TARGET=$IOS_DEPLOYMENT_TARGET"
+build_target aarch64-apple-darwin       "MACOSX_DEPLOYMENT_TARGET=$MACOS_DEPLOYMENT_TARGET"
+build_target aarch64-apple-tvos         "TVOS_DEPLOYMENT_TARGET=$TVOS_DEPLOYMENT_TARGET" +nightly -Z build-std
+build_target aarch64-apple-tvos-sim     "TVOS_DEPLOYMENT_TARGET=$TVOS_DEPLOYMENT_TARGET" +nightly -Z build-std
+build_target aarch64-apple-visionos     "XROS_DEPLOYMENT_TARGET=$VISIONOS_DEPLOYMENT_TARGET" +nightly -Z build-std
+build_target aarch64-apple-visionos-sim "XROS_DEPLOYMENT_TARGET=$VISIONOS_DEPLOYMENT_TARGET" +nightly -Z build-std
+
+"$BINDGEN" generate "$APPLE_TARGET_DIR/aarch64-apple-ios/release/$LIB_NAME" --crate demucs_ffi --language swift --out-dir "$PACKAGE_DIR/Sources/Demucs"
+cp "$PACKAGE_DIR/Sources/Demucs/demucs_ffiFFI.h" "$HEADERS_DIR/demucs_ffiFFI.h"
+cp "$PACKAGE_DIR/Sources/Demucs/demucs_ffiFFI.modulemap" "$HEADERS_DIR/module.modulemap"
+
+xcodebuild -create-xcframework \
+  -library "$APPLE_TARGET_DIR/aarch64-apple-ios/release/$LIB_NAME" -headers "$HEADERS_DIR" \
+  -library "$APPLE_TARGET_DIR/aarch64-apple-ios-sim/release/$LIB_NAME" -headers "$HEADERS_DIR" \
+  -library "$APPLE_TARGET_DIR/aarch64-apple-tvos/release/$LIB_NAME" -headers "$HEADERS_DIR" \
+  -library "$APPLE_TARGET_DIR/aarch64-apple-tvos-sim/release/$LIB_NAME" -headers "$HEADERS_DIR" \
+  -library "$APPLE_TARGET_DIR/aarch64-apple-visionos/release/$LIB_NAME" -headers "$HEADERS_DIR" \
+  -library "$APPLE_TARGET_DIR/aarch64-apple-visionos-sim/release/$LIB_NAME" -headers "$HEADERS_DIR" \
+  -library "$APPLE_TARGET_DIR/aarch64-apple-darwin/release/$LIB_NAME" -headers "$HEADERS_DIR" \
+  -output "$FRAMEWORK_DIR"
+
+# Fixed timestamps and permissions so the same framework always zips to the
+# same bytes, and so the same checksum.
+export FRAMEWORK_DIR ZIP_PATH
+python3 - <<'PY'
+import os, stat, zipfile
+from pathlib import Path
+
+root = Path(os.environ["FRAMEWORK_DIR"])
+output = Path(os.environ["ZIP_PATH"])
+with zipfile.ZipFile(output, "w", compression=zipfile.ZIP_DEFLATED, compresslevel=9) as archive:
+    for path in sorted(item for item in root.rglob("*") if item.is_file()):
+        info = zipfile.ZipInfo(str(path.relative_to(root.parent)), (1980, 1, 1, 0, 0, 0))
+        info.compress_type = zipfile.ZIP_DEFLATED
+        info.external_attr = (stat.S_IFREG | 0o644) << 16
+        archive.writestr(info, path.read_bytes())
+PY
+
+swift package compute-checksum "$ZIP_PATH" > "$CHECKSUM_PATH"
+cargo metadata --no-deps --format-version 1 \
+  | python3 -c 'import json,sys; print(next(p["version"] for p in json.load(sys.stdin)["packages"] if p["name"] == "demucs-ffi"))' \
+  > "$VERSION_PATH"
+
+printf 'XCFramework: %s\nChecksum: %s\nVersion: %s\n' \
+  "$FRAMEWORK_DIR" "$(cat "$CHECKSUM_PATH")" "$(cat "$VERSION_PATH")"

.gitignore

@@ -13,3 +13,6 @@ demucs-plugin/ui-macos/.build/
 
 # IDE / tools
 .playwright-mcp/
+
+# Swift SDK build output (.github/scripts/build-swift-xcframework.sh)
+dist/

Makefile

@@ -1,4 +1,4 @@
-.PHONY: cli plugin wasm wasm-release web dev dev-release clean test-plugin test-plugin-e2e test-web-e2e test-web-smoke
+.PHONY: cli plugin swift-xcframework wasm wasm-release web dev dev-release clean test-plugin test-plugin-e2e test-web-e2e test-web-smoke
 
 # Build native CLI (release, auto-detects GPU backend via target-conditional deps)
 cli:
@@ -8,6 +8,10 @@ cli:
 plugin:
 	cargo xtask bundle demucs-plugin --release
 
+# Build the demucs-swift XCFramework + Swift bindings into dist/swift (macOS only)
+swift-xcframework:
+	.github/scripts/build-swift-xcframework.sh
+
 # Build WASM (debug — fast compile, slow runtime)
 wasm:
 	wasm-pack build demucs-wasm --target web --out-dir ../web/src/wasm