expo-updates 1.0.0-canary-20250306-d9d3e02 → 1.0.0-canary-20250331-817737a

package/CHANGELOG.md

@@ -10,6 +10,7 @@
 ### 🎉 New features
 
 - Add new state machine context about startup procedure. ([#32433](https://github.com/expo/expo/pull/32433) by [@wschurman](https://github.com/wschurman))
+- Support for updates.useNativeDebug. ([#35468](https://github.com/expo/expo/pull/35468) by [@douglowder](https://github.com/douglowder))
 
 ### 🐛 Bug fixes
 
@@ -25,10 +26,29 @@
 - Fixed build error on iOS Expo Go. ([#34485](https://github.com/expo/expo/pull/34485) by [@kudo](https://github.com/kudo))
 - Fixed Android unit test errors in BuilDataTest. ([#34510](https://github.com/expo/expo/pull/34510) by [@kudo](https://github.com/kudo))
 - [Android] Started using expo modules gradle plugin. ([#34806](https://github.com/expo/expo/pull/34806) by [@lukmccall](https://github.com/lukmccall))
-- Add update id headers to asset requests ([#34453](https://github.com/expo/expo/pull/34453) by [@gabrieldonadel](https://github.com/gabrieldonadel))
 - Drop `fs-extra` in favor of `fs`. ([#35036](https://github.com/expo/expo/pull/35036) by [@kitten](https://github.com/kitten))
 - Drop `fast-glob` in favor of `glob`. ([#35082](https://github.com/expo/expo/pull/35082) by [@kitten](https://github.com/kitten))
 - Drop `fbemitter` in favor of custom emitter. ([#35317](https://github.com/expo/expo/pull/35317) by [@kitten](https://github.com/kitten))
+- E2E tests for custom init. ([#35569](https://github.com/expo/expo/pull/35569) by [@douglowder](https://github.com/douglowder))
+- Refactored `RCTReactNativeFactory` integration. ([#35679](https://github.com/expo/expo/pull/35679) by [@kudo](https://github.com/kudo))
+
+## 0.27.4 - 2025-03-18
+
+### 🎉 New features
+
+- Support brownfield apps with EX_UPDATES_CUSTOM_INIT flag. ([#35391](https://github.com/expo/expo/pull/35391) by [@douglowder](https://github.com/douglowder))
+
+## 0.27.3 - 2025-03-11
+
+### 🐛 Bug fixes
+
+- Pass through the package version to config plugin sync utilities ([#35372](https://github.com/expo/expo/pull/35372) by [@brentvatne](https://github.com/brentvatne))
+
+## 0.27.2 - 2025-02-26
+
+### 💡 Others
+
+- Add update id headers to asset requests ([#34453](https://github.com/expo/expo/pull/34453) by [@gabrieldonadel](https://github.com/gabrieldonadel))
 
 ## 0.27.1 - 2025-02-21
 

package/android/build.gradle

@@ -60,6 +60,10 @@ def getBoolStringFromPropOrEnv(String name, Boolean defaultValue) {
 // debug builds. (default false)
 def exUpdatesNativeDebug = getBoolStringFromPropOrEnv("EX_UPDATES_NATIVE_DEBUG", false)
 
+// If true, app is using custom code to initialize expo-updates, so default initialization code
+// will be disabled.
+def exUpdatesCustomInit = getBoolStringFromPropOrEnv("EX_UPDATES_CUSTOM_INIT", false)
+
 // If true, code will run that delays app loading until updates is initialized, to prevent ANR issues.
 // (default true)
 def exUpdatesAndroidDelayLoadApp = getBoolStringFromPropOrEnv("EX_UPDATES_ANDROID_DELAY_LOAD_APP", true)
@@ -79,6 +83,7 @@ android {
     testInstrumentationRunner "androidx.test.runner.AndroidJUnitRunner"
 
     buildConfigField("boolean", "EX_UPDATES_NATIVE_DEBUG", exUpdatesNativeDebug)
+    buildConfigField("boolean", "EX_UPDATES_CUSTOM_INIT", exUpdatesCustomInit)
     buildConfigField("boolean", "EX_UPDATES_ANDROID_DELAY_LOAD_APP", exUpdatesAndroidDelayLoadApp)
     buildConfigField("boolean", "USE_DEV_CLIENT", useDevClient.toString())
   }

package/android/src/main/java/expo/modules/updates/IUpdatesController.kt

@@ -108,7 +108,7 @@ interface IUpdatesController {
       this["runtimeVersion"] = runtimeVersion ?: ""
       this["checkAutomatically"] = checkOnLaunch.toJSString()
       this["channel"] = requestHeaders["expo-channel-name"] ?: ""
-      this["shouldDeferToNativeForAPIMethodAvailabilityInDevelopment"] = shouldDeferToNativeForAPIMethodAvailabilityInDevelopment || BuildConfig.EX_UPDATES_NATIVE_DEBUG
+      this["shouldDeferToNativeForAPIMethodAvailabilityInDevelopment"] = shouldDeferToNativeForAPIMethodAvailabilityInDevelopment || UpdatesPackage.isUsingNativeDebug
       this["initialContext"] = initialContext.bundle
 
       if (launchedUpdate != null) {

package/android/src/main/java/expo/modules/updates/UpdatesController.kt

@@ -35,7 +35,7 @@ object UpdatesController {
     }
     val useDeveloperSupport =
       (context as? ReactApplication)?.reactNativeHost?.useDeveloperSupport ?: false
-    if (useDeveloperSupport && !BuildConfig.EX_UPDATES_NATIVE_DEBUG) {
+    if (useDeveloperSupport && !UpdatesPackage.isUsingNativeDebug) {
       if (BuildConfig.USE_DEV_CLIENT) {
         val devLauncherController = initializeAsDevLauncherWithoutStarting(context)
         singletonInstance = devLauncherController

package/android/src/main/java/expo/modules/updates/UpdatesPackage.kt

@@ -22,7 +22,6 @@ import kotlinx.coroutines.withContext
  * applicable environments.
  */
 class UpdatesPackage : Package {
-  private val useNativeDebug = BuildConfig.EX_UPDATES_NATIVE_DEBUG
 
   override fun createReactNativeHostHandlers(context: Context): List<ReactNativeHostHandler> {
     val handler: ReactNativeHostHandler = object : ReactNativeHostHandler {
@@ -57,12 +56,12 @@ class UpdatesPackage : Package {
   override fun createReactActivityHandlers(activityContext: Context): List<ReactActivityHandler> {
     val handler = object : ReactActivityHandler {
       override fun getDelayLoadAppHandler(activity: ReactActivity, reactNativeHost: ReactNativeHost): ReactActivityHandler.DelayLoadAppHandler? {
-        if (!BuildConfig.EX_UPDATES_ANDROID_DELAY_LOAD_APP) {
+        if (!BuildConfig.EX_UPDATES_ANDROID_DELAY_LOAD_APP || isUsingCustomInit) {
           return null
         }
         val context = activity.applicationContext
         val useDeveloperSupport = reactNativeHost.useDeveloperSupport
-        if (!useDeveloperSupport || BuildConfig.EX_UPDATES_NATIVE_DEBUG) {
+        if (!useDeveloperSupport || isUsingNativeDebug) {
           return ReactActivityHandler.DelayLoadAppHandler { whenReadyRunnable ->
             CoroutineScope(Dispatchers.IO).launch {
               startUpdatesController(context)
@@ -76,9 +75,11 @@ class UpdatesPackage : Package {
       @WorkerThread
       private suspend fun startUpdatesController(context: Context) {
         withContext(Dispatchers.IO) {
-          UpdatesController.initialize(context)
-          // Call the synchronous `launchAssetFile()` function to wait for updates ready
-          UpdatesController.instance.launchAssetFile
+          if (!UpdatesPackage.isUsingCustomInit) {
+            UpdatesController.initialize(context)
+            // Call the synchronous `launchAssetFile()` function to wait for updates ready
+            UpdatesController.instance.launchAssetFile
+          }
         }
       }
 
@@ -119,5 +120,7 @@ class UpdatesPackage : Package {
 
   companion object {
     private val TAG = UpdatesPackage::class.java.simpleName
+    val isUsingNativeDebug = BuildConfig.EX_UPDATES_NATIVE_DEBUG
+    internal val isUsingCustomInit = BuildConfig.EX_UPDATES_CUSTOM_INIT
   }
 }

package/android/src/main/java/expo/modules/updates/errorrecovery/ErrorRecovery.kt

@@ -3,6 +3,7 @@ package expo.modules.updates.errorrecovery
 import android.os.Handler
 import android.os.HandlerThread
 import com.facebook.react.bridge.DefaultJSExceptionHandler
+import com.facebook.react.bridge.JSExceptionHandler
 import com.facebook.react.bridge.ReactMarker
 import com.facebook.react.bridge.ReactMarker.MarkerListener
 import com.facebook.react.bridge.ReactMarkerConstants
@@ -114,11 +115,8 @@ class ErrorRecovery(
       return
     }
 
-    val defaultJSExceptionHandler = object : DefaultJSExceptionHandler() {
-      override fun handleException(e: Exception) {
-        this@ErrorRecovery.handleException(e)
-      }
-    }
+    val defaultJSExceptionHandler = JSExceptionHandler { e -> this@ErrorRecovery.handleException(e) }
+
     val devSupportManagerClass = devSupportManager.javaClass
     previousExceptionHandler = devSupportManagerClass.getDeclaredField("defaultJSExceptionHandler").let { field ->
       field.isAccessible = true

package/cli/build/syncConfigurationToNativeAsync.js

@@ -32,13 +32,14 @@ async function syncConfigurationToNativeAndroidAsync(options) {
         isPublicConfig: false,
         skipSDKVersionRequirement: true,
     });
+    const packageVersion = require('../../package.json').version;
     // sync AndroidManifest.xml
     const androidManifestPath = await config_plugins_1.AndroidConfig.Paths.getAndroidManifestAsync(options.projectRoot);
     if (!androidManifestPath) {
         throw new Error(`Could not find AndroidManifest.xml in project directory: "${options.projectRoot}"`);
     }
     const androidManifest = await config_plugins_1.AndroidConfig.Manifest.readAndroidManifestAsync(androidManifestPath);
-    const updatedAndroidManifest = await config_plugins_1.AndroidConfig.Updates.setUpdatesConfigAsync(options.projectRoot, exp, androidManifest);
+    const updatedAndroidManifest = await config_plugins_1.AndroidConfig.Updates.setUpdatesConfigAsync(options.projectRoot, exp, androidManifest, packageVersion);
     await config_plugins_1.AndroidConfig.Manifest.writeAndroidManifestAsync(androidManifestPath, updatedAndroidManifest);
     // sync strings.xml
     const stringsJSONPath = await config_plugins_1.AndroidConfig.Strings.getProjectStringsXMLPathAsync(options.projectRoot);
@@ -53,8 +54,9 @@ async function syncConfigurationToNativeIosAsync(options) {
         isPublicConfig: false,
         skipSDKVersionRequirement: true,
     });
+    const packageVersion = require('../../package.json').version;
     const expoPlist = await readExpoPlistAsync(options.projectRoot);
-    const updatedExpoPlist = await config_plugins_1.IOSConfig.Updates.setUpdatesConfigAsync(options.projectRoot, exp, expoPlist);
+    const updatedExpoPlist = await config_plugins_1.IOSConfig.Updates.setUpdatesConfigAsync(options.projectRoot, exp, expoPlist, packageVersion);
     await writeExpoPlistAsync(options.projectRoot, updatedExpoPlist);
 }
 async function readExpoPlistAsync(projectDir) {

package/cli/src/syncConfigurationToNativeAsync.ts

@@ -41,6 +41,8 @@ async function syncConfigurationToNativeAndroidAsync(
     skipSDKVersionRequirement: true,
   });
 
+  const packageVersion = require('../../package.json').version;
+
   // sync AndroidManifest.xml
   const androidManifestPath = await AndroidConfig.Paths.getAndroidManifestAsync(
     options.projectRoot
@@ -56,7 +58,8 @@ async function syncConfigurationToNativeAndroidAsync(
   const updatedAndroidManifest = await AndroidConfig.Updates.setUpdatesConfigAsync(
     options.projectRoot,
     exp,
-    androidManifest
+    androidManifest,
+    packageVersion
   );
   await AndroidConfig.Manifest.writeAndroidManifestAsync(
     androidManifestPath,
@@ -88,11 +91,14 @@ async function syncConfigurationToNativeIosAsync(
     skipSDKVersionRequirement: true,
   });
 
+  const packageVersion = require('../../package.json').version;
+
   const expoPlist = await readExpoPlistAsync(options.projectRoot);
   const updatedExpoPlist = await IOSConfig.Updates.setUpdatesConfigAsync(
     options.projectRoot,
     exp,
-    expoPlist
+    expoPlist,
+    packageVersion
   );
   await writeExpoPlistAsync(options.projectRoot, updatedExpoPlist);
 }

package/e2e/fixtures/custom_init/AppDelegate.swift

@@ -0,0 +1,141 @@
+import Expo
+import EXUpdates
+import React
+import UIKit
+
+@UIApplicationMain
+class AppDelegate: ExpoAppDelegate {
+  var launchOptions: [UIApplication.LaunchOptionsKey: Any]?
+  // AppDelegate keeps a nullable reference to the updates controller
+  var updatesController: (any InternalAppControllerInterface)?
+
+  let packagerUrl = URL(string: "http://localhost:8081/index.bundle?platform=ios&dev=true")
+  let bundledUrl = Bundle.main.url(forResource: "main", withExtension: "jsbundle")
+
+  static func shared() -> AppDelegate {
+    guard let delegate = UIApplication.shared.delegate as? AppDelegate else {
+      fatalError("Could not get app delegate")
+    }
+    return delegate
+  }
+
+  override func bundleURL() -> URL? {
+    if AppDelegate.isRunningWithPackager() {
+      return packagerUrl
+    }
+    if let updatesUrl = updatesController?.launchAssetUrl() {
+      return updatesUrl
+    }
+    return bundledUrl
+  }
+
+  // If this is a debug build, and native debugging not enabled,
+  // then this returns true.
+  static func isRunningWithPackager() -> Bool {
+    return EXAppDefines.APP_DEBUG && !UpdatesUtils.isNativeDebuggingEnabled()
+  }
+
+  // Required initialization of react-native and expo-updates
+  private func initializeReactNativeAndUpdates(_ launchOptions: [UIApplication.LaunchOptionsKey: Any]?) {
+    self.launchOptions = launchOptions
+    self.moduleName = "main"
+    self.initialProps = [:]
+    self.reactNativeFactory = ExpoReactNativeFactory(delegate: self, reactDelegate: self.reactDelegate)
+    // AppController instance must always be created first.
+    // expo-updates creates a different type of controller
+    // depending on whether updates is enabled, and whether
+    // we are running in development mode or not.
+    AppController.initializeWithoutStarting()
+  }
+
+  /**
+   Application launch initializes the custom view controller: all React Native
+   and updates initialization is handled there
+   */
+  override func application(
+    _ application: UIApplication,
+    didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]? = nil
+  ) -> Bool {
+    initializeReactNativeAndUpdates(launchOptions)
+
+    // Create custom view controller, where the React Native view will be created
+    self.window = UIWindow(frame: UIScreen.main.bounds)
+    let controller = CustomViewController()
+    controller.view.clipsToBounds = true
+    self.window?.rootViewController = controller
+    window?.makeKeyAndVisible()
+
+    return true
+  }
+
+  override func application(_ app: UIApplication, open url: URL, options: [UIApplication.OpenURLOptionsKey: Any] = [:]) -> Bool {
+    return super.application(app, open: url, options: options) ||
+      RCTLinkingManager.application(app, open: url, options: options)
+  }
+}
+
+/**
+ Custom view controller that handles React Native and expo-updates initialization
+ */
+public class CustomViewController: UIViewController, AppControllerDelegate {
+  let appDelegate = AppDelegate.shared()
+
+  /**
+   If updates is enabled, the initializer starts the expo-updates system,
+   and view initialization is deferred to the expo-updates completion handler (onSuccess())
+   */
+  public convenience init() {
+    self.init(nibName: nil, bundle: nil)
+    self.view.backgroundColor = .clear
+    if AppDelegate.isRunningWithPackager() {
+      // No expo-updates, just create the view
+      createView()
+    } else {
+      // Set the updatesController property in AppDelegate so its bundleURL() method
+      // works as expected
+      appDelegate.updatesController = AppController.sharedInstance
+      AppController.sharedInstance.delegate = self
+      AppController.sharedInstance.start()
+    }
+  }
+
+  required public override init(nibName nibNameOrNil: String?, bundle nibBundleOrNil: Bundle?) {
+    super.init(nibName: nibNameOrNil, bundle: nibBundleOrNil)
+  }
+
+  @available(*, unavailable)
+  required public init?(coder aDecoder: NSCoder) {
+    fatalError("init(coder:) has not been implemented")
+  }
+
+  /**
+   expo-updates completion handler creates the root view and adds it to the controller's view
+   */
+  public func appController(
+    _ appController: AppControllerInterface,
+    didStartWithSuccess success: Bool
+  ) {
+    createView()
+  }
+
+  private func createView() {
+    guard let rootViewFactory: RCTRootViewFactory = appDelegate.reactNativeFactory?.rootViewFactory else {
+      fatalError("rootViewFactory has not been initialized")
+    }
+    let rootView = rootViewFactory.view(
+      withModuleName: appDelegate.moduleName,
+      initialProperties: appDelegate.initialProps,
+      launchOptions: appDelegate.launchOptions
+    )
+    let controller = self
+    controller.view.clipsToBounds = true
+    controller.view.addSubview(rootView)
+    rootView.translatesAutoresizingMaskIntoConstraints = false
+    NSLayoutConstraint.activate([
+      rootView.topAnchor.constraint(equalTo: controller.view.safeAreaLayoutGuide.topAnchor),
+      rootView.bottomAnchor.constraint(equalTo: controller.view.safeAreaLayoutGuide.bottomAnchor),
+      rootView.leadingAnchor.constraint(equalTo: controller.view.safeAreaLayoutGuide.leadingAnchor),
+      rootView.trailingAnchor.constraint(equalTo: controller.view.safeAreaLayoutGuide.trailingAnchor)
+    ])
+  }
+}

package/e2e/fixtures/custom_init/MainActivity.kt

@@ -0,0 +1,49 @@
+package dev.expo.updatese2e
+
+import android.content.Context
+import android.os.Bundle
+import com.facebook.react.ReactActivity
+import com.facebook.react.ReactActivityDelegate
+import com.facebook.react.defaults.DefaultNewArchitectureEntryPoint.fabricEnabled
+import com.facebook.react.defaults.DefaultReactActivityDelegate
+import expo.modules.ReactActivityDelegateWrapper
+import expo.modules.updates.UpdatesController
+import kotlinx.coroutines.CoroutineScope
+import kotlinx.coroutines.Dispatchers
+import kotlinx.coroutines.launch
+
+class MainActivity : ReactActivity() {
+    override fun onCreate(savedInstanceState: Bundle?) {
+        super.onCreate(savedInstanceState)
+        CoroutineScope(Dispatchers.IO).launch {
+            startUpdatesController(applicationContext)
+        }
+    }
+
+    private fun startUpdatesController(context: Context) {
+        UpdatesController.initialize(context)
+        // Call the synchronous `launchAssetFile()` function to wait for updates ready
+        UpdatesController.instance.launchAssetFile
+    }
+
+    /**
+     * Returns the name of the main component registered from JavaScript. This is used to schedule
+     * rendering of the component.
+     */
+    override fun getMainComponentName(): String = "main"
+
+    /**
+     * Returns the instance of the [ReactActivityDelegate]. We use [DefaultReactActivityDelegate]
+     * which allows you to enable New Architecture with a single boolean flags [fabricEnabled]
+     */
+    override fun createReactActivityDelegate(): ReactActivityDelegate {
+        return ReactActivityDelegateWrapper(
+            this,
+            BuildConfig.IS_NEW_ARCHITECTURE_ENABLED,
+            object : DefaultReactActivityDelegate(
+                this,
+                mainComponentName,
+                fabricEnabled
+            ) {})
+    }
+}

package/e2e/fixtures/custom_init/MainApplication.kt

@@ -0,0 +1,48 @@
+package dev.expo.updatese2e
+
+import android.app.Application
+import com.facebook.react.PackageList
+import com.facebook.react.ReactApplication
+import com.facebook.react.ReactHost
+import com.facebook.react.ReactNativeHost
+import com.facebook.react.ReactPackage
+import com.facebook.react.defaults.DefaultNewArchitectureEntryPoint.load
+import com.facebook.react.defaults.DefaultReactNativeHost
+import com.facebook.react.soloader.OpenSourceMergedSoMapping
+import com.facebook.soloader.SoLoader
+import expo.modules.ReactNativeHostWrapper
+import expo.modules.updates.UpdatesPackage
+
+class MainApplication : Application(), ReactApplication {
+
+  override val reactNativeHost: ReactNativeHost = ReactNativeHostWrapper(
+        this,
+        object : DefaultReactNativeHost(this) {
+          override fun getPackages(): List<ReactPackage> {
+            val packages = PackageList(this).packages
+            // Packages that cannot be autolinked yet can be added manually here, for example:
+            // packages.add(new MyReactNativePackage());
+            return packages
+          }
+
+          override fun getJSMainModuleName(): String = ".expo/.virtual-metro-entry"
+
+          override fun getUseDeveloperSupport(): Boolean = BuildConfig.DEBUG && !UpdatesPackage.isUsingNativeDebug
+
+          override val isNewArchEnabled: Boolean = BuildConfig.IS_NEW_ARCHITECTURE_ENABLED
+          override val isHermesEnabled: Boolean = BuildConfig.IS_HERMES_ENABLED
+      }
+  )
+
+  override val reactHost: ReactHost
+    get() = ReactNativeHostWrapper.createReactHost(applicationContext, reactNativeHost)
+
+  override fun onCreate() {
+    super.onCreate()
+    SoLoader.init(this, OpenSourceMergedSoMapping)
+    if (BuildConfig.IS_NEW_ARCHITECTURE_ENABLED) {
+      // If you opted-in for the New Architecture, we load the native entry point for this app.
+      load()
+    }
+  }
+}

package/e2e/fixtures/project_files/eas.json

@@ -6,7 +6,8 @@
     "base": {
       "node": "20.14.0",
       "android": {
-        "image": "latest"
+        "image": "ubuntu-22.04-jdk-17-ndk-r21e",
+        "resourceClass": "large"
       },
       "ios": {
         "image": "latest"
@@ -24,9 +25,6 @@
     },
     "updates_testing_debug": {
       "extends": "base",
-      "env": {
-        "EX_UPDATES_NATIVE_DEBUG": "1"
-      },
       "android": {
         "applicationArchivePath": "eas.json",
         "gradleCommand": ":app:assembleDebug :app:assembleAndroidTest -DtestBuildType=debug",
@@ -42,9 +40,6 @@
     },
     "updates_testing_release": {
       "extends": "base",
-      "env": {
-        "EX_UPDATES_NATIVE_DEBUG": "1"
-      },
       "android": {
         "gradleCommand": ":app:assembleRelease :app:assembleAndroidTest -DtestBuildType=release",
         "withoutCredentials": true

package/e2e/setup/create-eas-project-custom-init.ts

@@ -0,0 +1,42 @@
+#!/usr/bin/env yarn --silent ts-node --transpile-only
+
+import nullthrows from 'nullthrows';
+import path from 'path';
+
+import { initAsync, setupE2EAppAsync, transformAppJsonForE2EWithCustomInit } from './project';
+
+const repoRoot = nullthrows(process.env.EXPO_REPO_ROOT, 'EXPO_REPO_ROOT is not defined');
+const workingDir = path.resolve(repoRoot, '..');
+const runtimeVersion = '1.0.0';
+
+/**
+ *
+ * This generates a project at the location TEST_PROJECT_ROOT,
+ * that is configured to build a test app and run both suites
+ * of updates E2E tests in the Detox environment.
+ *
+ * This test project will use the custom init flow for updates, using
+ * the expo-template-custom-init native files.
+ *
+ * See `packages/expo-updates/e2e/README.md` for instructions on how
+ * to run these tests locally.
+ *
+ */
+
+(async function () {
+  if (!process.env.EXPO_REPO_ROOT || !process.env.UPDATES_HOST || !process.env.UPDATES_PORT) {
+    throw new Error('Missing one or more environment variables; see instructions in e2e/README.md');
+  }
+  const projectRoot = process.env.TEST_PROJECT_ROOT || path.join(workingDir, 'updates-e2e');
+  const localCliBin = path.join(repoRoot, 'packages/@expo/cli/build/bin/cli');
+
+  await initAsync(projectRoot, {
+    repoRoot,
+    runtimeVersion,
+    localCliBin,
+    useCustomInit: true,
+    transformAppJson: transformAppJsonForE2EWithCustomInit,
+  });
+
+  await setupE2EAppAsync(projectRoot, { localCliBin, repoRoot });
+})();

package/e2e/setup/project.ts

@@ -17,9 +17,11 @@ const dirName = __dirname; /* eslint-disable-line */
 function getExpoDependencyChunks({
   includeDevClient,
   includeTV,
+  includeSplashScreen,
 }: {
   includeDevClient: boolean;
   includeTV: boolean;
+  includeSplashScreen: boolean;
 }) {
   return [
     ['@expo/config-types', '@expo/env', '@expo/json-file'],
@@ -39,12 +41,12 @@ function getExpoDependencyChunks({
       'expo-font',
       'expo-json-utils',
       'expo-keep-awake',
-      'expo-splash-screen',
       'expo-status-bar',
       'expo-structured-headers',
       'expo-updates',
       'expo-updates-interface',
     ],
+    ...(includeSplashScreen ? [['expo-splash-screen']] : []),
     ...(includeDevClient
       ? [['expo-dev-menu-interface'], ['expo-dev-menu'], ['expo-dev-launcher'], ['expo-dev-client']]
       : []),
@@ -252,13 +254,18 @@ async function preparePackageJson(
   configureE2E: boolean,
   isTV: boolean,
   shouldGenerateTestUpdateBundles: boolean,
-  includeDevClient: boolean
+  includeDevClient: boolean,
+  useCustomInit: boolean
 ) {
   // Create the project subfolder to hold NPM tarballs built from the current state of the repo
   const dependenciesPath = path.join(projectRoot, 'dependencies');
   await fs.mkdir(dependenciesPath);
 
-  const allDependencyChunks = getExpoDependencyChunks({ includeDevClient, includeTV: isTV });
+  const allDependencyChunks = getExpoDependencyChunks({
+    includeDevClient,
+    includeTV: isTV,
+    includeSplashScreen: !useCustomInit,
+  });
 
   console.time('Done packing dependencies');
   for (const dependencyChunk of allDependencyChunks) {
@@ -368,7 +375,7 @@ async function preparePackageJson(
       ...packageJson,
       dependencies: {
         ...packageJson.dependencies,
-        'react-native': 'npm:react-native-tvos@~0.78.0-0',
+        'react-native': 'npm:react-native-tvos@0.79.0-0rc2',
         '@react-native-tvos/config-tv': '^0.1.1',
       },
       expo: {
@@ -495,6 +502,7 @@ function transformAppJsonForE2E(
         ...appJson.expo.updates,
         url: `http://${process.env.UPDATES_HOST}:${process.env.UPDATES_PORT}/update`,
         assetPatternsToBeBundled: ['includedAssets/*'],
+        useNativeDebug: true,
       },
       extra: {
         eas: {
@@ -505,6 +513,22 @@ function transformAppJsonForE2E(
   };
 }
 
+export function transformAppJsonForE2EWithCustomInit(
+  appJson: any,
+  projectName: string,
+  runtimeVersion: string,
+  isTV: boolean
+) {
+  const transformedForE2E = transformAppJsonForE2E(appJson, projectName, runtimeVersion, isTV);
+  return {
+    ...transformedForE2E,
+    expo: {
+      ...transformedForE2E.expo,
+      newArchEnabled: true,
+    },
+  };
+}
+
 /**
  * Modifies app.json in the E2E test app to add the properties we need, and sets the runtime version policy to fingerprint
  */
@@ -605,6 +629,10 @@ export function transformAppJsonForUpdatesDisabledE2E(
       newArchEnabled: false,
       android: { ...appJson.expo.android, package: 'dev.expo.updatese2e' },
       ios: { ...appJson.expo.ios, bundleIdentifier: 'dev.expo.updatese2e' },
+      updates: {
+        enabled: false,
+        useNativeDebug: true,
+      },
       extra: {
         eas: {
           projectId: '55685a57-9cf3-442d-9ba8-65c7b39849ef',
@@ -664,6 +692,7 @@ export async function initAsync(
     shouldGenerateTestUpdateBundles = true,
     shouldConfigureCodeSigning = true,
     includeDevClient = false,
+    useCustomInit = false,
   }: {
     repoRoot: string;
     runtimeVersion: string;
@@ -679,6 +708,7 @@ export async function initAsync(
     shouldGenerateTestUpdateBundles?: boolean;
     shouldConfigureCodeSigning?: boolean;
     includeDevClient?: boolean;
+    useCustomInit?: boolean;
   }
 ) {
   console.log('Creating expo app');
@@ -730,7 +760,8 @@ export async function initAsync(
     configureE2E,
     isTV,
     shouldGenerateTestUpdateBundles,
-    includeDevClient
+    includeDevClient,
+    useCustomInit
   );
 
   // configure app.json
@@ -760,7 +791,6 @@ export async function initAsync(
   await spawnAsync(localCliBin, ['prebuild', '--no-install', '--template', localTemplatePathName], {
     env: {
       ...process.env,
-      EX_UPDATES_NATIVE_DEBUG: '1',
       EXPO_DEBUG: '1',
       CI: '1',
     },
@@ -784,10 +814,10 @@ export async function initAsync(
     stdio: 'inherit',
   });
 
-  // enable proguard on Android
+  // enable proguard on Android, and custom init if needed
   await fs.appendFile(
     path.join(projectRoot, 'android', 'gradle.properties'),
-    '\nandroid.enableProguardInReleaseBuilds=true\nEXPO_UPDATES_NATIVE_DEBUG=true',
+    `\nandroid.enableProguardInReleaseBuilds=true${useCustomInit ? '\nEX_UPDATES_CUSTOM_INIT=true' : ''}`,
     'utf-8'
   );
 
@@ -807,6 +837,71 @@ export async function initAsync(
     ].join('\n'),
     'utf-8'
   );
+
+  // Add custom init to iOS Podfile.properties.json if needed
+  if (useCustomInit) {
+    const podfilePropertiesJsonPath = path.join(projectRoot, 'ios', 'Podfile.properties.json');
+    const podfilePropertiesJsonString = await fs.readFile(podfilePropertiesJsonPath, {
+      encoding: 'utf-8',
+    });
+    const podfilePropertiesJson: any = JSON.parse(podfilePropertiesJsonString);
+    podfilePropertiesJson.updatesCustomInit = 'true';
+    await fs.writeFile(podfilePropertiesJsonPath, JSON.stringify(podfilePropertiesJson, null, 2), {
+      encoding: 'utf-8',
+    });
+  }
+
+  const customInitSourcesDirectory = path.join(
+    repoRoot,
+    'packages',
+    'expo-updates',
+    'e2e',
+    'fixtures',
+    'custom_init'
+  );
+  // If custom init, copy native source files
+  if (useCustomInit) {
+    const filesToCopyForCustomInit = [
+      {
+        sourcePath: path.join(customInitSourcesDirectory, 'AppDelegate.swift'),
+        destPath: path.join(projectRoot, 'ios', 'updatese2e', 'AppDelegate.swift'),
+      },
+      {
+        sourcePath: path.join(customInitSourcesDirectory, 'MainApplication.kt'),
+        destPath: path.join(
+          projectRoot,
+          'android',
+          'app',
+          'src',
+          'main',
+          'java',
+          'dev',
+          'expo',
+          'updatese2e',
+          'MainApplication.kt'
+        ),
+      },
+      {
+        sourcePath: path.join(customInitSourcesDirectory, 'MainActivity.kt'),
+        destPath: path.join(
+          projectRoot,
+          'android',
+          'app',
+          'src',
+          'main',
+          'java',
+          'dev',
+          'expo',
+          'updatese2e',
+          'MainActivity.kt'
+        ),
+      },
+    ];
+    for (const fileToCopy of filesToCopyForCustomInit) {
+      await fs.copyFile(fileToCopy.sourcePath, fileToCopy.destPath);
+    }
+  }
+
   await fs.appendFile(
     path.join(projectRoot, 'android', 'app', 'build.gradle'),
     [

package/expo-updates-gradle-plugin/src/main/kotlin/expo/modules/updates/ExpoUpdatesPlugin.kt

@@ -16,6 +16,7 @@ import org.slf4j.LoggerFactory
 import java.io.ByteArrayOutputStream
 import java.io.File
 import java.util.Locale
+import java.util.Properties
 
 abstract class ExpoUpdatesPlugin : Plugin<Project> {
   override fun apply(project: Project) {
@@ -26,7 +27,7 @@ abstract class ExpoUpdatesPlugin : Plugin<Project> {
     val entryFile = detectedEntryFile(reactExtension)
     val androidComponents = project.extensions.getByType(AndroidComponentsExtension::class.java)
 
-    if (System.getenv("EX_UPDATES_NATIVE_DEBUG") == "1") {
+    if (isNativeDebuggingEnabled(project)) {
       logger.warn("Disable all react.debuggableVariants because EX_UPDATES_NATIVE_DEBUG=1")
       reactExtension.debuggableVariants.set(listOf())
     }
@@ -126,3 +127,10 @@ private fun detectedEntryFile(config: ReactExtension): File {
     else -> File(reactRoot, "index.js")
   }
 }
+
+private fun isNativeDebuggingEnabled(project: Project): Boolean {
+  if (System.getenv("EX_UPDATES_NATIVE_DEBUG") == "1") {
+    return true
+  }
+  return project.findProperty("EX_UPDATES_NATIVE_DEBUG") == "true"
+}

package/ios/EXUpdates/ReactDelegateHandler/ExpoUpdatesReactDelegateHandler.swift

@@ -22,6 +22,10 @@ public final class ExpoUpdatesReactDelegateHandler: ExpoReactDelegateHandler, Ap
     initialProperties: [AnyHashable: Any]?,
     launchOptions: [UIApplication.LaunchOptionsKey: Any]?
   ) -> UIView? {
+    if UpdatesUtils.isUsingCustomInitialization() {
+      return nil
+    }
+
     AppController.initializeWithoutStarting()
     let controller = AppController.sharedInstance
     if !controller.isActiveController {
@@ -59,12 +63,15 @@ public final class ExpoUpdatesReactDelegateHandler: ExpoReactDelegateHandler, Ap
   // MARK: AppControllerDelegate implementations
 
   public func appController(_ appController: AppControllerInterface, didStartWithSuccess success: Bool) {
+    if UpdatesUtils.isUsingCustomInitialization() {
+      return
+    }
     guard let reactDelegate = self.reactDelegate else {
       fatalError("`reactDelegate` should not be nil")
     }
 
-    guard let appDelegate = (UIApplication.shared.delegate as? ReactNativeFactoryProvider) ??
-      ((UIApplication.shared.delegate as? NSObject)?.value(forKey: "_expoAppDelegate") as? ReactNativeFactoryProvider) else {
+    guard let appDelegate = (UIApplication.shared.delegate as? (any ReactNativeFactoryProvider)) ??
+      ((UIApplication.shared.delegate as? NSObject)?.value(forKey: "_expoAppDelegate") as? (any ReactNativeFactoryProvider)) else {
       fatalError("`UIApplication.shared.delegate` must be an `ExpoAppDelegate` or `EXAppDelegateWrapper`")
     }
 

package/ios/EXUpdates/UpdatesUtils.swift

@@ -133,7 +133,7 @@ public final class UpdatesUtils: NSObject {
     }
   }
 
-  internal static func isNativeDebuggingEnabled() -> Bool {
+  public static func isNativeDebuggingEnabled() -> Bool {
 #if EX_UPDATES_NATIVE_DEBUG
     return true
 #else
@@ -141,6 +141,14 @@ public final class UpdatesUtils: NSObject {
 #endif
   }
 
+  internal static func isUsingCustomInitialization() -> Bool {
+#if EX_UPDATES_CUSTOM_INIT
+    return true
+#else
+    return false
+#endif
+  }
+
   internal static func runBlockOnMainThread(_ block: @escaping () -> Void) {
     if Thread.isMainThread {
       block()

package/ios/EXUpdates.podspec

@@ -3,9 +3,19 @@ require 'json'
 package = JSON.parse(File.read(File.join(__dir__, '..', 'package.json')))
 podfile_properties = JSON.parse(File.read("#{Pod::Config.instance.installation_root}/Podfile.properties.json")) rescue {}
 
+if ENV['EX_UPDATES_NATIVE_DEBUG'] != '1'
+  ENV['EX_UPDATES_NATIVE_DEBUG'] = podfile_properties['updatesNativeDebug'] == 'true' ? '1' : '0'
+end
+if ENV['EX_UPDATES_CUSTOM_INIT'] != '1'
+  ENV['EX_UPDATES_CUSTOM_INIT'] = podfile_properties['updatesCustomInit'] == 'true' ? '1' : '0'
+end
+
 use_dev_client = false
 begin
-  use_dev_client = `node --print "require('expo-dev-client/package.json').version" 2>/dev/null`.length > 0
+  # No dev client if we are using native debug
+  if ENV['EX_UPDATES_NATIVE_DEBUG'] != '1'
+    use_dev_client = `node --print "require('expo-dev-client/package.json').version" 2>/dev/null`.length > 0
+  end
 rescue
   use_dev_client = false
 end
@@ -43,17 +53,26 @@ Pod::Spec.new do |s|
   end
   install_modules_dependencies(s)
 
-  other_c_flags = '$(inherited)'
-  other_swift_flags = '$(inherited)'
+  other_debug_c_flags = '$(inherited)'
+  other_debug_swift_flags = '$(inherited)'
+  other_release_c_flags = '$(inherited)'
+  other_release_swift_flags = '$(inherited)'
 
   ex_updates_native_debug = ENV['EX_UPDATES_NATIVE_DEBUG'] == '1'
+  ex_updates_custom_init = ENV['EX_UPDATES_CUSTOM_INIT'] == '1'
   if ex_updates_native_debug
-    other_c_flags << ' -DEX_UPDATES_NATIVE_DEBUG=1'
-    other_swift_flags << ' -DEX_UPDATES_NATIVE_DEBUG'
+    other_debug_c_flags << ' -DEX_UPDATES_NATIVE_DEBUG=1'
+    other_debug_swift_flags << ' -DEX_UPDATES_NATIVE_DEBUG'
+  end
+  if ex_updates_custom_init
+    other_debug_c_flags << ' -DEX_UPDATES_CUSTOM_INIT=1'
+    other_debug_swift_flags << ' -DEX_UPDATES_CUSTOM_INIT'
+    other_release_c_flags << ' -DEX_UPDATES_CUSTOM_INIT=1'
+    other_release_swift_flags << ' -DEX_UPDATES_CUSTOM_INIT'
   end
   if use_dev_client
-    other_c_flags << ' -DUSE_DEV_CLIENT=1'
-    other_swift_flags << ' -DUSE_DEV_CLIENT'
+    other_debug_c_flags << ' -DUSE_DEV_CLIENT=1'
+    other_debug_swift_flags << ' -DUSE_DEV_CLIENT'
   end
 
   s.pod_target_xcconfig = {
@@ -61,8 +80,10 @@ Pod::Spec.new do |s|
     'GCC_TREAT_IMPLICIT_FUNCTION_DECLARATIONS_AS_ERRORS' => 'YES',
     'DEFINES_MODULE' => 'YES',
     'SWIFT_COMPILATION_MODE' => 'wholemodule',
-    'OTHER_CFLAGS[config=*Debug*]' => other_c_flags,
-    'OTHER_SWIFT_FLAGS[config=*Debug*]' => other_swift_flags
+    'OTHER_CFLAGS[config=*Debug*]' => other_debug_c_flags,
+    'OTHER_SWIFT_FLAGS[config=*Debug*]' => other_debug_swift_flags,
+    'OTHER_CFLAGS[config=*Release*]' => other_release_c_flags,
+    'OTHER_SWIFT_FLAGS[config=*Release*]' => other_release_swift_flags
   }
   s.user_target_xcconfig = {
     'HEADER_SEARCH_PATHS' => '"${PODS_CONFIGURATION_BUILD_DIR}/EXUpdates/Swift Compatibility Header"',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "expo-updates",
-  "version": "1.0.0-canary-20250306-d9d3e02",
+  "version": "1.0.0-canary-20250331-817737a",
   "description": "Fetches and manages remotely-hosted assets and updates to your app's JS bundle.",
   "main": "build/index.js",
   "types": "build/index.d.ts",
@@ -39,15 +39,15 @@
   },
   "dependencies": {
     "@expo/code-signing-certificates": "0.0.5",
-    "@expo/config": "11.0.0-canary-20250306-d9d3e02",
-    "@expo/config-plugins": "9.1.0-canary-20250306-d9d3e02",
+    "@expo/config": "11.0.0-canary-20250331-817737a",
+    "@expo/config-plugins": "9.1.0-canary-20250331-817737a",
     "@expo/spawn-async": "^1.7.2",
     "arg": "4.1.0",
     "chalk": "^4.1.2",
-    "expo-eas-client": "0.13.4-canary-20250306-d9d3e02",
-    "expo-manifests": "0.15.8-canary-20250306-d9d3e02",
-    "expo-structured-headers": "4.0.1-canary-20250306-d9d3e02",
-    "expo-updates-interface": "1.0.1-canary-20250306-d9d3e02",
+    "expo-eas-client": "0.13.4-canary-20250331-817737a",
+    "expo-manifests": "0.15.8-canary-20250331-817737a",
+    "expo-structured-headers": "4.0.1-canary-20250331-817737a",
+    "expo-updates-interface": "1.0.1-canary-20250331-817737a",
     "glob": "^10.4.2",
     "ignore": "^5.3.1",
     "resolve-from": "^5.0.0"
@@ -56,15 +56,14 @@
     "@types/jest": "^29.2.1",
     "@types/node": "^18.19.34",
     "@types/node-forge": "^1.0.0",
-    "expo-module-scripts": "4.0.5-canary-20250306-d9d3e02",
+    "expo-module-scripts": "4.0.5-canary-20250331-817737a",
     "express": "^4.21.1",
     "form-data": "^4.0.0",
     "memfs": "^3.2.0",
     "xstate": "^4.37.2"
   },
   "peerDependencies": {
-    "expo": "53.0.0-canary-20250306-d9d3e02",
+    "expo": "53.0.0-canary-20250331-817737a",
     "react": "*"
-  },
-  "gitHead": "d9d3e024d8742099c307754673f17117a20c1dea"
+  }
 }