feat(sdks): standardize useLocalNatives toggle + fix Flutter/RN PR triggers

Two things:

1. Standardize the local-vs-remote toggle across all 5 client SDKs on
   the name `useLocalNatives`. Previously each SDK had its own name:
   Swift `useLocalBinaries`, Kotlin `runanywhere.testLocal`, Flutter
   `testLocal`, RN `runanywhere.testLocal`. Now:

   - Swift: Package.swift `let useLocalNatives` + build-swift.sh uses the
     new name end to end.
   - Kotlin: gradle.properties `runanywhere.useLocalNatives` (primary)
     with `runanywhere.testLocal` accepted as a legacy fallback that
     emits a deprecation warning. Top-level + both module gradles
     updated.
   - Flutter: binary_config.gradle declares `useLocalNatives` as the
     canonical ext var; `testLocal` is set to the same value as an
     alias so existing references keep working. All 4 package configs
     (runanywhere, runanywhere_llamacpp, runanywhere_onnx,
     runanywhere_genie) updated. Podspec headers relabeled.
   - React Native: android/build.gradle prefers
     `runanywhere.useLocalNatives`, falls back to the legacy
     `runanywhere.testLocal`. All 3 package gradles updated. Podspecs
     relabeled.

   External SPM/Gradle consumers of these SDKs are unaffected —
   they don't reference these toggles.

2. Fix Flutter + React Native SDK PR-build triggering in pr-build.yml.
   Previously they fired only on their own SDK-path changes. But both
   consume iOS AND Android natives, so they should also fire whenever
   either native-build job succeeds. Matches the Swift/Kotlin/Web
   pattern already in place.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: sanchitmonga22

.github/workflows/pr-build.yml

@@ -354,8 +354,15 @@ jobs:
         run: npm run typecheck
 
   sdk_flutter:
-    needs: detect
-    if: needs.detect.outputs.sdk_flutter == 'true'
+    # Flutter consumes BOTH iOS and Android natives, so fire whenever either
+    # native-build job succeeded on this run, OR when Flutter SDK paths changed.
+    needs: [detect, native_ios, native_android]
+    if: |
+      always() && (
+        needs.detect.outputs.sdk_flutter == 'true' ||
+        needs.native_ios.result == 'success' ||
+        needs.native_android.result == 'success'
+      )
     runs-on: ubuntu-latest
     timeout-minutes: 25
     steps:
@@ -374,8 +381,15 @@ jobs:
           done
 
   sdk_react_native:
-    needs: detect
-    if: needs.detect.outputs.sdk_react_native == 'true'
+    # React Native consumes BOTH iOS and Android natives, so fire whenever either
+    # native-build job succeeded on this run, OR when RN SDK paths changed.
+    needs: [detect, native_ios, native_android]
+    if: |
+      always() && (
+        needs.detect.outputs.sdk_react_native == 'true' ||
+        needs.native_ios.result == 'success' ||
+        needs.native_android.result == 'success'
+      )
     runs-on: ubuntu-latest
     timeout-minutes: 25
     steps:

Package.swift

@@ -25,32 +25,35 @@ import Foundation
 // BINARY TARGET CONFIGURATION
 // =============================================================================
 //
-// useLocalBinaries = true  → Use local XCFrameworks from sdk/runanywhere-swift/Binaries/
-//                            For local development. Run first-time setup:
-//                              cd sdk/runanywhere-swift && ./scripts/build-swift.sh --setup
+// useLocalNatives = true  → Use local XCFrameworks from sdk/runanywhere-swift/Binaries/
+//                           For local development. Run first-time setup:
+//                             cd sdk/runanywhere-swift && ./scripts/build-swift.sh --setup
 //
-// useLocalBinaries = false → Download XCFrameworks from GitHub releases (PRODUCTION)
-//                            For external users via SPM. No setup needed.
+// useLocalNatives = false → Download XCFrameworks from GitHub releases (PRODUCTION)
+//                           For external users via SPM. No setup needed.
 //
 // To toggle this value, use:
-//   ./scripts/build-swift.sh --set-local   (sets useLocalBinaries = true)
-//   ./scripts/build-swift.sh --set-remote  (sets useLocalBinaries = false)
+//   ./scripts/build-swift.sh --set-local   (sets useLocalNatives = true)
+//   ./scripts/build-swift.sh --set-remote  (sets useLocalNatives = false)
 //
+// Historical name: this used to be called `useLocalBinaries`. The concept is
+// the same — it's been renamed to `useLocalNatives` for consistency with the
+// equivalent toggle in the other client SDKs (Kotlin, Flutter, React Native).
 // =============================================================================
-let useLocalBinaries = false //  Toggle: true for local dev, false for release
+let useLocalNatives = false //  Toggle: true for local dev, false for release
 
-// Version for remote XCFrameworks (used when testLocal = false)
+// Version for remote XCFrameworks (used when useLocalNatives = false)
 // Updated automatically by CI/CD during releases
 let sdkVersion = "0.19.7"
 
 // MetalRT remote binary availability flag.
 // Set to `false` until a real checksum for RABackendMetalRT-v<sdkVersion>.zip
 // has been published. When `false`, the MetalRT product/targets are only
-// exposed under `useLocalBinaries = true`, so SPM resolution will not fail
+// exposed under `useLocalNatives = true`, so SPM resolution will not fail
 // for external consumers due to a placeholder checksum.
 let metalrtRemoteBinaryAvailable = false
 
-let includeMetalRT = useLocalBinaries || metalrtRemoteBinaryAvailable
+let includeMetalRT = useLocalNatives || metalrtRemoteBinaryAvailable
 
 let package = Package(
     name: "runanywhere-sdks",
@@ -241,7 +244,7 @@ let package = Package(
 // with a real checksum. To avoid SPM resolution failures for external
 // consumers due to a placeholder zero-checksum binary target, the MetalRT
 // product and its dependent targets are only included when:
-//   - `useLocalBinaries == true` (local dev with a checked-out xcframework), or
+//   - `useLocalNatives == true` (local dev with a checked-out xcframework), or
 //   - `metalrtRemoteBinaryAvailable == true` (once a real checksum is wired in).
 func metalRTProducts() -> [Product] {
     guard includeMetalRT else { return [] }
@@ -290,9 +293,9 @@ func metalRTTargets() -> [Target] {
 // =============================================================================
 // BINARY TARGET SELECTION
 // =============================================================================
-// Returns local or remote binary targets based on useLocalBinaries setting
+// Returns local or remote binary targets based on useLocalNatives setting
 func binaryTargets() -> [Target] {
-    if useLocalBinaries {
+    if useLocalNatives {
         // =====================================================================
         // LOCAL DEVELOPMENT MODE
         // Use XCFrameworks from sdk/runanywhere-swift/Binaries/

sdk/runanywhere-flutter/packages/runanywhere/android/binary_config.gradle

@@ -2,16 +2,24 @@
 // BINARY CONFIGURATION FOR RUNANYWHERE FLUTTER SDK - ANDROID (Core Package)
 // =============================================================================
 // This file controls whether to use local or remote native libraries (.so files).
-// Similar to Swift Package.swift's testLocal flag.
+// Matches Swift Package.swift's `useLocalNatives` and Kotlin gradle property
+// `runanywhere.useLocalNatives` — same semantics across all 5 SDKs.
 //
 // Set to `true` to use local binaries from android/src/main/jniLibs/
 // Set to `false` to download binaries from GitHub releases (production mode)
+//
+// Legacy name `testLocal` is still accepted as an alias.
 // =============================================================================
 
 ext {
-    // Set this to true for local development/testing
-    // Set to false for production builds (downloads from GitHub releases)
-    testLocal = false
+    // Canonical name (matches Swift/Kotlin/RN).
+    // Set this to true for local development/testing.
+    // Set to false for production builds (downloads from GitHub releases).
+    useLocalNatives = false
+
+    // Legacy alias — kept so existing code reading `testLocal` keeps working.
+    // Prefer `useLocalNatives`.
+    testLocal = useLocalNatives
 
     // =============================================================================
     // Version Configuration (MUST match Swift Package.swift and Kotlin build.gradle.kts)

sdk/runanywhere-flutter/packages/runanywhere/ios/runanywhere.podspec

@@ -24,7 +24,7 @@ GITHUB_ORG = "RunanywhereAI"
 COMMONS_REPO = "runanywhere-sdks"
 
 # =============================================================================
-# testLocal Toggle
+# useLocalNatives Toggle (canonical name; testLocal kept as legacy alias)
 # Set RA_TEST_LOCAL=1 or create .testlocal file to use local binaries
 # =============================================================================
 TEST_LOCAL = ENV['RA_TEST_LOCAL'] == '1' || File.exist?(File.join(__dir__, '.testlocal'))

sdk/runanywhere-flutter/packages/runanywhere_genie/android/binary_config.gradle

@@ -11,7 +11,8 @@
 ext {
     // Set this to true for local development/testing
     // Set to false for production builds (downloads from GitHub releases)
-    testLocal = false
+    useLocalNatives = false
+    testLocal = useLocalNatives  // legacy alias
 
     // =============================================================================
     // Version Configuration (MUST match Swift Package.swift and Kotlin build.gradle.kts)

sdk/runanywhere-flutter/packages/runanywhere_llamacpp/android/binary_config.gradle

@@ -11,7 +11,8 @@
 ext {
     // Set this to true for local development/testing
     // Set to false for production builds (downloads from GitHub releases)
-    testLocal = false
+    useLocalNatives = false
+    testLocal = useLocalNatives  // legacy alias
 
     // =============================================================================
     // Version Configuration (MUST match Swift Package.swift and Kotlin build.gradle.kts)

sdk/runanywhere-flutter/packages/runanywhere_llamacpp/ios/runanywhere_llamacpp.podspec

@@ -23,7 +23,7 @@ GITHUB_ORG = "RunanywhereAI"
 BINARIES_REPO = "runanywhere-sdks"
 
 # =============================================================================
-# testLocal Toggle
+# useLocalNatives Toggle (canonical name; testLocal kept as legacy alias)
 # Set RA_TEST_LOCAL=1 or create .testlocal file to use local binaries
 # =============================================================================
 TEST_LOCAL = ENV['RA_TEST_LOCAL'] == '1' || File.exist?(File.join(__dir__, '.testlocal'))

sdk/runanywhere-flutter/packages/runanywhere_onnx/android/binary_config.gradle

@@ -11,7 +11,8 @@
 ext {
     // Set this to true for local development/testing
     // Set to false for production builds (downloads from GitHub releases)
-    testLocal = false
+    useLocalNatives = false
+    testLocal = useLocalNatives  // legacy alias
 
     // =============================================================================
     // Version Configuration (MUST match Swift Package.swift and Kotlin build.gradle.kts)

sdk/runanywhere-flutter/packages/runanywhere_onnx/ios/runanywhere_onnx.podspec

@@ -29,7 +29,7 @@ GITHUB_ORG = "RunanywhereAI"
 BINARIES_REPO = "runanywhere-sdks"
 
 # =============================================================================
-# testLocal Toggle
+# useLocalNatives Toggle (canonical name; testLocal kept as legacy alias)
 # Set RA_TEST_LOCAL=1 or create .testlocal file to use local binaries
 # =============================================================================
 TEST_LOCAL = ENV['RA_TEST_LOCAL'] == '1' || File.exist?(File.join(__dir__, '.testlocal'))

sdk/runanywhere-kotlin/build.gradle.kts

@@ -57,13 +57,28 @@ version = resolvedVersion
 logger.lifecycle("RunAnywhere SDK version: $resolvedVersion (JitPack=$isJitPack)")
 
 // JNI library mode:
-//   testLocal=true  → locally built libs from src/androidMain/jniLibs/ (run ./scripts/build-kotlin.sh --setup)
-//   testLocal=false → download pre-built libs from GitHub releases
-// rootProject checked first to support composite builds (app's gradle.properties takes precedence)
-val testLocal: Boolean =
-    rootProject.findProperty("runanywhere.testLocal")?.toString()?.toBoolean()
+//   useLocalNatives=true  → locally built libs from src/androidMain/jniLibs/ (run ./scripts/build-kotlin.sh --setup)
+//   useLocalNatives=false → download pre-built libs from GitHub releases
+// rootProject checked first to support composite builds (app's gradle.properties takes precedence).
+// Legacy name `runanywhere.testLocal` still works as a fallback — emit a
+// deprecation warning so people migrate to the new name over time.
+val useLocalNatives: Boolean = run {
+    val newValue = rootProject.findProperty("runanywhere.useLocalNatives")?.toString()?.toBoolean()
+        ?: project.findProperty("runanywhere.useLocalNatives")?.toString()?.toBoolean()
+    if (newValue != null) return@run newValue
+    val legacyValue = rootProject.findProperty("runanywhere.testLocal")?.toString()?.toBoolean()
         ?: project.findProperty("runanywhere.testLocal")?.toString()?.toBoolean()
-        ?: false
+    if (legacyValue != null) {
+        logger.lifecycle(
+            "DEPRECATION: `runanywhere.testLocal` is deprecated; use " +
+                "`runanywhere.useLocalNatives` instead (same values)"
+        )
+        return@run legacyValue
+    }
+    false
+}
+// Alias kept so existing call sites below read the same value without churn.
+val testLocal: Boolean = useLocalNatives
 
 // rebuildCommons=true → force rebuild of runanywhere-commons C++ code
 val rebuildCommons: Boolean =