expo-updates 55.0.20 → 55.0.21

package/CHANGELOG.md

@@ -10,11 +10,19 @@
 
 ### 💡 Others
 
+## 55.0.21 — 2026-04-21
+
+### 💡 Others
+
+- [ios] resolve Expo.plist lookup in brownfield xcframework builds ([#44645](https://github.com/expo/expo/pull/44645) by [@gabrieldonadel](https://github.com/gabrieldonadel))
+- [ios] Support multiple root view creations in brownfield ([#44771](https://github.com/expo/expo/pull/44771) by [@gabrieldonadel](https://github.com/gabrieldonadel))
+
 ## 55.0.20 — 2026-04-09
 
 ### 🐛 Bug fixes
 
 - Pass absolute path to CLI helpers when creating build manifest, since the underlying functions now handle entry file inputs properly, instead of applying `mainModuleName` semantics to them ([#44414](https://github.com/expo/expo/pull/44414) by [@kitten](https://github.com/kitten))
+- [ios] Fix loading assets in brownfield ([#44724](https://github.com/expo/expo/pull/44724) by [@gabrieldonadel](https://github.com/gabrieldonadel))
 
 ## 55.0.19 — 2026-04-07
 

package/android/build.gradle

@@ -42,7 +42,7 @@ expoModule {
 }
 
 group = 'host.exp.exponent'
-version = '55.0.20'
+version = '55.0.21'
 
 // Utility method to derive boolean values from the environment or from Java properties,
 // and return them as strings to be used in BuildConfig fields
@@ -89,7 +89,7 @@ android {
   namespace "expo.modules.updates"
   defaultConfig {
     versionCode 31
-    versionName '55.0.20'
+    versionName '55.0.21'
     consumerProguardFiles("proguard-rules.pro")
     testInstrumentationRunner "androidx.test.runner.AndroidJUnitRunner"
 

package/ios/EXUpdates/AppController.swift

@@ -149,6 +149,7 @@ public protocol InternalAppControllerInterface: AppControllerInterface {
   var reloadScreenManager: Reloadable? { get }
 
   var eventManager: UpdatesEventManager { get }
+  var isStarted: Bool { get }
   func onEventListenerStartObserving()
 
   func getConstantsForModule() -> UpdatesModuleConstants

package/ios/EXUpdates/AppLauncher/AppLauncherNoDatabase.swift

@@ -21,7 +21,7 @@ public final class AppLauncherNoDatabase: NSObject, AppLauncher {
 
   public func launchUpdate() {
     precondition(assetFilesMap == nil, "assetFilesMap should be null for embedded updates")
-    launchAssetUrl = Bundle.main.url(
+    launchAssetUrl = updatesBundle.url(
       forResource: EmbeddedAppLoader.EXUpdatesBareEmbeddedBundleFilename,
       withExtension: EmbeddedAppLoader.EXUpdatesBareEmbeddedBundleFileType
     )

package/ios/EXUpdates/AppLauncher/AppLauncherWithDatabase.swift

@@ -179,7 +179,7 @@ public class AppLauncherWithDatabase: NSObject, AppLauncher {
 
     if launchedUpdate.status == UpdateStatus.StatusEmbedded {
       precondition(assetFilesMap == nil, "assetFilesMap should be null for embedded updates")
-      launchAssetUrl = Bundle.main.url(
+      launchAssetUrl = updatesBundle.url(
         forResource: EmbeddedAppLoader.EXUpdatesBareEmbeddedBundleFilename,
         withExtension: EmbeddedAppLoader.EXUpdatesBareEmbeddedBundleFileType
       )

package/ios/EXUpdates/DevLauncherAppController.swift

@@ -55,6 +55,7 @@ public final class DevLauncherAppController: NSObject, InternalAppControllerInte
   public var embeddedUpdateId: UUID?
 
   public var isEnabled: Bool
+  public let isStarted = false
 
   public let eventManager: UpdatesEventManager = NoOpUpdatesEventManager()
   public var reloadScreenManager: Reloadable? = ReloadScreenManager()

package/ios/EXUpdates/DisabledAppController.swift

@@ -29,7 +29,7 @@ public class DisabledAppController: InternalAppControllerInterface, UpdatesInter
   public var reloadScreenManager: Reloadable?
 
   public let isActiveController = false
-  private var isStarted: Bool = false
+  public private(set) var isStarted: Bool = false
   private var startupStartTime: DispatchTime?
   private var startupEndTime: DispatchTime?
 

package/ios/EXUpdates/EnabledAppController.swift

@@ -39,7 +39,7 @@ public class EnabledAppController: InternalAppControllerInterface, UpdatesInterf
   private let updatesDirectoryInternal: URL
   private let controllerQueue = DispatchQueue(label: "expo.controller.ControllerQueue")
   public let isActiveController = true
-  private var isStarted = false
+  public private(set) var isStarted = false
   private var startupStartTime: DispatchTime?
   private var startupEndTime: DispatchTime?
 

package/ios/EXUpdates/ReactDelegateHandler/ExpoUpdatesReactDelegateHandler.swift

@@ -32,10 +32,24 @@ public final class ExpoUpdatesReactDelegateHandler: ExpoReactDelegateHandler, Ap
       return nil
     }
 
+    // If startup already completed, create the real view directly to handle
+    // brownfield re-mounts and simultaneous multi-view scenarios, given that
+    // didStartWithSuccess fires only once per controller lifetime.
+    if controller.isStarted, let launchAssetUrl = controller.launchAssetUrl() {
+      return reactDelegate.reactNativeFactory.recreateRootView(
+        withBundleURL: launchAssetUrl,
+        moduleName: moduleName,
+        initialProps: initialProperties,
+        launchOptions: launchOptions
+      )
+    }
+
     self.reactDelegate = reactDelegate
     self.launchOptions = launchOptions
-    controller.delegate = self
-    controller.start()
+    if !controller.isStarted {
+      controller.delegate = self
+      controller.start()
+    }
 
     self.rootViewModuleName = moduleName
     self.rootViewInitialProperties = initialProperties
@@ -83,14 +97,27 @@ public final class ExpoUpdatesReactDelegateHandler: ExpoReactDelegateHandler, Ap
       launchOptions: self.launchOptions
     )
 
-    let window = getWindow()
-    let rootViewController = reactDelegate.createRootViewController()
 #if os(iOS) || os(tvOS)
     rootView.backgroundColor = self.deferredRootView?.backgroundColor ?? UIColor.white
-    rootViewController.view = rootView
-    window.rootViewController = rootViewController
-    window.makeKeyAndVisible()
+
+    // In brownfield setups, the deferred root view is embedded within the host app's
+    // view hierarchy (e.g. inside a NavigationController). Replacing the window's root
+    // view controller would break the host app's navigation. Instead, find the view
+    // controller that owns the deferred view and replace its view in-place.
+    if let deferredRootView = self.deferredRootView,
+      let owningViewController = findViewController(for: deferredRootView),
+      owningViewController != getWindow().rootViewController {
+      owningViewController.view = rootView
+    } else {
+      let window = getWindow()
+      let rootViewController = reactDelegate.createRootViewController()
+      rootViewController.view = rootView
+      window.rootViewController = rootViewController
+      window.makeKeyAndVisible()
+    }
 #else
+    let window = getWindow()
+    let rootViewController = reactDelegate.createRootViewController()
     rootViewController.view = rootView
     rootView.frame = window.frame
     window.contentViewController = rootViewController
@@ -133,6 +160,22 @@ public final class ExpoUpdatesReactDelegateHandler: ExpoReactDelegateHandler, Ap
 
     return view
   }
+
+  /**
+   Finds the nearest view controller that owns the given view by walking
+   up the responder chain. Returns the first UIViewController whose view
+   matches the target view.
+   */
+  private func findViewController(for view: UIView) -> UIViewController? {
+    var responder: UIResponder? = view.next
+    while let current = responder {
+      if let viewController = current as? UIViewController, viewController.view == view {
+        return viewController
+      }
+      responder = current.next
+    }
+    return nil
+  }
 #endif
 
   private func getWindow() -> UIWindow {

package/ios/EXUpdates/UpdatesConfig.swift

@@ -145,7 +145,7 @@ public final class UpdatesConfig: NSObject {
   }
 
   private static func configDictionaryWithExpoPlist(mergingOtherDictionary: [String: Any]?) throws -> [String: Any] {
-    guard let configPlistPath = Bundle.main.path(forResource: PlistName, ofType: "plist") else {
+    guard let configPlistPath = updatesBundle.path(forResource: PlistName, ofType: "plist") else {
       throw UpdatesConfigError.ExpoUpdatesConfigPlistError
     }
 

package/ios/EXUpdates/UpdatesUtils.swift

@@ -16,6 +16,22 @@ internal extension Array where Element: Equatable {
   }
 }
 
+/**
+ * In brownfield setups the Expo project is packaged as an xcframework, so
+ * resources like Expo.plist, main.jsbundle, and image assets live in the
+ * framework bundle instead of the host app's main bundle.
+ *
+ * `updatesBundle` resolves to whichever bundle actually contains the
+ * expo-updates resources at runtime: `Bundle.main` for standard apps,
+ * or the framework bundle for brownfield xcframeworks.
+ */
+internal let updatesBundle: Bundle = {
+  if Bundle.main.path(forResource: "Expo", ofType: "plist") != nil {
+    return Bundle.main
+  }
+  return Bundle(for: UpdatesUtils.self)
+}()
+
 @objc(EXUpdatesUtils)
 @objcMembers
 public final class UpdatesUtils: NSObject {
@@ -110,16 +126,16 @@ public final class UpdatesUtils: NSObject {
 
   internal static func url(forBundledAsset asset: UpdateAsset) -> URL? {
     guard let mainBundleDir = asset.mainBundleDir else {
-      return Bundle.main.url(forResource: asset.mainBundleFilename, withExtension: asset.type)
+      return updatesBundle.url(forResource: asset.mainBundleFilename, withExtension: asset.type)
     }
-    return Bundle.main.url(forResource: asset.mainBundleFilename, withExtension: asset.type, subdirectory: mainBundleDir)
+    return updatesBundle.url(forResource: asset.mainBundleFilename, withExtension: asset.type, subdirectory: mainBundleDir)
   }
 
   internal static func path(forBundledAsset asset: UpdateAsset) -> String? {
     guard let mainBundleDir = asset.mainBundleDir else {
-      return Bundle.main.path(forResource: asset.mainBundleFilename, ofType: asset.type)
+      return updatesBundle.path(forResource: asset.mainBundleFilename, ofType: asset.type)
     }
-    return Bundle.main.path(forResource: asset.mainBundleFilename, ofType: asset.type, inDirectory: mainBundleDir)
+    return updatesBundle.path(forResource: asset.mainBundleFilename, ofType: asset.type, inDirectory: mainBundleDir)
   }
 
   /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "expo-updates",
-  "version": "55.0.20",
+  "version": "55.0.21",
   "description": "Fetches and manages remotely-hosted assets and updates to your app's JS bundle.",
   "main": "build/index.js",
   "types": "build/index.d.ts",
@@ -45,9 +45,9 @@
     "chalk": "^4.1.2",
     "debug": "^4.3.4",
     "expo-eas-client": "~55.0.5",
-    "expo-manifests": "~55.0.15",
+    "expo-manifests": "~55.0.16",
     "expo-structured-headers": "~55.0.2",
-    "expo-updates-interface": "~55.1.5",
+    "expo-updates-interface": "~55.1.6",
     "getenv": "^2.0.0",
     "glob": "^13.0.0",
     "ignore": "^5.3.1",
@@ -71,5 +71,5 @@
     "react": "*",
     "react-native": "*"
   },
-  "gitHead": "b0ada30fd6a819c5f98a23d99b1b89a2ed68743d"
+  "gitHead": "e37e614d97c3ca53f16b91609a787675d044c284"
 }