expo-updates 57.0.14 → 57.0.15

package/CHANGELOG.md

@@ -10,6 +10,10 @@
 
 ### 💡 Others
 
+## 57.0.15 — 2026-08-17
+
+_This version does not introduce any user-facing changes._
+
 ## 57.0.14 — 2026-08-14
 
 ### 🐛 Bug fixes

package/android/build.gradle

@@ -42,7 +42,7 @@ expoModule {
 }
 
 group = 'host.exp.exponent'
-version = '57.0.14'
+version = '57.0.15'
 
 // 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 '57.0.14'
+    versionName '57.0.15'
     consumerProguardFiles("proguard-rules.pro")
     testInstrumentationRunner "androidx.test.runner.AndroidJUnitRunner"
 

package/ios/EXUpdates/AppLauncher/AppLauncherWithDatabase.swift

@@ -32,6 +32,11 @@ public class AppLauncherWithDatabase: NSObject, AppLauncher {
   public var launchAssetUrl: URL?
   public var assetFilesMap: [String: String]?
 
+  /// Set when the launched update is served directly from the embedded app binary. Tracked
+  /// explicitly because `assetFilesMap` is now populated with the bundle-resolved embedded assets,
+  /// so it can no longer double as the "using embedded assets" signal.
+  private var launchedFromEmbeddedBundle = false
+
   private let launcherQueue: DispatchQueue
   private var completedAssets: Int
   private let config: UpdatesConfig
@@ -54,7 +59,7 @@ public class AppLauncherWithDatabase: NSObject, AppLauncher {
   }
 
   public func isUsingEmbeddedAssets() -> Bool {
-    return assetFilesMap == nil
+    return launchedFromEmbeddedBundle
   }
 
   public static func launchableUpdate(
@@ -178,7 +183,10 @@ public class AppLauncherWithDatabase: NSObject, AppLauncher {
     }
 
     if launchedUpdate.status == UpdateStatus.StatusEmbedded {
-      precondition(assetFilesMap == nil, "assetFilesMap should be null for embedded updates")
+      launchedFromEmbeddedBundle = true
+      // The embedded update's assets aren't copied into the cache, so resolve them from the app
+      // binary. Populating the map here keeps `Updates.localAssets` available instead of empty.
+      assetFilesMap = UpdatesUtils.embeddedAssetsMap(withConfig: config, database: database, logger: logger)
       launchAssetUrl = updatesBundle.url(
         forResource: EmbeddedAppLoader.EXUpdatesBareEmbeddedBundleFilename,
         withExtension: EmbeddedAppLoader.EXUpdatesBareEmbeddedBundleFileType

package/ios/EXUpdates/AppLoader/EmbeddedAppLoader.swift

@@ -8,14 +8,12 @@
 import Foundation
 
 /**
- * Subclass of AppLoader which handles copying the embedded update's assets into the
- * expo-updates cache location.
+ * Subclass of AppLoader which loads the embedded update.
  *
- * Rather than launching the embedded update directly from its location in the app bundle/apk, we
- * first try to read it into the expo-updates cache and database and launch it like any other
- * update. The benefits of this include (a) a single code path for launching most updates and (b)
- * assets included in embedded updates and copied into the cache in this way do not need to be
- * redownloaded if included in future updates.
+ * By default (`EX_UPDATES_COPY_EMBEDDED_ASSETS` off) the update is registered but its assets aren't
+ * read into the database; it keeps StatusEmbedded and launches from the app binary, so first launch
+ * stays fast. When the flag is on, assets are read into the database and it launches like any other
+ * update, so a later update reusing them avoids a redownload.
  */
 @objc(EXUpdatesEmbeddedAppLoader)
 @objcMembers
@@ -29,6 +27,24 @@ public final class EmbeddedAppLoader: AppLoader {
 
   private static var embeddedManifestInternal: EmbeddedUpdate?
 
+  /// Whether to read and hash embedded assets into the database on first launch. Defaults to the
+  /// build-time `EX_UPDATES_COPY_EMBEDDED_ASSETS` flag (off). Overridable for testing.
+  internal var shouldCopyEmbeddedAssets: Bool = UpdatesUtils.shouldCopyEmbeddedAssets()
+
+  internal let completionQueue: DispatchQueue
+
+  public required override init(
+    config: UpdatesConfig,
+    logger: UpdatesLogger,
+    database: UpdatesDatabase,
+    directory: URL,
+    launchedUpdate: Update?,
+    completionQueue: DispatchQueue
+  ) {
+    self.completionQueue = completionQueue
+    super.init(config: config, logger: logger, database: database, directory: directory, launchedUpdate: launchedUpdate, completionQueue: completionQueue)
+  }
+
   /**
    Gets the embedded update.
    If the `UpdatesConfig.hasEmbeddedUpdate` is false, it returns nil
@@ -136,6 +152,18 @@ public final class EmbeddedAppLoader: AppLoader {
     self.assetBlock = assetBlock
     self.successBlock = successBlock
     self.errorBlock = errorBlock
+    startEmbeddedLoad(fromEmbeddedManifest: embeddedManifest)
+  }
+
+  /// Loads the embedded update: with copying off (default) registers it without ingesting assets,
+  /// otherwise loads them like any other update. Separate from `loadUpdateResponseFromEmbeddedManifest`
+  /// so tests can pass a manifest without reading the bundle.
+  internal func startEmbeddedLoad(fromEmbeddedManifest embeddedManifest: Update) {
+    if !shouldCopyEmbeddedAssets {
+      registerEmbeddedUpdateWithoutCopying(embeddedManifest)
+      return
+    }
+
     startLoading(fromUpdateResponse: UpdateResponse(
       responseHeaderData: nil,
       manifestUpdateResponsePart: ManifestUpdateResponsePart(updateManifest: embeddedManifest),
@@ -143,6 +171,40 @@ public final class EmbeddedAppLoader: AppLoader {
     ))
   }
 
+  /// Registers the embedded update without reading, hashing, or copying its assets. A StatusEmbedded
+  /// update resolves its bundle and assets from the app binary at launch. Tradeoff: a future update
+  /// reusing an embedded asset re-downloads it.
+  private func registerEmbeddedUpdateWithoutCopying(_ embeddedManifest: Update) {
+    database.databaseQueue.async {
+      do {
+        let existingUpdate = try? self.database.update(withId: embeddedManifest.updateId, config: self.config)
+        if existingUpdate == nil {
+          try self.database.addUpdate(embeddedManifest, config: self.config)
+        }
+        // Mark finished (keep = 1) so the reaper retains it; it stays StatusEmbedded since copying is off.
+        try self.database.markUpdateFinished(embeddedManifest)
+      } catch {
+        let errorBlock = self.errorBlock
+        self.completionQueue.async {
+          errorBlock?(UpdatesError.appLoaderUnknownError(cause: error))
+          self.reset()
+        }
+        return
+      }
+
+      let successBlock = self.successBlock
+      let updateResponse = UpdateResponse(
+        responseHeaderData: nil,
+        manifestUpdateResponsePart: ManifestUpdateResponsePart(updateManifest: embeddedManifest),
+        directiveUpdateResponsePart: nil
+      )
+      self.completionQueue.async {
+        successBlock?(updateResponse)
+        self.reset()
+      }
+    }
+  }
+
   override public func downloadAsset(_ asset: UpdateAsset, extraHeaders: [String: Any]) {
     FileDownloader.assetFilesQueue.async {
       self.handleAssetDownloadAlreadyExists(asset)

package/ios/EXUpdates/Database/UpdatesDatabase.swift

@@ -280,7 +280,11 @@ public final class UpdatesDatabase: NSObject {
   }
 
   public func markUpdateFinished(_ update: Update) throws {
-    if update.status != UpdateStatus.StatusDevelopment {
+    // With copying off, embedded updates have no asset rows, so they must stay StatusEmbedded to keep
+    // launching from the bundle. Promoting to StatusReady would route launch through the database
+    // asset path, which has no rows for them.
+    let keepEmbedded = update.status == UpdateStatus.StatusEmbedded && !UpdatesUtils.shouldCopyEmbeddedAssets()
+    if update.status != UpdateStatus.StatusDevelopment && !keepEmbedded {
       update.status = UpdateStatus.StatusReady
     }
 

package/ios/EXUpdates/UpdatesUtils.swift

@@ -182,6 +182,14 @@ public final class UpdatesUtils: NSObject {
 #endif
   }
 
+  internal static func shouldCopyEmbeddedAssets() -> Bool {
+#if EX_UPDATES_COPY_EMBEDDED_ASSETS
+    return true
+#else
+    return false
+#endif
+  }
+
   internal static func runBlockOnMainThread(_ block: @escaping () -> Void) {
     if Thread.isMainThread {
       block()

package/ios/EXUpdates.podspec

@@ -9,6 +9,9 @@ end
 if ENV['EX_UPDATES_CUSTOM_INIT'] != '1'
   ENV['EX_UPDATES_CUSTOM_INIT'] = podfile_properties['updatesCustomInit'] == 'true' ? '1' : '0'
 end
+if ENV['EX_UPDATES_COPY_EMBEDDED_ASSETS'] != '1'
+  ENV['EX_UPDATES_COPY_EMBEDDED_ASSETS'] = podfile_properties['updatesCopyEmbeddedAssets'] == 'true' ? '1' : '0'
+end
 
 use_dev_client = false
 begin
@@ -72,6 +75,7 @@ Pod::Spec.new do |s|
 
   ex_updates_native_debug = ENV['EX_UPDATES_NATIVE_DEBUG'] == '1'
   ex_updates_custom_init = ENV['EX_UPDATES_CUSTOM_INIT'] == '1'
+  ex_updates_copy_embedded_assets = ENV['EX_UPDATES_COPY_EMBEDDED_ASSETS'] == '1'
   if ex_updates_native_debug
     other_debug_c_flags << ' -DEX_UPDATES_NATIVE_DEBUG=1'
     other_debug_swift_flags << ' -DEX_UPDATES_NATIVE_DEBUG'
@@ -82,6 +86,12 @@ Pod::Spec.new do |s|
     other_release_c_flags << ' -DEX_UPDATES_CUSTOM_INIT=1'
     other_release_swift_flags << ' -DEX_UPDATES_CUSTOM_INIT'
   end
+  if ex_updates_copy_embedded_assets
+    other_debug_c_flags << ' -DEX_UPDATES_COPY_EMBEDDED_ASSETS=1'
+    other_debug_swift_flags << ' -DEX_UPDATES_COPY_EMBEDDED_ASSETS'
+    other_release_c_flags << ' -DEX_UPDATES_COPY_EMBEDDED_ASSETS=1'
+    other_release_swift_flags << ' -DEX_UPDATES_COPY_EMBEDDED_ASSETS'
+  end
   if use_dev_client
     other_debug_c_flags << ' -DUSE_DEV_CLIENT=1'
     other_debug_swift_flags << ' -DUSE_DEV_CLIENT'

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "expo-updates",
-  "version": "57.0.14",
+  "version": "57.0.15",
   "description": "Fetches and manages remotely-hosted assets and updates to your app's JS bundle.",
   "main": "build/index.js",
   "types": "build/index.d.ts",
@@ -60,9 +60,9 @@
     "picomatch": "^4.0.4",
     "ts-node": "^10.9.2",
     "xstate": "^4.37.2",
+    "expo": "57.0.14",
     "@expo/metro-config": "57.0.8",
-    "expo-dev-client": "57.0.12",
-    "expo": "57.0.13",
+    "expo-dev-client": "57.0.13",
     "expo-module-scripts": "56.0.3"
   },
   "peerDependencies": {
@@ -82,7 +82,7 @@
       "./scripts/with-node.sh"
     ]
   },
-  "gitHead": "125b8d4472432db3dc4ae047730432d7bd5bd30c",
+  "gitHead": "391d762fa5059cebf63ef2381da93994ce97fc63",
   "scripts": {
     "build": "expo-module build",
     "clean": "expo-module clean",