expo-updates 0.27.3 → 0.28.0

package/CHANGELOG.md

@@ -10,76 +10,109 @@
 
 ### 💡 Others
 
-## 0.27.3 — 2025-03-11
+## 0.28.0 — 2025-04-04
+
+### 🛠 Breaking changes
+
+- upgrade RN to 0.78 ([#35050](https://github.com/expo/expo/pull/35050) by [@vonovak](https://github.com/vonovak))
+- Remove a few long-deprecated typescript types. ([#34215](https://github.com/expo/expo/pull/34215) by [@wschurman](https://github.com/wschurman))
+
+### 🎉 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
+
+- [android] Use more robust mechanism for determining empty multipart bodies. ([#33977](https://github.com/expo/expo/pull/33977) by [@wschurman](https://github.com/wschurman))
+- fix E2E tests in Detox debug build ([#32951](https://github.com/expo/expo/pull/32951) by [@matejkriz](https://github.com/matejkriz))
+- Fix runtime version validation warning ([#35188](https://github.com/expo/expo/pull/35188) by [@gabrieldonadel](https://github.com/gabrieldonadel))
+
+### 💡 Others
+
+- [Android] Made ReactNativeFeatureFlags a parameter to the constructor of the ErrorRecovery class to be able to make tests pass ([#34363](https://github.com/expo/expo/pull/34363) by [@chrfalch](https://github.com/chrfalch))
+- [iOS] Inject logger from controllers down to dependent objects. ([#34035](https://github.com/expo/expo/pull/34035) by [@wschurman](https://github.com/wschurman))
+- [apple] Migrate remaining `expo-module.config.json` to unified platform syntax. ([#34445](https://github.com/expo/expo/pull/34445) by [@reichhartd](https://github.com/reichhartd))
+- 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))
+- 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
+## 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
+## 0.27.1 - 2025-02-21
 
 ### 🎉 New features
 
 - Add `Updates.setUpdateURLAndRequestHeadersOverride()` to allow overriding update URL configuration from the JS API. ([#34422](https://github.com/expo/expo/pull/34422), [#34423](https://github.com/expo/expo/pull/34423), [#34425](https://github.com/expo/expo/pull/34425), [#34426](https://github.com/expo/expo/pull/34426), [#34454](https://github.com/expo/expo/pull/34454), [#34455](https://github.com/expo/expo/pull/34455), [#34428](https://github.com/expo/expo/pull/34428), [#34404](https://github.com/expo/expo/pull/34404) by [@kudo](https://github.com/kudo), [@wschurman](https://github.com/wschurman))
 
-### 🐛 Bug fixes
-
-- 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))
-
-## 0.26.19 — 2025-02-19
+## 0.26.19 - 2025-02-19
 
 ### 💡 Others
 
 - Fixed incorrect error log on Android. ([#34785](https://github.com/expo/expo/pull/34785) by [@kudo](https://github.com/kudo))
 
-## 0.26.18 — 2025-02-12
+## 0.26.18 - 2025-02-12
 
 ### 🐛 Bug fixes
 
 - [Android] Fix `bytesToHex` `ArrayIndexOutOfBoundsException` during conversion. ([#34855](https://github.com/expo/expo/pull/34855) by [@gabrieldonadel](https://github.com/gabrieldonadel))
 
-## 0.26.17 — 2025-02-06
+## 0.26.17 - 2025-02-06
 
 _This version does not introduce any user-facing changes._
 
-## 0.26.16 — 2025-02-04
+## 0.26.16 - 2025-02-04
 
 ### 🐛 Bug fixes
 
 - Removed Apache Commons IO dependency and fixed crash issue on Android 7. ([#34638](https://github.com/expo/expo/pull/34638) by [@kudo](https://github.com/kudo))
 
-## 0.26.15 — 2025-01-31
+## 0.26.15 - 2025-01-31
 
 ### 🐛 Bug fixes
 
 - Fix issue where syncing codesigning config for bare projects would clobber existing Expo.plist config ([#34597](https://github.com/expo/expo/pull/34597) by [@brentvatne](https://github.com/brentvatne))
 
-## 0.26.14 — 2025-01-31
+## 0.26.14 - 2025-01-31
 
 _This version does not introduce any user-facing changes._
 
-## 0.26.13 — 2025-01-19
+## 0.26.13 - 2025-01-19
 
 _This version does not introduce any user-facing changes._
 
-## 0.26.12 — 2025-01-10
+## 0.26.12 - 2025-01-10
 
 _This version does not introduce any user-facing changes._
 
-## 0.26.11 — 2025-01-08
+## 0.26.11 - 2025-01-08
 
 ### 🐛 Bug fixes
 
 - Fix an issue where `launchFallbackUpdateFromDisk` is called from a foreground thread leading to ANRs. ([#33693](https://github.com/expo/expo/pull/33693) by [@alanjhughes](https://github.com/alanjhughes))
 
-## 0.26.10 — 2024-12-05
+## 0.26.10 - 2024-12-05
 
 ### 🐛 Bug fixes
 

package/android/build.gradle

@@ -1,30 +1,45 @@
 buildscript {
-  def expoModulesCorePlugin = new File(project(":expo-modules-core").projectDir.absolutePath, "ExpoModulesCorePlugin.gradle")
-  apply from: expoModulesCorePlugin
-  applyKotlinExpoModulesCorePlugin()
+  ext {
+    boolish = { value ->
+      return value.toString().toBoolean()
+    }
+    getKspVersion = {
+      if (rootProject.hasProperty("kspVersion")) {
+        return rootProject["kspVersion"]
+      }
+
+      // We can remove this path once we update the test environment
+      // to use the same version of Kotlin as the `expo/expo` repo.
+      def kotlinVersion = rootProject["kotlinVersion"]
+      if (kotlinVersion == "2.0.21") {
+        return "2.0.21-1.0.28"
+      } else if (kotlinVersion == "1.9.25") {
+        return "1.9.25-1.0.20"
+      }
+
+      return "1.9.24-1.0.20"
+    }
+  }
 
   repositories {
     mavenCentral()
   }
 
   dependencies {
-    classpath "com.google.devtools.ksp:symbol-processing-gradle-plugin:${kspVersion()}"
+    classpath "com.google.devtools.ksp:symbol-processing-gradle-plugin:${getKspVersion()}"
   }
 }
 
 apply plugin: 'com.android.library'
+apply plugin: 'expo-module-gradle-plugin'
 apply plugin: 'com.google.devtools.ksp'
 
-group = 'host.exp.exponent'
-version = '0.27.3'
+expoModule {
+  canBePublished false
+}
 
-def expoModulesCorePlugin = new File(project(":expo-modules-core").projectDir.absolutePath, "ExpoModulesCorePlugin.gradle")
-apply from: expoModulesCorePlugin
-applyKotlinExpoModulesCorePlugin()
-applyKspJvmToolchain()
-useCoreDependencies()
-useDefaultAndroidSdkVersions()
-useExpoPublishing()
+group = 'host.exp.exponent'
+version = '0.28.0'
 
 // Utility method to derive boolean values from the environment or from Java properties,
 // and return them as strings to be used in BuildConfig fields
@@ -49,6 +64,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)
@@ -63,11 +82,12 @@ android {
   namespace "expo.modules.updates"
   defaultConfig {
     versionCode 31
-    versionName '0.27.3'
+    versionName '0.28.0'
     consumerProguardFiles("proguard-rules.pro")
     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())
   }
@@ -117,7 +137,8 @@ dependencies {
   testImplementation 'junit:junit:4.13.2'
   testImplementation 'androidx.test:core:1.5.0'
   testImplementation "io.mockk:mockk:$mockk_version"
-  testImplementation "org.jetbrains.kotlin:kotlin-test-junit:${kotlinVersion()}"
+  testImplementation "org.jetbrains.kotlin:kotlin-test-junit:${kotlinVersion}"
+  testImplementation 'org.jetbrains.kotlinx:kotlinx-coroutines-test:1.7.3'
   testImplementation 'org.robolectric:robolectric:4.14.1'
 
   androidTestImplementation 'com.squareup.okio:okio:2.9.0'
@@ -126,7 +147,8 @@ dependencies {
   androidTestImplementation 'androidx.test:rules:1.5.0'
   androidTestImplementation "io.mockk:mockk-android:$mockk_version"
   androidTestImplementation "androidx.room:room-testing:$room_version"
-  androidTestImplementation "org.jetbrains.kotlin:kotlin-test-junit:${kotlinVersion()}"
+  androidTestImplementation 'org.jetbrains.kotlinx:kotlinx-coroutines-test:1.7.3'
+  androidTestImplementation "org.jetbrains.kotlin:kotlin-test-junit:${kotlinVersion}"
 
-  implementation "org.jetbrains.kotlin:kotlin-reflect:${kotlinVersion()}"
+  implementation "org.jetbrains.kotlin:kotlin-reflect:${kotlinVersion}"
 }

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

@@ -35,7 +35,7 @@ class DisabledUpdatesController(
   /** Keep the activity for [RecreateReactContextProcedure] to relaunch the app. */
   private var weakActivity: WeakReference<Activity>? = null
 
-  private val logger = UpdatesLogger(context)
+  private val logger = UpdatesLogger(context.filesDir)
   override val eventManager: IUpdatesEventManager = UpdatesEventManager(logger)
 
   // disabled controller state machine can only be idle or restarting

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

@@ -2,7 +2,6 @@ package expo.modules.updates
 
 import android.app.Activity
 import android.content.Context
-import android.os.AsyncTask
 import android.os.Bundle
 import com.facebook.react.bridge.ReactContext
 import com.facebook.react.devsupport.interfaces.DevSupportManager
@@ -27,6 +26,9 @@ import expo.modules.updates.procedures.StartupProcedure
 import expo.modules.updates.selectionpolicy.SelectionPolicyFactory
 import expo.modules.updates.statemachine.UpdatesStateMachine
 import expo.modules.updates.statemachine.UpdatesStateValue
+import kotlinx.coroutines.CoroutineScope
+import kotlinx.coroutines.Dispatchers
+import kotlinx.coroutines.launch
 import java.io.File
 import java.lang.ref.WeakReference
 import kotlin.time.DurationUnit
@@ -42,7 +44,7 @@ class EnabledUpdatesController(
 ) : IUpdatesController {
   /** Keep the activity for [RelaunchProcedure] to relaunch the app. */
   private var weakActivity: WeakReference<Activity>? = null
-  private val logger = UpdatesLogger(context)
+  private val logger = UpdatesLogger(context.filesDir)
   override val eventManager: IUpdatesEventManager = UpdatesEventManager(logger)
 
   private val fileDownloader = FileDownloader(context, updatesConfiguration, logger)
@@ -51,9 +53,10 @@ class EnabledUpdatesController(
   )
   private val stateMachine = UpdatesStateMachine(logger, eventManager, UpdatesStateValue.entries.toSet())
   private val databaseHolder = DatabaseHolder(UpdatesDatabase.getInstance(context))
+  private val controllerScope = CoroutineScope(Dispatchers.IO)
 
   private fun purgeUpdatesLogsOlderThanOneDay() {
-    UpdatesLogReader(context).purgeLogEntries {
+    UpdatesLogReader(context.filesDir).purgeLogEntries {
       if (it != null) {
         logger.error("UpdatesLogReader: error in purgeLogEntries", it, UpdatesErrorCode.Unknown)
       }
@@ -219,7 +222,7 @@ class EnabledUpdatesController(
   }
 
   override fun getExtraParams(callback: IUpdatesController.ModuleCallback<Bundle>) {
-    AsyncTask.execute {
+    controllerScope.launch {
       try {
         val result = ManifestMetadata.getExtraParams(
           databaseHolder.database,
@@ -245,7 +248,7 @@ class EnabledUpdatesController(
   }
 
   override fun setExtraParam(key: String, value: String?, callback: IUpdatesController.ModuleCallback<Unit>) {
-    AsyncTask.execute {
+    controllerScope.launch {
       try {
         ManifestMetadata.setExtraParam(
           databaseHolder.database,

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

@@ -18,146 +18,156 @@ import java.lang.ref.WeakReference
  * start the process of loading and launching an update, then responds appropriately depending on
  * the callbacks that are invoked.
  */
-class UpdatesController {
-  companion object {
-    private var singletonInstance: IUpdatesController? = null
-    private var overrideConfiguration: UpdatesConfiguration? = null
-
-    @JvmStatic val instance: IUpdatesController
-      get() {
-        return checkNotNull(singletonInstance) { "UpdatesController.instance was called before the module was initialized" }
-      }
+object UpdatesController {
+  private var singletonInstance: IUpdatesController? = null
+  private var overrideConfiguration: UpdatesConfiguration? = null
+
+  @JvmStatic
+  val instance: IUpdatesController
+    get() {
+      return checkNotNull(singletonInstance) { "UpdatesController.instance was called before the module was initialized" }
+    }
 
-    @JvmStatic fun initializeWithoutStarting(context: Context) {
-      if (singletonInstance != null) {
-        return
+  @JvmStatic
+  fun initializeWithoutStarting(context: Context) {
+    if (singletonInstance != null) {
+      return
+    }
+    val useDeveloperSupport =
+      (context as? ReactApplication)?.reactNativeHost?.useDeveloperSupport ?: false
+    if (useDeveloperSupport && !UpdatesPackage.isUsingNativeDebug) {
+      if (BuildConfig.USE_DEV_CLIENT) {
+        val devLauncherController = initializeAsDevLauncherWithoutStarting(context)
+        singletonInstance = devLauncherController
+        UpdatesControllerRegistry.controller = WeakReference(devLauncherController)
+      } else {
+        singletonInstance = DisabledUpdatesController(context, null)
       }
-      val useDeveloperSupport = (context as? ReactApplication)?.reactNativeHost?.useDeveloperSupport ?: false
-      if (useDeveloperSupport && !BuildConfig.EX_UPDATES_NATIVE_DEBUG) {
-        if (BuildConfig.USE_DEV_CLIENT) {
-          val devLauncherController = initializeAsDevLauncherWithoutStarting(context)
-          singletonInstance = devLauncherController
-          UpdatesControllerRegistry.controller = WeakReference(devLauncherController)
-        } else {
-          singletonInstance = DisabledUpdatesController(context, null)
+      return
+    }
+
+    val logger = UpdatesLogger(context.filesDir)
+
+    val updatesDirectory = try {
+      UpdatesUtils.getOrCreateUpdatesDirectory(context)
+    } catch (e: Exception) {
+      logger.error(
+        "The expo-updates system is disabled due to a storage access error",
+        e,
+        UpdatesErrorCode.InitializationError
+      )
+      singletonInstance = DisabledUpdatesController(context, e)
+      return
+    }
+
+    val updatesConfiguration: UpdatesConfiguration? = overrideConfiguration ?: run {
+      when (UpdatesConfiguration.getUpdatesConfigurationValidationResult(context, null)) {
+        UpdatesConfigurationValidationResult.VALID -> {
+          return@run UpdatesConfiguration(context, null)
         }
-        return
-      }
 
-      val logger = UpdatesLogger(context)
+        UpdatesConfigurationValidationResult.INVALID_NOT_ENABLED -> logger.warn(
+          "The expo-updates system is explicitly disabled. To enable it, set the enabled setting to true.",
+          UpdatesErrorCode.InitializationError
+        )
 
-      val updatesDirectory = try {
-        UpdatesUtils.getOrCreateUpdatesDirectory(context)
-      } catch (e: Exception) {
-        logger.error(
-          "The expo-updates system is disabled due to a storage access error",
-          e,
+        UpdatesConfigurationValidationResult.INVALID_MISSING_URL -> logger.warn(
+          "The expo-updates system is disabled due to an invalid configuration. Ensure a valid URL is supplied.",
           UpdatesErrorCode.InitializationError
         )
-        singletonInstance = DisabledUpdatesController(context, e)
-        return
-      }
 
-      val updatesConfiguration: UpdatesConfiguration? = overrideConfiguration ?: run {
-        when (UpdatesConfiguration.getUpdatesConfigurationValidationResult(context, null)) {
-          UpdatesConfigurationValidationResult.VALID -> {
-            return@run UpdatesConfiguration(context, null)
-          }
-          UpdatesConfigurationValidationResult.INVALID_NOT_ENABLED -> logger.warn(
-            "The expo-updates system is explicitly disabled. To enable it, set the enabled setting to true.",
-            UpdatesErrorCode.InitializationError
-          )
-          UpdatesConfigurationValidationResult.INVALID_MISSING_URL -> logger.warn(
-            "The expo-updates system is disabled due to an invalid configuration. Ensure a valid URL is supplied.",
-            UpdatesErrorCode.InitializationError
-          )
-          UpdatesConfigurationValidationResult.INVALID_MISSING_RUNTIME_VERSION -> logger.warn(
-            "The expo-updates system is disabled due to an invalid configuration. Ensure a runtime version is supplied.",
-            UpdatesErrorCode.InitializationError
-          )
-        }
-        return@run null
+        UpdatesConfigurationValidationResult.INVALID_MISSING_RUNTIME_VERSION -> logger.warn(
+          "The expo-updates system is disabled due to an invalid configuration. Ensure a runtime version is supplied.",
+          UpdatesErrorCode.InitializationError
+        )
       }
+      return@run null
+    }
 
-      singletonInstance = if (updatesConfiguration != null) {
-        EnabledUpdatesController(context, updatesConfiguration, updatesDirectory)
-      } else {
-        DisabledUpdatesController(context, null)
-      }
+    singletonInstance = if (updatesConfiguration != null) {
+      EnabledUpdatesController(context, updatesConfiguration, updatesDirectory)
+    } else {
+      DisabledUpdatesController(context, null)
     }
+  }
 
-    private fun initializeAsDevLauncherWithoutStarting(context: Context): UpdatesDevLauncherController {
-      check(singletonInstance == null) { "UpdatesController must not be initialized prior to calling initializeAsDevLauncherWithoutStarting" }
+  private fun initializeAsDevLauncherWithoutStarting(context: Context): UpdatesDevLauncherController {
+    check(singletonInstance == null) { "UpdatesController must not be initialized prior to calling initializeAsDevLauncherWithoutStarting" }
 
-      var updatesDirectoryException: Exception? = null
-      val updatesDirectory = try {
-        UpdatesUtils.getOrCreateUpdatesDirectory(context)
-      } catch (e: Exception) {
-        updatesDirectoryException = e
-        null
-      }
+    var updatesDirectoryException: Exception? = null
+    val updatesDirectory = try {
+      UpdatesUtils.getOrCreateUpdatesDirectory(context)
+    } catch (e: Exception) {
+      updatesDirectoryException = e
+      null
+    }
 
-      val initialUpdatesConfiguration = overrideConfiguration ?: run {
-        if (UpdatesConfiguration.getUpdatesConfigurationValidationResult(context, null) == UpdatesConfigurationValidationResult.VALID) {
-          UpdatesConfiguration(context, null)
-        } else {
+    val initialUpdatesConfiguration = overrideConfiguration ?: run {
+      if (UpdatesConfiguration.getUpdatesConfigurationValidationResult(
+          context,
           null
-        }
+        ) == UpdatesConfigurationValidationResult.VALID
+      ) {
+        UpdatesConfiguration(context, null)
+      } else {
+        null
       }
-
-      val instance = UpdatesDevLauncherController(
-        context,
-        initialUpdatesConfiguration,
-        updatesDirectory,
-        updatesDirectoryException
-      )
-      singletonInstance = instance
-      return instance
     }
 
-    /**
-     * Initializes the UpdatesController singleton. This should be called as early as possible in the
-     * application's lifecycle. Can pass additional configuration to this method to set or override
-     * configuration values at runtime rather than just AndroidManifest.xml.
-     * @param context the base context of the application, ideally a [ReactApplication]
-     */
-    @JvmStatic fun initialize(context: Context) {
-      if (singletonInstance == null) {
-        initializeWithoutStarting(context)
-        singletonInstance!!.start()
-      }
-    }
+    val instance = UpdatesDevLauncherController(
+      context,
+      initialUpdatesConfiguration,
+      updatesDirectory,
+      updatesDirectoryException
+    )
+    singletonInstance = instance
+    return instance
+  }
 
-    /**
-     * Overrides the [UpdatesConfiguration] that will be used inside [UpdatesController]
-     * This should be called as early as possible in the application's lifecycle.
-     * Can pass additional configuration to this method to set or override
-     * configuration values at runtime rather than just AndroidManifest.xml.
-     *
-     * @param context the base context of the application, ideally a [ReactApplication]
-     * @param configuration map of configuration pairs to override those from AndroidManifest.xml
-     */
-    @JvmStatic
-    fun overrideConfiguration(context: Context, configuration: Map<String, Any>) {
-      if (singletonInstance != null) {
-        throw AssertionError("The method should be called before UpdatesController.initialize()")
-      }
-      val updatesConfigurationValidationResult = UpdatesConfiguration.getUpdatesConfigurationValidationResult(context, configuration)
-      if (updatesConfigurationValidationResult == UpdatesConfigurationValidationResult.VALID) {
-        overrideConfiguration = UpdatesConfiguration(context, configuration)
-      } else {
-        val logger = UpdatesLogger(context)
-        logger.warn("Failed to overrideConfiguration: invalid configuration: ${updatesConfigurationValidationResult.name}")
-      }
+  /**
+   * Initializes the UpdatesController singleton. This should be called as early as possible in the
+   * application's lifecycle. Can pass additional configuration to this method to set or override
+   * configuration values at runtime rather than just AndroidManifest.xml.
+   * @param context the base context of the application, ideally a [ReactApplication]
+   */
+  @JvmStatic
+  fun initialize(context: Context) {
+    if (singletonInstance == null) {
+      initializeWithoutStarting(context)
+      singletonInstance!!.start()
     }
+  }
 
-    internal fun setUpdatesEventManagerObserver(observer: WeakReference<IUpdatesEventManagerObserver>) {
-      singletonInstance?.eventManager?.observer = observer
-      singletonInstance?.onEventListenerStartObserving()
+  /**
+   * Overrides the [UpdatesConfiguration] that will be used inside [UpdatesController]
+   * This should be called as early as possible in the application's lifecycle.
+   * Can pass additional configuration to this method to set or override
+   * configuration values at runtime rather than just AndroidManifest.xml.
+   *
+   * @param context the base context of the application, ideally a [ReactApplication]
+   * @param configuration map of configuration pairs to override those from AndroidManifest.xml
+   */
+  @JvmStatic
+  fun overrideConfiguration(context: Context, configuration: Map<String, Any>) {
+    if (singletonInstance != null) {
+      throw AssertionError("The method should be called before UpdatesController.initialize()")
     }
-
-    internal fun removeUpdatesEventManagerObserver() {
-      singletonInstance?.eventManager?.observer = null
+    val updatesConfigurationValidationResult =
+      UpdatesConfiguration.getUpdatesConfigurationValidationResult(context, configuration)
+    if (updatesConfigurationValidationResult == UpdatesConfigurationValidationResult.VALID) {
+      overrideConfiguration = UpdatesConfiguration(context, configuration)
+    } else {
+      val logger = UpdatesLogger(context.filesDir)
+      logger.warn("Failed to overrideConfiguration: invalid configuration: ${updatesConfigurationValidationResult.name}")
     }
   }
+
+  internal fun setUpdatesEventManagerObserver(observer: WeakReference<IUpdatesEventManagerObserver>) {
+    singletonInstance?.eventManager?.observer = observer
+    singletonInstance?.onEventListenerStartObserving()
+  }
+
+  internal fun removeUpdatesEventManagerObserver() {
+    singletonInstance?.eventManager?.observer = null
+  }
 }

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

@@ -54,7 +54,7 @@ class UpdatesDevLauncherController(
 
   private var launcher: Launcher? = null
 
-  private val logger = UpdatesLogger(context)
+  private val logger = UpdatesLogger(context.filesDir)
 
   private var previousUpdatesConfiguration: UpdatesConfiguration? = null
   private var updatesConfiguration: UpdatesConfiguration? = initialUpdatesConfiguration
@@ -78,8 +78,11 @@ class UpdatesDevLauncherController(
   }
 
   @get:Synchronized
-  override val launchAssetFile: String
-    get() = throw Exception("IUpdatesController.launchAssetFile should not be called in dev client")
+  override val launchAssetFile: String?
+    get() {
+      logger.warn("launchAssetFile should not be called from expo-dev-client build, except for Detox testing")
+      return null
+    }
 
   override val bundleAssetName: String
     get() = throw Exception("IUpdatesController.bundleAssetName should not be called in dev client")