chore: allow local builds/packs to use local spm

Keeps the release builds using the tagged ios-spm remote artifacts while allowing local development as well.

[skip ci]

Author: NathanWalker

build_npm_ios.sh

@@ -20,6 +20,45 @@ node ./scripts/stamp-template-version.mjs \
   "$OUTPUT_DIR/framework/__PROJECT_NAME__.xcodeproj/project.pbxproj" \
   "$NPM_VERSION"
 
+# Local builds have no ios-spm release tag to resolve, so by default (outside
+# CI) rewrite the template to a LOCAL SwiftPM package over the xcframeworks
+# just built into dist/. Force with NS_SPM_LOCAL=1, disable with NS_SPM_LOCAL=0.
+# The resulting .tgz embeds an absolute path into this checkout — local
+# `ns platform add ios --framework-path=dist/nativescript-ios-*.tgz` use only.
+if [[ "${NS_SPM_LOCAL:-}" == "1" || ( -z "${CI:-}" && "${NS_SPM_LOCAL:-}" != "0" ) ]]; then
+  LOCAL_SPM_DIR="$(pwd)/dist/local-spm"
+  rm -rf "$LOCAL_SPM_DIR"
+  mkdir -p "$LOCAL_SPM_DIR"
+  cp -R "dist/NativeScript.xcframework" "$LOCAL_SPM_DIR/"
+  cp -R "dist/TKLiveSync.xcframework" "$LOCAL_SPM_DIR/"
+  cat > "$LOCAL_SPM_DIR/Package.swift" <<'EOF'
+// swift-tools-version: 5.10
+// Local dev override of github.com/NativeScript/ios-spm: same product shape,
+// but binaryTargets point at the freshly built xcframeworks in this folder.
+import PackageDescription
+
+let package = Package(
+    name: "NativeScriptSDK",
+    platforms: [
+        .iOS(.v13),
+        .macCatalyst(.v13),
+    ],
+    products: [
+        .library(name: "NativeScript", targets: ["NativeScript", "TKLiveSync"]),
+        .library(name: "NativeScriptSDK", targets: ["NativeScript", "TKLiveSync"]),
+    ],
+    dependencies: [],
+    targets: [
+        .binaryTarget(name: "NativeScript", path: "NativeScript.xcframework"),
+        .binaryTarget(name: "TKLiveSync", path: "TKLiveSync.xcframework"),
+    ]
+)
+EOF
+  node ./scripts/stamp-template-local-spm.mjs \
+    "$OUTPUT_DIR/framework/__PROJECT_NAME__.xcodeproj/project.pbxproj" \
+    "$LOCAL_SPM_DIR"
+fi
+
 # Build-time metadata generator is still shipped in npm (Phase 1). See the
 # distribution plan for moving this to an on-demand artifact (Phase 2).
 mkdir -p "$OUTPUT_DIR/framework/internal/metadata-generator-x86_64"

scripts/stamp-template-local-spm.mjs

@@ -0,0 +1,72 @@
+#!/usr/bin/env node
+// Stamp a packaged project template to consume the runtime via a LOCAL SwiftPM
+// package instead of the released ios-spm tag (the D6 "dev/offline override"
+// from SPM_DISTRIBUTION_PLAN.md).
+//
+// Local `npm run build-ios` produces xcframeworks in dist/ but no ios-spm
+// release tag, so the template's XCRemoteSwiftPackageReference (exactVersion
+// pinned by stamp-template-version.mjs) can never resolve. This script rewrites
+// that reference into an XCLocalSwiftPackageReference pointing at the local-spm
+// package the build just created (dist/local-spm — Package.swift + binary
+// targets over the built xcframeworks).
+//
+// The resulting npm package is machine-specific (it embeds an absolute path
+// into this checkout) and is only meant for `ns platform add ios
+// --framework-path=dist/nativescript-ios-<version>.tgz` style local testing.
+//
+// Usage: node scripts/stamp-template-local-spm.mjs <project.pbxproj> <abs-path-to-local-spm>
+import fs from "node:fs";
+import path from "node:path";
+
+const [, , pbxPath, localSpmPath] = process.argv;
+
+if (!pbxPath || !localSpmPath) {
+  console.error("Usage: stamp-template-local-spm.mjs <project.pbxproj> <abs-path-to-local-spm>");
+  process.exit(1);
+}
+
+if (!path.isAbsolute(localSpmPath)) {
+  console.error(`local-spm path must be absolute, got: ${localSpmPath}`);
+  process.exit(1);
+}
+
+if (!fs.existsSync(path.join(localSpmPath, "Package.swift"))) {
+  console.error(`No Package.swift found in ${localSpmPath} — run the runtime build first.`);
+  process.exit(1);
+}
+
+let contents = fs.readFileSync(pbxPath, "utf8");
+
+const REMOTE_REF_RE =
+  /\/\* Begin XCRemoteSwiftPackageReference section \*\/[\s\S]*?\/\* End XCRemoteSwiftPackageReference section \*\//;
+
+if (!REMOTE_REF_RE.test(contents)) {
+  console.error(`No XCRemoteSwiftPackageReference section found in ${pbxPath} (already stamped local?).`);
+  process.exit(1);
+}
+
+// The template uses a fixed UUID for the package reference; keep it so the
+// packageReferences list and product dependency keep resolving.
+const refUuidMatch = contents.match(/([0-9A-F]{24}) \/\* XCRemoteSwiftPackageReference "ios-spm" \*\//);
+if (!refUuidMatch) {
+  console.error(`Could not find the "ios-spm" package reference UUID in ${pbxPath}.`);
+  process.exit(1);
+}
+const refUuid = refUuidMatch[1];
+
+contents = contents.replace(
+  REMOTE_REF_RE,
+  `/* Begin XCLocalSwiftPackageReference section */
+\t\t${refUuid} /* XCLocalSwiftPackageReference "local-spm" */ = {
+\t\t\tisa = XCLocalSwiftPackageReference;
+\t\t\trelativePath = ${JSON.stringify(localSpmPath)};
+\t\t};
+/* End XCLocalSwiftPackageReference section */`
+);
+
+// Update the comment annotations everywhere the reference UUID appears
+// (packageReferences list + XCSwiftPackageProductDependency).
+contents = contents.split(`${refUuid} /* XCRemoteSwiftPackageReference "ios-spm" */`).join(`${refUuid} /* XCLocalSwiftPackageReference "local-spm" */`);
+
+fs.writeFileSync(pbxPath, contents);
+console.log(`Stamped ${pbxPath} → local SwiftPM package at ${localSpmPath}`);