expo-modules-jsi 56.0.2 → 56.0.3

package/CHANGELOG.md

@@ -10,6 +10,12 @@
 
 ### 💡 Others
 
+## 56.0.3 — 2026-05-11
+
+### 🐛 Bug fixes
+
+- [iOS] Fixed launch-time crash in apps with source-built React Native. ([#45636](https://github.com/expo/expo/pull/45636) by [@tsapeta](https://github.com/tsapeta))
+
 ## 56.0.2 — 2026-05-08
 
 ### 🐛 Bug fixes

package/apple/ExpoModulesJSI.podspec

@@ -51,7 +51,6 @@ Pod::Spec.new do |s|
 
   s.dependency 'React-Core'
   s.dependency 'ReactCommon'
-  s.dependency 'React-runtimescheduler'
 
   # Create a stub xcframework if needed, so CocoaPods generates the
   # "[CP] Copy XCFrameworks" and "[CP] Embed Pods Frameworks" build phases.

package/apple/Package.swift

@@ -14,8 +14,11 @@ let podsRoot = resolvePodsRoot()
 // framework and its headers don't get mirrored to Pods/Headers/Public. Clang
 // ignores missing `-I` paths, so they're no-ops elsewhere. `RN_ROOT` is
 // forwarded from build-xcframework.sh (Node-resolved for hoisted monorepos).
+// `REACT_NATIVE_PATH` is exported by Xcode for hosts that build RN from a
+// non-npm location, e.g. Expo Go.
 let publicHeaders = "\(podsRoot)/Headers/Public"
 let reactNative = ProcessInfo.processInfo.environment["RN_ROOT"]
+  ?? ProcessInfo.processInfo.environment["REACT_NATIVE_PATH"]
   ?? "\(podsRoot)/../../node_modules/react-native"
 let headerSearchPaths = [
   publicHeaders,

package/apple/Sources/ExpoModulesJSI/Runtime/JavaScriptRuntime.swift

@@ -38,28 +38,55 @@ open class JavaScriptRuntime: Equatable, @unchecked Sendable {
   lazy var runtimeActor: JavaScriptRuntimeActor = JavaScriptRuntimeActor(runtime: self)
 
   /**
-   Creates a runtime from the JSI runtime.
+   Creates a runtime from the JSI runtime. The scheduler runs tasks synchronously
+   on the caller's thread — for the React-backed runtime, use
+   `init(unsafePointer:nativeScheduler:dispatch:)` instead.
    */
   internal init(_ runtime: facebook.jsi.Runtime) {
     self.pointee = runtime
-    self.scheduler = expo.RuntimeScheduler(runtime)
+    self.scheduler = expo.RuntimeScheduler()
   }
 
   /**
-   Creates Hermes runtime.
+   Creates a standalone Hermes runtime. Scheduled tasks run synchronously —
+   no React scheduler is wired up.
    */
   public init() {
     self.pointee = expo.createHermesRuntime()
-    self.scheduler = expo.RuntimeScheduler(pointee)
+    self.scheduler = expo.RuntimeScheduler()
   }
 
   /**
    Creates a runtime from a raw pointer to the underlying `facebook.jsi.Runtime`.
+   Scheduled tasks run synchronously — for the React-backed runtime, use
+   `init(unsafePointer:nativeScheduler:dispatch:)` instead.
    */
   public init(unsafePointer: UnsafeMutableRawPointer) {
     let runtime = unsafeBitCast(unsafePointer, to: facebook.jsi.Runtime.self)
     self.pointee = runtime
-    self.scheduler = expo.RuntimeScheduler(runtime)
+    self.scheduler = expo.RuntimeScheduler()
+  }
+
+  /**
+   Creates a runtime bound to a host-provided React `RuntimeScheduler`. Calls to
+   `schedule(...)` / `.execute(...)` dispatch through `dispatch`, which the host
+   implements against the real `react::RuntimeScheduler`. This is the path the
+   React Native factory uses.
+
+   - `unsafePointer`: raw pointer to the underlying `facebook::jsi::Runtime`.
+   - `scheduler`: raw pointer to the `react::RuntimeScheduler` instance.
+   - `dispatch`: raw pointer to a C function with signature
+     `void (*)(void *scheduler, int priority, void (^callback)())`.
+   */
+  public init(
+    unsafePointer: UnsafeMutableRawPointer,
+    scheduler: UnsafeMutableRawPointer,
+    dispatch: UnsafeRawPointer
+  ) {
+    let runtime = unsafeBitCast(unsafePointer, to: facebook.jsi.Runtime.self)
+    let fn = unsafeBitCast(dispatch, to: expo.RuntimeScheduler.ScheduleFn.self)
+    self.pointee = runtime
+    self.scheduler = expo.RuntimeScheduler(scheduler, fn)
   }
 
   /**
@@ -348,8 +375,8 @@ open class JavaScriptRuntime: Equatable, @unchecked Sendable {
    Schedules a closure to be executed with granted synchronized access to the runtime.
    */
   public func schedule(priority: SchedulerPriority = .normal, @_implicitSelfCapture _ closure: @escaping @JavaScriptActor () -> sending Void) -> Void {
-    let reactPriority = facebook.react.SchedulerPriority(rawValue: priority.rawValue) ?? .NormalPriority
-    scheduler.scheduleTask(reactPriority) {
+    let cxxPriority = expo.RuntimeScheduler.Priority(rawValue: priority.rawValue) ?? .NormalPriority
+    scheduler.scheduleTask(cxxPriority) {
       JavaScriptActor.assumeIsolated(closure)
     }
   }

package/apple/Sources/ExpoModulesJSI-Cxx/include/RuntimeScheduler.h

@@ -2,65 +2,76 @@
 
 #ifdef __cplusplus
 
-#include <memory>
+#include <atomic>
 #include <swift/bridging>
-#include <jsi/jsi.h>
-#include <react/renderer/runtimescheduler/RuntimeScheduler.h>
-#include <react/renderer/runtimescheduler/RuntimeSchedulerBinding.h>
-
-namespace jsi = facebook::jsi;
-namespace react = facebook::react;
 
 namespace expo {
 
 /**
- Wrapper for RuntimeScheduler from React which for some reason cannot be constructed from Swift.
- Imported as a shared reference type so Swift manages its lifetime via retain/release.
+ Wrapper around React Native's RuntimeScheduler. The native scheduler reference
+ and dispatch trampoline are supplied by the host (e.g. ExpoReactNativeFactory)
+ at construction time. The xcframework intentionally avoids linking against
+ React-runtimescheduler so the prebuilt binary works with hosts that build RN
+ either as a dynamic framework or as a static archive — without needing
+ -undefined dynamic_lookup to resolve React internals.
+
+ Priority values mirror facebook::react::SchedulerPriority — kept here as a
+ plain enum so we don't include the React header.
  */
 class RuntimeScheduler {
-private:
-  std::shared_ptr<react::RuntimeScheduler> reactRuntimeScheduler;
+public:
+  enum class Priority : int {
+    ImmediatePriority = 1,
+    UserBlockingPriority = 2,
+    NormalPriority = 3,
+    LowPriority = 4,
+    IdlePriority = 5,
+  };
+
+  using ScheduleTaskCallback = void(^)();
 
   /**
-   Reference count managed by Swift's ARC via SWIFT_SHARED_REFERENCE.
-   Prevents premature deallocation when C++ shared_ptr and Swift references coexist.
+   Trampoline implemented by the host — casts `nativeScheduler` back to
+   react::RuntimeScheduler* and calls scheduleTask on it. Keeping it as a
+   function pointer keeps React types out of this header.
    */
+  using ScheduleFn = void (*)(void *nativeScheduler, int priority, ScheduleTaskCallback callback);
+
+private:
+  void *const nativeScheduler{nullptr};
+  const ScheduleFn scheduleFn{nullptr};
+
   std::atomic<int> refCount{1};
 
 public:
   /**
-   Constructs the scheduler from a React Native runtime binding.
-   Falls back to a no-op scheduler when no binding is installed.
+   Constructs a scheduler bound to a host-provided native RuntimeScheduler.
+   `scheduleTask` dispatches through `fn`, which the host implements against
+   the real react::RuntimeScheduler.
    */
-  RuntimeScheduler(jsi::Runtime &runtime) {
-    if (auto binding = react::RuntimeSchedulerBinding::getBinding(runtime)) {
-      reactRuntimeScheduler = binding->getRuntimeScheduler();
-    }
-  }
+  RuntimeScheduler(void *scheduler, ScheduleFn fn) noexcept
+      : nativeScheduler(scheduler), scheduleFn(fn) {}
 
   /**
-   Constructs a no-op scheduler for standalone runtimes (e.g. tests).
-   Scheduled tasks are executed synchronously by the caller.
+   Constructs a no-op scheduler. Scheduled tasks run synchronously on the
+   caller's thread — intended for standalone runtimes (e.g. tests) that have
+   no React scheduler.
    */
   RuntimeScheduler() {}
 
-  RuntimeScheduler(const RuntimeScheduler &) = delete; // non-copyable
+  RuntimeScheduler(const RuntimeScheduler &) = delete;
 
   /**
    Whether the scheduler can dispatch work asynchronously to the JS thread.
    When false, tasks run synchronously and callers should avoid dispatching to background queues.
    */
   bool supportsAsyncScheduling() const noexcept {
-    return reactRuntimeScheduler != nullptr;
+    return scheduleFn != nullptr;
   }
 
-  using ScheduleTaskCallback = void(^)();
-
-  void scheduleTask(react::SchedulerPriority priority, ScheduleTaskCallback callback) noexcept {
-    if (reactRuntimeScheduler) {
-      reactRuntimeScheduler->scheduleTask(priority, [callback = std::move(callback)](jsi::Runtime &runtime) {
-        callback();
-      });
+  void scheduleTask(Priority priority, ScheduleTaskCallback callback) noexcept {
+    if (scheduleFn != nullptr) {
+      scheduleFn(nativeScheduler, static_cast<int>(priority), callback);
     } else {
       callback();
     }

package/apple/scripts/build-xcframework.sh

@@ -89,8 +89,10 @@ compute_hash() {
   # Force C locale so sort order is consistent regardless of the environment.
   # Xcode build phases run without locale variables, which changes sort ordering.
   (
-    # Include PODS_ROOT so switching between worktrees invalidates the cache.
+    # Include PODS_ROOT and RN_ROOT so switching between worktrees or RN
+    # sources invalidates the cache.
     echo "PODS_ROOT=${PODS_ROOT:-}"
+    echo "RN_ROOT=${RN_ROOT:-}"
     echo "$all_files" | LC_ALL=C sort | while IFS= read -r file; do
       echo "$file"
       cat "$file"
@@ -243,12 +245,20 @@ fi
 # whether PODS_ROOT was passed as relative or absolute.
 PODS_ROOT="$(cd "$PODS_ROOT" && pwd)"
 
-# Resolve react-native via Node so the build works in any node_modules layout
-# (hoisted monorepos, yarn/pnpm workspaces). Falls back to the relative path
-# when `node` is unavailable. Forwarded to Package.swift and the modulemap
-# generator below.
-RN_ROOT="$(node -p 'require("path").dirname(require.resolve("react-native/package.json"))' 2>/dev/null \
-  || echo "${PODS_ROOT}/../../node_modules/react-native")"
+# Resolve react-native. Order:
+#   1. REACT_NATIVE_PATH env var (set by Xcode from the Podfile's build setting)
+#      — for hosts that build RN from a non-npm location, e.g. Expo Go which
+#      uses the `react-native-lab/react-native` submodule, not node_modules.
+#   2. `node -p require.resolve(...)` so the script works in any node_modules
+#      layout (hoisted monorepos, pnpm/yarn workspaces).
+#   3. Relative fallback from PODS_ROOT for when `node` isn't on PATH.
+# Forwarded to Package.swift and the modulemap generator below.
+if [[ -n "${REACT_NATIVE_PATH:-}" && -d "${REACT_NATIVE_PATH}" ]]; then
+  RN_ROOT="$(cd "$REACT_NATIVE_PATH" && pwd)"
+else
+  RN_ROOT="$(node -p 'require("path").dirname(require.resolve("react-native/package.json"))' 2>/dev/null \
+    || echo "${PODS_ROOT}/../../node_modules/react-native")"
+fi
 
 mode="$( [[ -d "${PODS_ROOT}/React-Core-prebuilt/React.xcframework" ]] && echo "prebuilt RN" || echo "source-built RN")"
 [[ -f "${PODS_ROOT}/Target Support Files/React-jsi/React-jsi-umbrella.h" ]] && mode="${mode}, static frameworks"

package/apple/scripts/generate-modulemap.sh

@@ -38,7 +38,10 @@ mkdir -p "$GENERATED_DIR"
 
 JSI_UMBRELLA="${PODS_ROOT}/Headers/Public/React-jsi/jsi/jsi.h"
 if [[ ! -f "$JSI_UMBRELLA" ]]; then
-  RN="${RN_ROOT:-$(node -p 'require("path").dirname(require.resolve("react-native/package.json"))' 2>/dev/null || echo "${PODS_ROOT}/../../node_modules/react-native")}"
+  # Resolution order matches build-xcframework.sh: RN_ROOT (forwarded by the
+  # build script), REACT_NATIVE_PATH (exported by Xcode for hosts like Expo Go
+  # that build RN from a submodule), node resolve, then a relative fallback.
+  RN="${RN_ROOT:-${REACT_NATIVE_PATH:-$(node -p 'require("path").dirname(require.resolve("react-native/package.json"))' 2>/dev/null || echo "${PODS_ROOT}/../../node_modules/react-native")}}"
   JSI_UMBRELLA="${RN}/ReactCommon/jsi/jsi/jsi.h"
 fi
 [[ -f "$JSI_UMBRELLA" ]] || { echo "error: cannot locate jsi.h" >&2; exit 1; }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "expo-modules-jsi",
-  "version": "56.0.2",
+  "version": "56.0.3",
   "description": "The JavaScript Interface for Expo Modules",
   "main": "index.js",
   "sideEffects": [],
@@ -41,7 +41,7 @@
       "./apple/scripts/test.sh"
     ]
   },
-  "gitHead": "a30353e69ca0d72b9fac5830abc631feda1ba3ae",
+  "gitHead": "42013232893cb2aa71ab218e9b422d4a8476b3f0",
   "scripts": {
     "build": "apple/scripts/build-xcframework.sh",
     "test": "apple/scripts/test.sh"