expo-modules-core

Patch Changes

• [iOS] Reduce the overhead of returning Data and shared objects to JavaScript.

• [Android] Fix a Jetpack Compose Host that stays blank when it mounts in a visible list row with removeClippedSubviews enabled, for example in a FlatList. The Host now measures its content when it is attached for the first time.

• [iOS] Update expo-modules-macros to 0.21.0. @Record types now convert between JavaScript and native code with less overhead and no longer need an app context. @ExpoModule and @SharedObject now report a build error when two @JS members of one object have the same JavaScript name, because JavaScript could reach only one of them.

• Shared objects now report their class name from Object.prototype.toString, for example [object VideoPlayer]. React in development builds no longer deep-compares shared objects in props, which threw ERR_NATIVE_SHARED_OBJECT_NOT_FOUND when the previous props held a released shared object. Blob from expo-blob and File from expo-file-system now report [object Blob] and [object File], as on the web. Libraries that detect these types by this tag now treat them as a Blob and a File.

Patch Changes

• [Android] Fix native memory that grew with each module class under Hermes V1, by about 0.57 MiB per class on React Native 0.86 and 0.87 and about 93 KiB on 0.88. createClass evaluated a new JavaScript source for each class, and Hermes keeps memory for every evaluated source until the runtime is destroyed. It now evaluates one class factory for each runtime and calls it for each class. On iOS, this code creates only the four base classes (SharedObject, SharedRef, EventEmitter and NativeModule).

• Fix an -Wunused-result warning in Worklet.cpp on Android when building with react-native-worklets@0.13. Running a worklet synchronously now discards its return value while the worklet runtime lock is still held, on Android and iOS.

• Fix the Do not include this file directly warnings from react-native-worklets@0.13 on Android and iOS. The worklets integration now includes the specific Serializable headers instead of the deprecated worklets/SharedItems/Serializable.h.

Patch Changes

• [iOS] Speed up module registration at app launch by classifying definition elements without protocol conformance lookups.

• [iOS] Reduced the overhead of emitting events without a payload.

• [iOS] Speed up app launch by computing default module, class and view names without protocol conformance lookups.

• [iOS] Publish a headers XCFramework for ExpoModulesCore with the package, at prebuilds/output/headers/xcframeworks/ExpoModulesCoreHeaders.tar.gz.

• [iOS] Add isFunction(), isTypedArray(), isArrayBuffer(), getTypedArray(in:), getArrayBuffer(in:), getBigInt(in:) and kind to JavaScriptUnownedValue. Data, typed arrays, ArrayBuffer and integers from a BigInt now decode function arguments without copying them into an owning JavaScriptValue: a Data argument is about 10% faster to decode, and an Int64 from a BigInt about 8× faster.

• [Internal] Drop unused EXPO_PROJECT_ROOT and EXPO_ROUTER_ABS_APP_ROOT variables and corresponding invalidation.

Patch Changes

• [iOS] Fix slow cold launches in brownfield apps where the ExpoModulesProvider lookup scanned Bundle.allFrameworks inside +load. The lookup now tries the framework that contains ExpoModulesCore before falling back to the scan.

• [iOS] Update expo-modules-macros to 0.20.0, which binds @JS functions and setters that return nothing through the Void overload, so they no longer build an undefined value on each call.

• [iOS] Reduced the overhead of emitting module events.

Patch Changes

• [iOS] Fix a launch crash (Symbol not found: _swift_allocateMetadataPack) in apps that use precompiled Expo modules and build with Xcode 27. ExpoModulesJSI no longer exports Swift runtime symbols, so the precompiled ExpoModulesCore no longer depends on them.

• [iOS] Fix a UIViewControllerHierarchyInconsistency crash when a SwiftUI view (such as @expo/ui's Host) is rendered inside a text input's accessory view, for example React Native's InputAccessoryView or react-native-keyboard-controller's KeyboardExtender.

Patch Changes

• [Internal] Bump precompiled artifacts due to ABI breakage in expo-modules-jsi, which makes JavaScriptValue a non-copyable struct.

• [iOS] Update expo-modules-macros to 0.16.0, which supports closure arguments in @JS functions and initializers.

• [iOS] [Internal] Hold cached JavaScript values and the encoder and decoder state behind JavaScriptRef.

• [Android] Fix build errors with React Native nightlies by removing an unneeded enableCppPropsIteratorSetter check from Expo views.

• breaking

  [iOS] Make JavaScriptValue a non-copyable struct. This is a breaking change for Swift code that uses JavaScriptValue directly:

  • Values are moved, not shared. Pass them as borrowing or consuming parameters, and call copy() where a second owned value is needed.

  • JavaScriptValue.undefined and JavaScriptValue.null are functions now: write .undefined() and .null().

  • A JavaScriptValue can no longer be an argument or a result of a Function, AsyncFunction, Property or Field definition. Declare the function with the @JS macro instead (in an @ExpoModule or @SharedObject class) and take the value as borrowing JavaScriptValue, or use a typed argument.

  • To keep a value in an array, an escaping closure or another place that takes copyable types only, wrap it with value.ref() and read it back with take() or withUnwrappedValue(_:).

  • JavaScriptArray.init(_:items:), JavaScriptArray.enumerated(), JavaScriptArray.filter(_:) and JavaScriptValuesBuffer.copying(in:values:) with an array of values are removed. Use the parameter pack initializer, forEach, forEachIndexed, reduce, or the [JavaScriptValue.Ref] overload.

• [iOS] [Internal] Remove copy runtime where a borrowed JavaScriptRuntime is passed to a function, which already borrows its parameters.

• [iOS] Read the properties of a typed array through property names cached per runtime, which makes JavaScriptValue.getTypedArray() about twice as fast. getTypedArray() is now isolated to JavaScriptActor, like asTypedArray().

Patch Changes

• [Android] Fix record arguments without @OptimizedRecord (such as ImagePickerOptions in older expo-image-picker versions) failing to convert in minified release builds with The 1st argument cannot be cast to type ... caused by a NullPointerException. Keep the @Field annotation class from being renamed by R8.

• [Android] Fix release builds crashing at launch when the app uses an Expo Modules API 2.0 module, such as expo-crypto. R8 removed classes and members that the v2 runtime reaches through reflection and JNI.

• [Android] Fixed Expo modules not receiving OnCreate when JavaScript reaches the JSI NativeModulesProxy before the legacy one, for example with lazy imports, which made modules like expo-web-browser fail on first use. Its constants are read lazily again, as before #46964.

• [iOS] Fixed JavaScript errors created from native Exceptions using the exception's debug description as their message, which prefixed it with the Swift type name and appended the native file:line (e.g. MyException: reason (at MyModule.swift:42)). The message is the exception's description again, as before the JSI rewrite and as on Android. Exception.message can now be overridden by subclasses; subclasses that already declare a message property need to mark it as override.

• [Android] Fix views sized by Jetpack Compose, such as RNHostView in a ModalBottomSheet, that kept their old size until the keyboard animation ended when the keyboard was dismissed with the predictive back gesture.

• [iOS] Throw when JavaScript constructs a shared object class that has no way to build its native instance, instead of returning an object that fails at its first member access.

• [Android] Warn instead of failing silently when installModules() gives up waiting for an active ReactInstance. Previously JSI interop was installed into a context with no active instance and the method still returned true, so the first visible symptom was globalThis.expo being undefined in JS.

Patch Changes

• [macOS] Attach SwiftUI hosting views even when no NSViewController is in the responder chain, such as a React root view set directly as NSWindow.contentView. Previously, @expo/ui content in such windows rendered nothing.

• [iOS] Update expo-modules-macros to 0.15.0, which generates only the unowned decode for @Union and skips cases whose decodableKinds can't match.

• [Internal] Make AppContext non-final, so that TestAppContext from expo-modules-test-core can subclass it.

• [Android] Fixed a race where a promise resolved and rejected from different threads at the same time could settle twice and throw on the JavaScript thread.

• [Android] An Expo Modules API 2.0 module that throws a CodedException now reports its code to JavaScript.

Patch Changes

• [Internal][Android] expoPublish now formats the updated expo-module.config.json with oxfmt instead of prettier.

• [iOS] Add decodableKinds to JavaScriptDecodable: the kinds of JavaScript value (JavaScriptValueKinds) that decode can accept, so code that picks between several types can skip the ones that can't match.

• [iOS] Add JavaScriptValue.withUnownedValue(in:_:), and give the owning JavaScriptDecodable.decode a default that borrows the value and decodes it through the JavaScriptUnownedValue overload, so a conformer can implement only that one. Arrays, dictionaries, dates, records and enums now decode unowned values without copying them first.

• Fixed native views ignoring aria-*, id and tabIndex props such as aria-hidden and aria-label (#50782).

• Fixed release() throwing on a shared object whose JS object is frozen, for example an ImageRef passed as a view prop in development (#50962).

Patch Changes

• Bump precompiled artifacts due to ABI breakage in expo-modules-jsi@58.0.6.

• [iOS] @Record now accepts properties that hold free-form Any values, such as [String: Any]? or [Any].

• [Android] Fixed Expo views using Android layout not completing system-forced layout passes.

Patch Changes

• Lay out RNHostView hosted content at the size SwiftUI or Compose gives it on an axis that matchContents does not match.

Patch Changes

• Force-bump all packages, due to migration to changesets.

• [iOS] Depend on expo-modules-macros, the new name of the @expo/expo-modules-macros-plugin package.

• [iOS] Fixed a crash (The app context has been lost) when an Expo view mounts during a reload.

New features

• Added Platform.isQuest to detect Meta Quest devices from JavaScript.

Bug fixes

• Preserve shared objects when React Activity becomes hidden, handle Strict Mode replay, and wait for all pending updates before releasing objects.

• [Android] Fixed async functions rejecting with Cannot use shared object that was already released, and sharedObjectDidRelease being called in the middle of a pending call, when the garbage collector took the JS object of a shared object receiver or argument before the call finished.

• [iOS] Fixed nil record fields being omitted instead of returned as null when a function's return type is an optional record.

New features

• [iOS] Added EmbeddedFingerprint, which reads the fingerprint a debug build embedded, with EmbeddedFingerprint.CheckProtocol carrying the literals of the fingerprint-check exchange.

Bug fixes

• [Android] Fixed worklet callbacks crashing with NoSuchFieldError in minified release builds.

• [Android] Replaced the hosting ComposeView's view id with a tag for its rememberSaveable namespace, fixing a crash on react-native-screens tab switch and touches inside a Host reaching the wrong React Native view.

• [macOS] Fixed a crash when mounting a SwiftUI view in a release build. react-native-macos assigns component view tags through reactTag, which the virtual view did not declare.

• [Android] Fixed strings losing NUL characters when crossing JNI in either direction, and characters outside the BMP being misread on the way to Kotlin.

• [iOS] Fixed the tap that closes a SwiftUI menu still reaching the React Native view underneath it in apps with no accessibility client attached. The menu gate no longer requires accessibilityViewIsModal, which UIKit only implements for the menu container while its accessibility bundle is loaded.

Others

• [iOS] Bumped @expo/expo-modules-macros-plugin to 0.12.0.

• [Android] Use the prebuilt native libraries in every build, including the package's own instrumentation tests, drop the libraryVersion check so the archive stays valid across patch releases, and add the expo.core.buildFromSource Gradle property to opt out.

New features

• [iOS] Added the @Union macro that turns an enum whose cases each carry one associated value into a typed union (A | B in TypeScript), usable as a @JS argument or return value.

• [iOS] Added the .concurrent option to @JS (@JS(.concurrent)), which runs the body of an async function off the JavaScript thread.

Others

• [iOS] Bumped @expo/expo-modules-macros-plugin to 0.10.0.

• [iOS] Made Either, EitherOfThree and EitherOfFour conform to JavaScriptDecodable and JavaScriptEncodable, so they can be used with the new module API.

Breaking changes

• breaking

  [Android] Removed the deprecated AppContext.hostingRuntimeContext property. Use AppContext.runtime instead.

• breaking

  [Android] Removed the deprecated AppContext.errorManager property. Use AppContext.jsLogger instead.

• breaking

  [Android] Replaced the old ArrayBuffer interface with a concrete class, so NativeArrayBuffer and JavaScriptArrayBuffer no longer share a common ArrayBuffer supertype.

• breaking

  [Android] Introduce ConverterContext.

• breaking

  [iOS] Removed EXUtilities.screenScale, which cached the main screen's scale for the process lifetime. Read the scale from the view's trait collection instead.

New features

• [macOS] Added UIColor, UIGestureRecognizer and UITextContentType to the AppKit compatibility aliases in Platform.swift.

• Added ExpoSwiftUI.HostingViewAware, an opt-in protocol for view props that receive the view hosting their SwiftUI view, so a view can resolve its own window instead of a process-global one.

• [Android] Added a loadImageForManipulationFromURL overload to ImageLoaderInterface that decodes the image within the given maxWidth/maxHeight bounds.

• Add useReleasingSharedObjectWithLifecycle hook.

• deprecated

  Added ArrayBuffer as the preferred safe native module argument and return type, and deprecated NativeArrayBuffer in favor of it.

• [iOS] Added module lifecycle hooks that replace the OnCreate, OnDestroy, OnStartObserving and OnStopObserving DSL components: didCreate, willDestroy, didStartListening and didStopListening.

• [Android] Support PlatformColor as Color.

• [Android] Added ArrayBuffer.withJSBytes for safe scoped access to underlying bytes from any thread.

• Added getNativeRef() to views created with requireNativeViewManager, which returns the underlying host component.

Bug fixes

• [iOS] Fixed SwiftUI view mounting blocking the main thread: ViewProps and ShadowNodeProxy now store their objectWillChange publisher instead of resolving it through Combine's global observable-object table on every access.

• [iOS] Fixed the tap that closes a SwiftUI menu still sending touchStart, onPressIn and onPressOut to the React Native view underneath it. React Native's touch handler is now told to skip that tap before UIKit delivers it, instead of being cancelled afterwards.

• [Web] Type registerWebModule as returning an instance of the module class rather than the class itself, matching what it returns at runtime.

• [Android] Fix Expo module views not receiving props with React Native 0.87.

• [Android] Fixed BadParcelableException at startup when an activity-result launch was interrupted. DataPersistor read the persisted Bundle with no ClassLoader, so the boot ClassLoader could not resolve androidx.activity.result.ActivityResult.

• [iOS][Android] Fixed a matchContents RNHostView and the matchContents host around it feeding each other's size back and forth, which grew the layout on every pass.

• [iOS] Fixed SwiftUI view props re-decoding every field on every props update. Fabric sends the whole props map rather than a delta, so an unrelated prop change replaced each decoded value with an equal but distinct one, which cost a decode per field and stopped SwiftUI from pruning the view tree that reads it. A field whose raw value is unchanged now keeps the value decoded before, the same way ExpoFabricView.updateProps already worked for UIKit views.

• [iOS] Fixed matchContents hosts sometimes being laid out at a stale size. Regression from #48059.

• [iOS] Fixed an infinite main-thread layout loop (frozen UI, watchdog kill on backgrounding) when a SwiftUI host with matchContents and Yoga persistently disagree on the content size, e.g. with the Button Shapes accessibility setting enabled. Synchronous size commits are now budgeted per run-loop turn; over-budget updates are coalesced on the view and committed asynchronously on the next turn, and no-op size updates no longer dirty the layout. (#48058, #48059

• [iOS] Fixed the ExpoModulesProvider lookup missing the generated class when the app name starts with a digit, which registered no native modules and left release builds on a blank screen.

• [iOS] Fixed the tap that closes a SwiftUI menu also pressing the React Native view underneath it.

• [Android] Fixed hosted Compose views missing layout after reattachment or in-place configuration changes.

• [iOS] Fixed infinite recursion and EXC_BAD_ACCESS when encoding native Date values to JavaScript. (#48239, #48240

• [iOS] Concurrent functions build on the new two-phase createAsyncFunction from expo-modules-jsi again, instead of wiring the promise themselves. This also restores rejecting the returned promise (rather than throwing synchronously) when the app context is lost or argument decoding fails.

• [Android] Support android.graphics.Color arguments and props on Android below API 26 by adding a ColorCompat wrapper, since the class-based Color API (Color.valueOf and the float accessors) only exists on API 26 and above. PlatformColor values now resolve below API 26 too, via React Native's ARGB-int color path.

• [Android] Fix Record arguments crashing with a NullPointerException in R8-optimized release builds when converted through the reflection fallback path.

• [Android] Keep the Record marker interface so its consumer ProGuard rule keeps matching after R8 optimization removes empty marker interfaces.

• [Android] Fix nested Host double-composing children.

• removed

  [Internal] Remove EventEmitter re-export global type indirection

• [iOS] Fix Expo DevTools Network response bodies for JSON content types with parameters.

• [iOS] Resolve the key window from the foregrounded scene in currentViewController() so it keeps working with multiple scenes, and expose Utilities.keyWindow() for modules to reuse.

• [iOS] Fixed a stack overflow crash when converting to JavaScript a Convertible value that keeps the default convertResult implementation, such as CMTime. The value now converts to undefined and logs a warning.

• [iOS] Measure hosted React Native views where SwiftUI placed them, instead of at their Yoga box.

• [Android] Measure hosted React Native views where Jetpack Compose placed them, instead of at their Yoga box.

• [Android] Bump the Gradle plugin's Kotlin version to 2.2.21.

• [Android] Fixed ActivityResultLauncher.launch() throwing IllegalStateException: Attempting to launch an unregistered ActivityResultLauncher after the Activity is recreated, by registering the launcher again against the live Activity.

Others

• [iOS] Bumped @expo/expo-modules-macros-plugin to 0.8.0, which emits the two-phase async @JS bindings.

• [Android] Make expo-module-gradle-plugin compatible with Android Gradle Plugin 9.

• [Android] Ignore already-settled promises.

• iOS Turn getModule(implementing:) into a public function

• [iOS] Added SceneGeometry for reading bounds, safe area, display scale and interface orientation from the scene a view belongs to.

• [iOS] Added SceneGeometry.foregroundScene(), which returns nil when no scene is on screen so callers can avoid presenting UI into a background scene.

• Removed Quick and Nimble in favor of Swift Testing.

• Migrated from deprecated react-native-worklets WorkletRuntime API executeSync to up-to-date runSync. runSync is available since 0.7.0.

• Added internal ExpoModulesProviderModuleName lookup key for ExpoModulesProvider class.

• [iOS] Allow ExpoSwiftUI child collections to reconcile children using a string-based identity.