expo-background-task 0.2.6 → 0.2.7

package/CHANGELOG.md

@@ -10,6 +10,13 @@
 
 ### 💡 Others
 
+## 0.2.7 — 2025-05-08
+
+### 💡 Others
+
+- Exposed testing method for background tasks on both iOS and Android ([#36732](https://github.com/expo/expo/pull/36732) by [@chrfalch](https://github.com/chrfalch))
+- Simplified how workers are started and stopped. Removed battery constraint on Android. ([#36705](https://github.com/expo/expo/pull/36705) by [@chrfalch](https://github.com/chrfalch))
+
 ## 0.2.6 — 2025-04-30
 
 _This version does not introduce any user-facing changes._

package/android/build.gradle

@@ -4,7 +4,7 @@ plugins {
 }
 
 group = 'host.exp.exponent'
-version = '0.2.6'
+version = '0.2.7'
 
 dependencies {
   implementation 'androidx.work:work-runtime-ktx:2.9.1'
@@ -15,7 +15,7 @@ android {
   namespace "expo.modules.backgroundtask"
   defaultConfig {
     versionCode 23
-    versionName "0.2.6"
+    versionName "0.2.7"
     consumerProguardFiles("proguard-rules.pro")
   }
 }

package/android/src/main/java/expo/modules/backgroundtask/BackgroundTaskConsumer.kt

@@ -37,13 +37,13 @@ class BackgroundTaskConsumer(context: Context?, taskManagerUtils: TaskManagerUti
     this.task = task
 
     val intervalMinutes = getIntervalMinutes()
-    BackgroundTaskScheduler.registerTask(intervalMinutes)
+    BackgroundTaskScheduler.registerTask(context, intervalMinutes)
   }
 
   override fun didUnregister() {
     Log.d(TAG, "didUnregister: ${task?.name}")
     this.task = null
-    BackgroundTaskScheduler.unregisterTask()
+    BackgroundTaskScheduler.unregisterTask(context)
   }
 
   private fun getIntervalMinutes(): Long {

package/android/src/main/java/expo/modules/backgroundtask/BackgroundTaskModule.kt

@@ -6,7 +6,6 @@ import expo.modules.interfaces.taskManager.TaskManagerInterface
 import expo.modules.kotlin.functions.Coroutine
 import expo.modules.kotlin.modules.Module
 import expo.modules.kotlin.modules.ModuleDefinition
-import kotlinx.coroutines.runBlocking
 
 class BackgroundTaskModule : Module() {
   companion object {
@@ -37,7 +36,7 @@ class BackgroundTaskModule : Module() {
     }
 
     AsyncFunction("registerTaskAsync") { taskName: String, options: Map<String, Any?> ->
-      Log.d(TAG, "registerTaskAsync: $taskName")
+      Log.d(TAG, "registerTaskAsync: $taskName with options $options")
       taskManager.registerTask(taskName, BackgroundTaskConsumer::class.java, options)
     }
 
@@ -46,21 +45,12 @@ class BackgroundTaskModule : Module() {
       taskManager.unregisterTask(taskName, BackgroundTaskConsumer::class.java)
     }
 
-    OnActivityEntersBackground {
-      appContext.reactContext?.let {
-        runBlocking {
-          val appScopeKey = it.packageName
-          BackgroundTaskScheduler.scheduleWorker(it, appScopeKey)
-        }
-      } ?: throw MissingContextException()
+    OnActivityEntersForeground {
+      BackgroundTaskScheduler.inForeground = true
     }
 
-    OnActivityEntersForeground {
-      appContext.reactContext?.let {
-        runBlocking {
-          BackgroundTaskScheduler.stopWorker(it)
-        }
-      } ?: throw MissingContextException()
+    OnActivityEntersBackground {
+      BackgroundTaskScheduler.inForeground = false
     }
   }
 }

package/android/src/main/java/expo/modules/backgroundtask/BackgroundTaskScheduler.kt

@@ -19,6 +19,7 @@ import kotlinx.coroutines.CancellationException
 import kotlinx.coroutines.CompletableDeferred
 import kotlinx.coroutines.Dispatchers
 import kotlinx.coroutines.awaitAll
+import kotlinx.coroutines.runBlocking
 import kotlinx.coroutines.withContext
 import java.time.Duration
 import java.util.concurrent.TimeUnit
@@ -39,25 +40,40 @@ object BackgroundTaskScheduler {
   // Interval
   private var intervalMinutes: Long = DEFAULT_INTERVAL_MINUTES
 
+  // Tracks whether in foreground
+  var inForeground: Boolean = false
+
   /**
    * Call when a task is registered
    */
-  fun registerTask(intervalMinutes: Long) {
+  fun registerTask(context: Context, intervalMinutes: Long) {
     numberOfRegisteredTasksOfThisType += 1
     this.intervalMinutes = intervalMinutes
+
+    if (numberOfRegisteredTasksOfThisType == 1) {
+      runBlocking {
+        scheduleWorker(context, context.packageName)
+      }
+    }
   }
 
   /**
    * Call when a task is unregistered
    */
-  fun unregisterTask() {
+  fun unregisterTask(context: Context) {
     numberOfRegisteredTasksOfThisType -= 1
+
+    if (numberOfRegisteredTasksOfThisType == 0) {
+      runBlocking {
+        stopWorker(context)
+      }
+    }
   }
 
   /**
    * Schedules the worker task to run. The worker should run periodically.
    */
-  suspend fun scheduleWorker(context: Context, appScopeKey: String, cancelExisting: Boolean = true): Boolean {
+  private suspend fun scheduleWorker(context: Context, appScopeKey: String, cancelExisting: Boolean = true, overriddenIntervalMinutes: Long = intervalMinutes): Boolean {
     if (numberOfRegisteredTasksOfThisType == 0) {
       Log.d(TAG, "Will not enqueue worker. No registered tasks to run.")
       return false
@@ -68,14 +84,13 @@ object BackgroundTaskScheduler {
       stopWorker(context)
     }
 
-    Log.d(TAG, "Enqueuing worker with identifier $WORKER_IDENTIFIER")
+    Log.d(TAG, "Enqueuing worker with identifier $WORKER_IDENTIFIER and '$overriddenIntervalMinutes' minutes delay.")
 
     // Build the work request
     val data = Data.Builder()
       .putString("appScopeKey", appScopeKey)
       .build()
     val constraints = Constraints.Builder()
-      .setRequiresBatteryNotLow(true)
       .setRequiredNetworkType(NetworkType.CONNECTED)
       .build()
 
@@ -95,7 +110,7 @@ object BackgroundTaskScheduler {
         .setConstraints(constraints)
 
       // Add minimum interval here as well so that the work doesn't start immediately
-      builder.setInitialDelay(Duration.ofMinutes(intervalMinutes))
+      builder.setInitialDelay(Duration.ofMinutes(overriddenIntervalMinutes))
 
       // Create work request
       val workRequest = builder.build()
@@ -144,7 +159,7 @@ object BackgroundTaskScheduler {
   /**
    * Cancels the worker task
    */
-  suspend fun stopWorker(context: Context): Boolean {
+  private suspend fun stopWorker(context: Context): Boolean {
     if (!isWorkerRunning(context)) {
       return false
     }
@@ -173,7 +188,7 @@ object BackgroundTaskScheduler {
   /**
    * Runs tasks with the given appScopeKey
    */
-  suspend fun runTasks(context: Context, appScopeKey: String): Boolean {
+  suspend fun runTasks(context: Context, appScopeKey: String) {
     // Get task service
     val taskService = TaskServiceProviderHelper.getTaskServiceImpl(context)
       ?: throw MissingTaskServiceException()
@@ -185,22 +200,42 @@ object BackgroundTaskScheduler {
     Log.d(TAG, "runTasks: number of consumers ${consumers.size}")
 
     if (consumers.isEmpty()) {
-      return false
+      return
+    }
+
+    // Make sure we're in the background before running a task
+    if (inForeground) {
+      // Schedule task in an hour (or at least minimumInterval) - the app is foregrounded and
+      // we don't want to run anything to avoid performance issues.
+      Log.d(TAG, "runTasks: App is in the foreground")
+      if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
+        scheduleWorker(context, appScopeKey, false, 60L.coerceAtMost(intervalMinutes))
+        Log.d(TAG, "runTasks: Scheduled new worker in $intervalMinutes minutes")
+      }
+      return
     }
 
     val tasks = consumers.filterIsInstance<BackgroundTaskConsumer>()
       .map { bgTaskConsumer ->
         Log.d(TAG, "runTasks: executing tasks for consumer of type ${bgTaskConsumer.taskType()}")
         val taskCompletion = CompletableDeferred<Unit>()
-        bgTaskConsumer.executeTask {
-          Log.d(TAG, "Task successfully finished")
-          taskCompletion.complete(Unit)
+        try {
+          bgTaskConsumer.executeTask {
+            Log.d(TAG, "Task successfully finished")
+            taskCompletion.complete(Unit)
+          }
+        } catch (e: Exception) {
+          Log.e(TAG, "Task failed: ${e.message}")
         }
         taskCompletion
       }
     // Await all tasks to complete
     tasks.awaitAll()
-    return true
+
+    // Schedule next task
+    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
+      scheduleWorker(context, appScopeKey, false)
+    }
   }
 
   /**

package/android/src/main/java/expo/modules/backgroundtask/BackgroundTaskWork.kt

@@ -1,7 +1,6 @@
 package expo.modules.backgroundtask
 
 import android.content.Context
-import android.os.Build
 import android.util.Log
 import androidx.work.CoroutineWorker
 import androidx.work.Data
@@ -25,12 +24,6 @@ class BackgroundTaskWork(context: Context, params: WorkerParameters) : Coroutine
       // Run tasks async using the task service. This call will return when the task has finished
       // ie. When JS task executor has notified the task manager that it is done.
       BackgroundTaskScheduler.runTasks(applicationContext, appScopeKey)
-      // If we are on a newer Android version we're using a One time request and need to spawn new
-      // requests for each run (and also ask to not try to cancel the work, since we're already
-      // finishing the work item when this function returns.
-      if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
-        BackgroundTaskScheduler.scheduleWorker(applicationContext, appScopeKey, false)
-      }
     } catch (e: Exception) {
       // Wrap exception in Data:
       val outputData = Data.Builder()

package/build/BackgroundTask.d.ts

@@ -44,8 +44,9 @@ export declare function unregisterTaskAsync(taskName: string): Promise<void>;
 /**
  * When in debug mode this function will trigger running the background tasks.
  * This function will only work for apps built in debug mode.
- * @todo(chrfalch): When we have a usable devtools plugin we can enable this function.
+ * This method is only available in development mode. It will not work in production builds.
  * @returns A promise which fulfils when the task is triggered.
  */
+export declare function triggerTaskWorkerForTestingAsync(): Promise<boolean>;
 export { BackgroundTaskStatus, BackgroundTaskResult, BackgroundTaskOptions, } from './BackgroundTask.types';
 //# sourceMappingURL=BackgroundTask.d.ts.map

package/build/BackgroundTask.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"BackgroundTask.d.ts","sourceRoot":"","sources":["../src/BackgroundTask.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAwBrF;;;;;GAKG;AACH,eAAO,MAAM,cAAc,QAAa,OAAO,CAAC,oBAAoB,CAQnE,CAAC;AAGF;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAsB,iBAAiB,CACrC,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,qBAA0B,GAClC,OAAO,CAAC,IAAI,CAAC,CA0Bf;AAGD;;;;GAIG;AACH,wBAAsB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CASzE;AAGD;;;;;GAKG;AAcH,OAAO,EACL,oBAAoB,EACpB,oBAAoB,EACpB,qBAAqB,GACtB,MAAM,wBAAwB,CAAC"}
+{"version":3,"file":"BackgroundTask.d.ts","sourceRoot":"","sources":["../src/BackgroundTask.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAwBrF;;;;;GAKG;AACH,eAAO,MAAM,cAAc,QAAa,OAAO,CAAC,oBAAoB,CAQnE,CAAC;AAGF;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAsB,iBAAiB,CACrC,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,qBAA0B,GAClC,OAAO,CAAC,IAAI,CAAC,CA0Bf;AAGD;;;;GAIG;AACH,wBAAsB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CASzE;AAGD;;;;;GAKG;AACH,wBAAsB,gCAAgC,IAAI,OAAO,CAAC,OAAO,CAAC,CAUzE;AAGD,OAAO,EACL,oBAAoB,EACpB,oBAAoB,EACpB,qBAAqB,GACtB,MAAM,wBAAwB,CAAC"}

package/build/BackgroundTask.js

@@ -106,20 +106,21 @@ export async function unregisterTaskAsync(taskName) {
 /**
  * When in debug mode this function will trigger running the background tasks.
  * This function will only work for apps built in debug mode.
- * @todo(chrfalch): When we have a usable devtools plugin we can enable this function.
+ * This method is only available in development mode. It will not work in production builds.
  * @returns A promise which fulfils when the task is triggered.
  */
-// export async function triggerTaskWorkerForTestingAsync(): Promise<boolean> {
-//   if (__DEV__) {
-//     if (!ExpoBackgroundTaskModule.triggerTaskWorkerForTestingAsync) {
-//       throw new UnavailabilityError('BackgroundTask', 'triggerTaskWorkerForTestingAsync');
-//     }
-//     console.log('Calling triggerTaskWorkerForTestingAsync');
-//     return await ExpoBackgroundTaskModule.triggerTaskWorkerForTestingAsync();
-//   } else {
-//     return Promise.resolve(false);
-//   }
-// }
+export async function triggerTaskWorkerForTestingAsync() {
+    if (__DEV__) {
+        if (!ExpoBackgroundTaskModule.triggerTaskWorkerForTestingAsync) {
+            throw new UnavailabilityError('BackgroundTask', 'triggerTaskWorkerForTestingAsync');
+        }
+        console.log('Calling triggerTaskWorkerForTestingAsync');
+        return await ExpoBackgroundTaskModule.triggerTaskWorkerForTestingAsync();
+    }
+    else {
+        return Promise.resolve(false);
+    }
+}
 // Export types
 export { BackgroundTaskStatus, BackgroundTaskResult, } from './BackgroundTask.types';
 //# sourceMappingURL=BackgroundTask.js.map

package/build/BackgroundTask.js.map

@@ -1 +1 @@
-{"version":3,"file":"BackgroundTask.js","sourceRoot":"","sources":["../src/BackgroundTask.ts"],"names":[],"mappings":"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","sourcesContent":["import { isRunningInExpoGo } from 'expo';\nimport { Platform, UnavailabilityError } from 'expo-modules-core';\nimport * as TaskManager from 'expo-task-manager';\n\nimport { BackgroundTaskOptions, BackgroundTaskStatus } from './BackgroundTask.types';\nimport ExpoBackgroundTaskModule from './ExpoBackgroundTaskModule';\n\n// Flag to warn about running on Apple simulator\nlet warnAboutRunningOniOSSimulator = false;\n\nlet warnedAboutExpoGo = false;\n\nfunction _validate(taskName: unknown) {\n  if (isRunningInExpoGo()) {\n    if (!warnedAboutExpoGo) {\n      const message =\n        '`Background Task` functionality is not available in Expo Go:\\n' +\n        'Please use a development build to avoid limitations. Learn more: https://expo.fyi/dev-client.';\n      console.warn(message);\n      warnedAboutExpoGo = true;\n    }\n  }\n  if (!taskName || typeof taskName !== 'string') {\n    throw new TypeError('`taskName` must be a non-empty string.');\n  }\n}\n\n// @needsAudit\n/**\n * Returns the status for the Background Task API. On web, it always returns `BackgroundTaskStatus.Restricted`,\n * while on native platforms it returns `BackgroundTaskStatus.Available`.\n *\n * @returns A BackgroundTaskStatus enum value or `null` if not available.\n */\nexport const getStatusAsync = async (): Promise<BackgroundTaskStatus> => {\n  if (!ExpoBackgroundTaskModule.getStatusAsync) {\n    throw new UnavailabilityError('BackgroundTask', 'getStatusAsync');\n  }\n\n  return isRunningInExpoGo()\n    ? BackgroundTaskStatus.Restricted\n    : ExpoBackgroundTaskModule.getStatusAsync();\n};\n\n// @needsAudit\n/**\n * Registers a background task with the given name. Registered tasks are saved in persistent storage and restored once the app is initialized.\n * @param taskName Name of the task to register. The task needs to be defined first - see [`TaskManager.defineTask`](task-manager/#taskmanagerdefinetasktaskname-taskexecutor)\n * for more details.\n * @param options An object containing the background task options.\n *\n * @example\n * ```ts\n * import * as TaskManager from 'expo-task-manager';\n *\n * // Register the task outside of the component\n * TaskManager.defineTask(BACKGROUND_TASK_IDENTIFIER, () => {\n *   try {\n *     await AsyncStorage.setItem(LAST_TASK_DATE_KEY, Date.now().toString());\n *   } catch (error) {\n *     console.error('Failed to save the last fetch date', error);\n *     return BackgroundTaskResult.Failed;\n *   }\n *   return BackgroundTaskResult.Success;\n * });\n * ```\n *\n * You can now use the `registerTaskAsync` function to register the task:\n *\n * ```ts\n * BackgroundTask.registerTaskAsync(BACKGROUND_TASK_IDENTIFIER, {});\n * ```\n */\nexport async function registerTaskAsync(\n  taskName: string,\n  options: BackgroundTaskOptions = {}\n): Promise<void> {\n  if (!ExpoBackgroundTaskModule.registerTaskAsync) {\n    throw new UnavailabilityError('BackgroundTask', 'registerTaskAsync');\n  }\n  if (!TaskManager.isTaskDefined(taskName)) {\n    throw new Error(\n      `Task '${taskName}' is not defined. You must define a task using TaskManager.defineTask before registering.`\n    );\n  }\n\n  if ((await ExpoBackgroundTaskModule.getStatusAsync()) === BackgroundTaskStatus.Restricted) {\n    if (!warnAboutRunningOniOSSimulator) {\n      const message =\n        Platform.OS === 'ios'\n          ? `Background tasks are not supported on iOS simulators. Skipped registering task: ${taskName}.`\n          : `Background tasks are not available in the current environment. Skipped registering task: ${taskName}.`;\n      console.warn(message);\n      warnAboutRunningOniOSSimulator = true;\n    }\n    return;\n  }\n  _validate(taskName);\n  if (await TaskManager.isTaskRegisteredAsync(taskName)) {\n    return;\n  }\n  await ExpoBackgroundTaskModule.registerTaskAsync(taskName, options);\n}\n\n// @needsAudit\n/**\n * Unregisters a background task, so the application will no longer be executing this task.\n * @param taskName Name of the task to unregister.\n * @return A promise which fulfils when the task is fully unregistered.\n */\nexport async function unregisterTaskAsync(taskName: string): Promise<void> {\n  if (!ExpoBackgroundTaskModule.unregisterTaskAsync) {\n    throw new UnavailabilityError('BackgroundTask', 'unregisterTaskAsync');\n  }\n  _validate(taskName);\n  if (!(await TaskManager.isTaskRegisteredAsync(taskName))) {\n    return;\n  }\n  await ExpoBackgroundTaskModule.unregisterTaskAsync(taskName);\n}\n\n// @needsAudit\n/**\n * When in debug mode this function will trigger running the background tasks.\n * This function will only work for apps built in debug mode.\n * @todo(chrfalch): When we have a usable devtools plugin we can enable this function.\n * @returns A promise which fulfils when the task is triggered.\n */\n// export async function triggerTaskWorkerForTestingAsync(): Promise<boolean> {\n//   if (__DEV__) {\n//     if (!ExpoBackgroundTaskModule.triggerTaskWorkerForTestingAsync) {\n//       throw new UnavailabilityError('BackgroundTask', 'triggerTaskWorkerForTestingAsync');\n//     }\n//     console.log('Calling triggerTaskWorkerForTestingAsync');\n//     return await ExpoBackgroundTaskModule.triggerTaskWorkerForTestingAsync();\n//   } else {\n//     return Promise.resolve(false);\n//   }\n// }\n\n// Export types\nexport {\n  BackgroundTaskStatus,\n  BackgroundTaskResult,\n  BackgroundTaskOptions,\n} from './BackgroundTask.types';\n"]}
+{"version":3,"file":"BackgroundTask.js","sourceRoot":"","sources":["../src/BackgroundTask.ts"],"names":[],"mappings":"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","sourcesContent":["import { isRunningInExpoGo } from 'expo';\nimport { Platform, UnavailabilityError } from 'expo-modules-core';\nimport * as TaskManager from 'expo-task-manager';\n\nimport { BackgroundTaskOptions, BackgroundTaskStatus } from './BackgroundTask.types';\nimport ExpoBackgroundTaskModule from './ExpoBackgroundTaskModule';\n\n// Flag to warn about running on Apple simulator\nlet warnAboutRunningOniOSSimulator = false;\n\nlet warnedAboutExpoGo = false;\n\nfunction _validate(taskName: unknown) {\n  if (isRunningInExpoGo()) {\n    if (!warnedAboutExpoGo) {\n      const message =\n        '`Background Task` functionality is not available in Expo Go:\\n' +\n        'Please use a development build to avoid limitations. Learn more: https://expo.fyi/dev-client.';\n      console.warn(message);\n      warnedAboutExpoGo = true;\n    }\n  }\n  if (!taskName || typeof taskName !== 'string') {\n    throw new TypeError('`taskName` must be a non-empty string.');\n  }\n}\n\n// @needsAudit\n/**\n * Returns the status for the Background Task API. On web, it always returns `BackgroundTaskStatus.Restricted`,\n * while on native platforms it returns `BackgroundTaskStatus.Available`.\n *\n * @returns A BackgroundTaskStatus enum value or `null` if not available.\n */\nexport const getStatusAsync = async (): Promise<BackgroundTaskStatus> => {\n  if (!ExpoBackgroundTaskModule.getStatusAsync) {\n    throw new UnavailabilityError('BackgroundTask', 'getStatusAsync');\n  }\n\n  return isRunningInExpoGo()\n    ? BackgroundTaskStatus.Restricted\n    : ExpoBackgroundTaskModule.getStatusAsync();\n};\n\n// @needsAudit\n/**\n * Registers a background task with the given name. Registered tasks are saved in persistent storage and restored once the app is initialized.\n * @param taskName Name of the task to register. The task needs to be defined first - see [`TaskManager.defineTask`](task-manager/#taskmanagerdefinetasktaskname-taskexecutor)\n * for more details.\n * @param options An object containing the background task options.\n *\n * @example\n * ```ts\n * import * as TaskManager from 'expo-task-manager';\n *\n * // Register the task outside of the component\n * TaskManager.defineTask(BACKGROUND_TASK_IDENTIFIER, () => {\n *   try {\n *     await AsyncStorage.setItem(LAST_TASK_DATE_KEY, Date.now().toString());\n *   } catch (error) {\n *     console.error('Failed to save the last fetch date', error);\n *     return BackgroundTaskResult.Failed;\n *   }\n *   return BackgroundTaskResult.Success;\n * });\n * ```\n *\n * You can now use the `registerTaskAsync` function to register the task:\n *\n * ```ts\n * BackgroundTask.registerTaskAsync(BACKGROUND_TASK_IDENTIFIER, {});\n * ```\n */\nexport async function registerTaskAsync(\n  taskName: string,\n  options: BackgroundTaskOptions = {}\n): Promise<void> {\n  if (!ExpoBackgroundTaskModule.registerTaskAsync) {\n    throw new UnavailabilityError('BackgroundTask', 'registerTaskAsync');\n  }\n  if (!TaskManager.isTaskDefined(taskName)) {\n    throw new Error(\n      `Task '${taskName}' is not defined. You must define a task using TaskManager.defineTask before registering.`\n    );\n  }\n\n  if ((await ExpoBackgroundTaskModule.getStatusAsync()) === BackgroundTaskStatus.Restricted) {\n    if (!warnAboutRunningOniOSSimulator) {\n      const message =\n        Platform.OS === 'ios'\n          ? `Background tasks are not supported on iOS simulators. Skipped registering task: ${taskName}.`\n          : `Background tasks are not available in the current environment. Skipped registering task: ${taskName}.`;\n      console.warn(message);\n      warnAboutRunningOniOSSimulator = true;\n    }\n    return;\n  }\n  _validate(taskName);\n  if (await TaskManager.isTaskRegisteredAsync(taskName)) {\n    return;\n  }\n  await ExpoBackgroundTaskModule.registerTaskAsync(taskName, options);\n}\n\n// @needsAudit\n/**\n * Unregisters a background task, so the application will no longer be executing this task.\n * @param taskName Name of the task to unregister.\n * @return A promise which fulfils when the task is fully unregistered.\n */\nexport async function unregisterTaskAsync(taskName: string): Promise<void> {\n  if (!ExpoBackgroundTaskModule.unregisterTaskAsync) {\n    throw new UnavailabilityError('BackgroundTask', 'unregisterTaskAsync');\n  }\n  _validate(taskName);\n  if (!(await TaskManager.isTaskRegisteredAsync(taskName))) {\n    return;\n  }\n  await ExpoBackgroundTaskModule.unregisterTaskAsync(taskName);\n}\n\n// @needsAudit\n/**\n * When in debug mode this function will trigger running the background tasks.\n * This function will only work for apps built in debug mode.\n * This method is only available in development mode. It will not work in production builds.\n * @returns A promise which fulfils when the task is triggered.\n */\nexport async function triggerTaskWorkerForTestingAsync(): Promise<boolean> {\n  if (__DEV__) {\n    if (!ExpoBackgroundTaskModule.triggerTaskWorkerForTestingAsync) {\n      throw new UnavailabilityError('BackgroundTask', 'triggerTaskWorkerForTestingAsync');\n    }\n    console.log('Calling triggerTaskWorkerForTestingAsync');\n    return await ExpoBackgroundTaskModule.triggerTaskWorkerForTestingAsync();\n  } else {\n    return Promise.resolve(false);\n  }\n}\n\n// Export types\nexport {\n  BackgroundTaskStatus,\n  BackgroundTaskResult,\n  BackgroundTaskOptions,\n} from './BackgroundTask.types';\n"]}

package/build/BackgroundTask.types.d.ts

@@ -32,9 +32,11 @@ export type BackgroundTaskOptions = {
      * Inexact interval in minutes between subsequent repeats of the background tasks. The final
      * interval may differ from the specified one to minimize wakeups and battery usage.
      * - Defaults to once every 12 hours (The minimum interval is 15 minutes)
-     * - On iOS, the system determines the interval for background task execution,
-     *  but will wait until the specified minimum interval has elapsed before starting a task.
-     * @platform android
+     * - The system controls the background task execution interval and treats the
+     * specified value as a minimum delay. Tasks won't run exactly on schedule. On iOS, short
+     * intervals are often ignored—the system typically runs background tasks during
+     * specific windows, such as overnight.
+     *
      */
     minimumInterval?: number;
 };

package/build/BackgroundTask.types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"BackgroundTask.types.d.ts","sourceRoot":"","sources":["../src/BackgroundTask.types.ts"],"names":[],"mappings":"AACA;;GAEG;AACH,oBAAY,oBAAoB;IAC9B;;OAEG;IACH,UAAU,IAAI;IACd;;OAEG;IACH,SAAS,IAAI;CACd;AAGD;;GAEG;AACH,oBAAY,oBAAoB;IAC9B;;OAEG;IACH,OAAO,IAAI;IACX;;OAEG;IACH,MAAM,IAAI;CACX;AAGD;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAAG;IAClC;;;;;;;OAOG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B,CAAC"}
+{"version":3,"file":"BackgroundTask.types.d.ts","sourceRoot":"","sources":["../src/BackgroundTask.types.ts"],"names":[],"mappings":"AACA;;GAEG;AACH,oBAAY,oBAAoB;IAC9B;;OAEG;IACH,UAAU,IAAI;IACd;;OAEG;IACH,SAAS,IAAI;CACd;AAGD;;GAEG;AACH,oBAAY,oBAAoB;IAC9B;;OAEG;IACH,OAAO,IAAI;IACX;;OAEG;IACH,MAAM,IAAI;CACX;AAGD;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAAG;IAClC;;;;;;;;;OASG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B,CAAC"}

package/build/BackgroundTask.types.js.map

@@ -1 +1 @@
-{"version":3,"file":"BackgroundTask.types.js","sourceRoot":"","sources":["../src/BackgroundTask.types.ts"],"names":[],"mappings":"AAAA,cAAc;AACd;;GAEG;AACH,MAAM,CAAN,IAAY,oBASX;AATD,WAAY,oBAAoB;IAC9B;;OAEG;IACH,2EAAc,CAAA;IACd;;OAEG;IACH,yEAAa,CAAA;AACf,CAAC,EATW,oBAAoB,KAApB,oBAAoB,QAS/B;AAED,cAAc;AACd;;GAEG;AACH,MAAM,CAAN,IAAY,oBASX;AATD,WAAY,oBAAoB;IAC9B;;OAEG;IACH,qEAAW,CAAA;IACX;;OAEG;IACH,mEAAU,CAAA;AACZ,CAAC,EATW,oBAAoB,KAApB,oBAAoB,QAS/B","sourcesContent":["// @needsAudit\n/**\n * Availability status for background tasks\n */\nexport enum BackgroundTaskStatus {\n  /**\n   * Background tasks are unavailable.\n   */\n  Restricted = 1,\n  /**\n   * Background tasks are available for the app.\n   */\n  Available = 2,\n}\n\n// @needsAudit\n/**\n * Return value for background tasks.\n */\nexport enum BackgroundTaskResult {\n  /**\n   * The task finished successfully.\n   */\n  Success = 1,\n  /**\n   * The task failed.\n   */\n  Failed = 2,\n}\n\n// @needsAudit\n/**\n * Options for registering a background task\n */\nexport type BackgroundTaskOptions = {\n  /**\n   * Inexact interval in minutes between subsequent repeats of the background tasks. The final\n   * interval may differ from the specified one to minimize wakeups and battery usage.\n   * - Defaults to once every 12 hours (The minimum interval is 15 minutes)\n   * - On iOS, the system determines the interval for background task execution,\n   *  but will wait until the specified minimum interval has elapsed before starting a task.\n   * @platform android\n   */\n  minimumInterval?: number;\n};\n"]}
+{"version":3,"file":"BackgroundTask.types.js","sourceRoot":"","sources":["../src/BackgroundTask.types.ts"],"names":[],"mappings":"AAAA,cAAc;AACd;;GAEG;AACH,MAAM,CAAN,IAAY,oBASX;AATD,WAAY,oBAAoB;IAC9B;;OAEG;IACH,2EAAc,CAAA;IACd;;OAEG;IACH,yEAAa,CAAA;AACf,CAAC,EATW,oBAAoB,KAApB,oBAAoB,QAS/B;AAED,cAAc;AACd;;GAEG;AACH,MAAM,CAAN,IAAY,oBASX;AATD,WAAY,oBAAoB;IAC9B;;OAEG;IACH,qEAAW,CAAA;IACX;;OAEG;IACH,mEAAU,CAAA;AACZ,CAAC,EATW,oBAAoB,KAApB,oBAAoB,QAS/B","sourcesContent":["// @needsAudit\n/**\n * Availability status for background tasks\n */\nexport enum BackgroundTaskStatus {\n  /**\n   * Background tasks are unavailable.\n   */\n  Restricted = 1,\n  /**\n   * Background tasks are available for the app.\n   */\n  Available = 2,\n}\n\n// @needsAudit\n/**\n * Return value for background tasks.\n */\nexport enum BackgroundTaskResult {\n  /**\n   * The task finished successfully.\n   */\n  Success = 1,\n  /**\n   * The task failed.\n   */\n  Failed = 2,\n}\n\n// @needsAudit\n/**\n * Options for registering a background task\n */\nexport type BackgroundTaskOptions = {\n  /**\n   * Inexact interval in minutes between subsequent repeats of the background tasks. The final\n   * interval may differ from the specified one to minimize wakeups and battery usage.\n   * - Defaults to once every 12 hours (The minimum interval is 15 minutes)\n   * - The system controls the background task execution interval and treats the\n   * specified value as a minimum delay. Tasks won't run exactly on schedule. On iOS, short\n   * intervals are often ignored—the system typically runs background tasks during\n   * specific windows, such as overnight.\n   *\n   */\n  minimumInterval?: number;\n};\n"]}

package/expo-module.config.json

@@ -5,12 +5,6 @@
     "modules": ["BackgroundTaskModule"]
   },
   "android": {
-    "modules": ["expo.modules.backgroundtask.BackgroundTaskModule"],
-    "publication": {
-      "groupId": "host.exp.exponent",
-      "artifactId": "expo.modules.backgroundtask",
-      "version": "0.2.6",
-      "repository": "local-maven-repo"
-    }
+    "modules": ["expo.modules.backgroundtask.BackgroundTaskModule"]
   }
 }

package/ios/BackgroundTaskModule.swift

@@ -12,11 +12,7 @@ public class BackgroundTaskModule: Module {
     }
 
     AsyncFunction("triggerTaskWorkerForTestingAsync") {
-      if await BackgroundTaskScheduler.isWorkerRunning() {
-        BackgroundTaskDebugHelper.triggerBackgroundTaskTest()
-        return true
-      }
-      return false
+      BackgroundTaskDebugHelper.triggerBackgroundTaskTest()
     }
 
     AsyncFunction("registerTaskAsync") { (name: String, options: [String: Any]) in
@@ -56,23 +52,5 @@ public class BackgroundTaskModule: Module {
       return BackgroundTaskScheduler.supportsBackgroundTasks() ?
         BackgroundTaskStatus.available : .restricted
     }
-
-    OnAppEntersBackground {
-      Task {
-        // Try start worker when app enters background
-        do {
-          try await BackgroundTaskScheduler.tryScheduleWorker()
-        } catch {
-          log.error("Could not schedule the worker: \(error.localizedDescription)")
-        }
-      }
-    }
-
-    OnAppEntersForeground {
-      Task {
-        // When entering foreground we'll stop the worker
-        await BackgroundTaskScheduler.stopWorker()
-      }
-    }
   }
 }

package/ios/BackgroundTaskScheduler.swift

@@ -21,6 +21,12 @@ public class BackgroundTaskScheduler {
       intervalSeconds = Double(minutes) * 60
     }
     numberOfRegisteredTasksOfThisType += 1
+
+    if numberOfRegisteredTasksOfThisType == 1 {
+      Task {
+        try await tryScheduleWorker()
+      }
+    }
   }
 
   /**
@@ -28,6 +34,11 @@ public class BackgroundTaskScheduler {
    */
   public static func didUnregisterTask() {
     numberOfRegisteredTasksOfThisType -= 1
+    if numberOfRegisteredTasksOfThisType == 0 {
+      Task {
+        await stopWorker()
+      }
+    }
   }
 
   /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "expo-background-task",
-  "version": "0.2.6",
+  "version": "0.2.7",
   "description": "Expo Android and iOS module for Background Task APIs",
   "main": "build/BackgroundTask.js",
   "types": "build/BackgroundTask.d.ts",
@@ -35,10 +35,10 @@
     "expo-task-manager": "~13.1.5"
   },
   "devDependencies": {
-    "expo-module-scripts": "^4.1.6"
+    "expo-module-scripts": "^4.1.7"
   },
   "peerDependencies": {
     "expo": "*"
   },
-  "gitHead": "84355076bc31a356aa3d23257f387f221885f53d"
+  "gitHead": "49c9d53cf0a9fc8179d1c8f5268beadd141f70ca"
 }

package/src/BackgroundTask.ts

@@ -123,20 +123,20 @@ export async function unregisterTaskAsync(taskName: string): Promise<void> {
 /**
  * When in debug mode this function will trigger running the background tasks.
  * This function will only work for apps built in debug mode.
- * @todo(chrfalch): When we have a usable devtools plugin we can enable this function.
+ * This method is only available in development mode. It will not work in production builds.
  * @returns A promise which fulfils when the task is triggered.
  */
-// export async function triggerTaskWorkerForTestingAsync(): Promise<boolean> {
-//   if (__DEV__) {
-//     if (!ExpoBackgroundTaskModule.triggerTaskWorkerForTestingAsync) {
-//       throw new UnavailabilityError('BackgroundTask', 'triggerTaskWorkerForTestingAsync');
-//     }
-//     console.log('Calling triggerTaskWorkerForTestingAsync');
-//     return await ExpoBackgroundTaskModule.triggerTaskWorkerForTestingAsync();
-//   } else {
-//     return Promise.resolve(false);
-//   }
-// }
+export async function triggerTaskWorkerForTestingAsync(): Promise<boolean> {
+  if (__DEV__) {
+    if (!ExpoBackgroundTaskModule.triggerTaskWorkerForTestingAsync) {
+      throw new UnavailabilityError('BackgroundTask', 'triggerTaskWorkerForTestingAsync');
+    }
+    console.log('Calling triggerTaskWorkerForTestingAsync');
+    return await ExpoBackgroundTaskModule.triggerTaskWorkerForTestingAsync();
+  } else {
+    return Promise.resolve(false);
+  }
+}
 
 // Export types
 export {

package/src/BackgroundTask.types.ts

@@ -37,9 +37,11 @@ export type BackgroundTaskOptions = {
    * Inexact interval in minutes between subsequent repeats of the background tasks. The final
    * interval may differ from the specified one to minimize wakeups and battery usage.
    * - Defaults to once every 12 hours (The minimum interval is 15 minutes)
-   * - On iOS, the system determines the interval for background task execution,
-   *  but will wait until the specified minimum interval has elapsed before starting a task.
-   * @platform android
+   * - The system controls the background task execution interval and treats the
+   * specified value as a minimum delay. Tasks won't run exactly on schedule. On iOS, short
+   * intervals are often ignored—the system typically runs background tasks during
+   * specific windows, such as overnight.
+   *
    */
   minimumInterval?: number;
 };

package/local-maven-repo/host/exp/exponent/expo.modules.backgroundtask/0.2.6/expo.modules.backgroundtask-0.2.6-sources.jar.md5

@@ -1 +0,0 @@
-5f6622176ce030ca75524a6962204d5f

package/local-maven-repo/host/exp/exponent/expo.modules.backgroundtask/0.2.6/expo.modules.backgroundtask-0.2.6-sources.jar.sha1

@@ -1 +0,0 @@
-6915c923122c872b1efb67841662515629f6df68

package/local-maven-repo/host/exp/exponent/expo.modules.backgroundtask/0.2.6/expo.modules.backgroundtask-0.2.6-sources.jar.sha256

@@ -1 +0,0 @@
-4019bc874cc09d9187352e03c4f54941c7abd91e4a3d8b41c2aaf351dd7ba28e

package/local-maven-repo/host/exp/exponent/expo.modules.backgroundtask/0.2.6/expo.modules.backgroundtask-0.2.6-sources.jar.sha512

@@ -1 +0,0 @@
-558f8112433c958b3ce00edac1b1e08835137759aca7f9344968661df70dccbaffb9a193a2a8f186b193edb6e59d0e94021a69455a5f04f6b5495a155ba7560f

package/local-maven-repo/host/exp/exponent/expo.modules.backgroundtask/0.2.6/expo.modules.backgroundtask-0.2.6.aar.md5

@@ -1 +0,0 @@
-e0acabbb1e698252139204a38916e1de

package/local-maven-repo/host/exp/exponent/expo.modules.backgroundtask/0.2.6/expo.modules.backgroundtask-0.2.6.aar.sha1

@@ -1 +0,0 @@
-d4e79935b62afcaf84d57b95f256df6a41586bfa

package/local-maven-repo/host/exp/exponent/expo.modules.backgroundtask/0.2.6/expo.modules.backgroundtask-0.2.6.aar.sha256

@@ -1 +0,0 @@
-cbc6bb1d4a80dac949caf56fea16e50d38c9a5a4a690a2f6a5bf04cd929fbd73

package/local-maven-repo/host/exp/exponent/expo.modules.backgroundtask/0.2.6/expo.modules.backgroundtask-0.2.6.aar.sha512

@@ -1 +0,0 @@
-176311633c2d7c17756447ddc521a4d6dd6ee13adb6862150517290b87b7ed89048e5d0d73b64309ea4240bb1edb2d79b4d35b61069b2eb6853689a4c185d6fd

package/local-maven-repo/host/exp/exponent/expo.modules.backgroundtask/0.2.6/expo.modules.backgroundtask-0.2.6.module

@@ -1,98 +0,0 @@
-{
-  "formatVersion": "1.1",
-  "component": {
-    "group": "host.exp.exponent",
-    "module": "expo.modules.backgroundtask",
-    "version": "0.2.6",
-    "attributes": {
-      "org.gradle.status": "release"
-    }
-  },
-  "createdBy": {
-    "gradle": {
-      "version": "8.13"
-    }
-  },
-  "variants": [
-    {
-      "name": "releaseVariantReleaseApiPublication",
-      "attributes": {
-        "org.gradle.category": "library",
-        "org.gradle.dependency.bundling": "external",
-        "org.gradle.libraryelements": "aar",
-        "org.gradle.usage": "java-api"
-      },
-      "files": [
-        {
-          "name": "expo.modules.backgroundtask-0.2.6.aar",
-          "url": "expo.modules.backgroundtask-0.2.6.aar",
-          "size": 47827,
-          "sha512": "176311633c2d7c17756447ddc521a4d6dd6ee13adb6862150517290b87b7ed89048e5d0d73b64309ea4240bb1edb2d79b4d35b61069b2eb6853689a4c185d6fd",
-          "sha256": "cbc6bb1d4a80dac949caf56fea16e50d38c9a5a4a690a2f6a5bf04cd929fbd73",
-          "sha1": "d4e79935b62afcaf84d57b95f256df6a41586bfa",
-          "md5": "e0acabbb1e698252139204a38916e1de"
-        }
-      ]
-    },
-    {
-      "name": "releaseVariantReleaseRuntimePublication",
-      "attributes": {
-        "org.gradle.category": "library",
-        "org.gradle.dependency.bundling": "external",
-        "org.gradle.libraryelements": "aar",
-        "org.gradle.usage": "java-runtime"
-      },
-      "dependencies": [
-        {
-          "group": "org.jetbrains.kotlin",
-          "module": "kotlin-stdlib-jdk7",
-          "version": {
-            "requires": "2.0.21"
-          }
-        },
-        {
-          "group": "androidx.work",
-          "module": "work-runtime-ktx",
-          "version": {
-            "requires": "2.9.1"
-          }
-        },
-        {
-          "group": "com.facebook.react",
-          "module": "react-android"
-        }
-      ],
-      "files": [
-        {
-          "name": "expo.modules.backgroundtask-0.2.6.aar",
-          "url": "expo.modules.backgroundtask-0.2.6.aar",
-          "size": 47827,
-          "sha512": "176311633c2d7c17756447ddc521a4d6dd6ee13adb6862150517290b87b7ed89048e5d0d73b64309ea4240bb1edb2d79b4d35b61069b2eb6853689a4c185d6fd",
-          "sha256": "cbc6bb1d4a80dac949caf56fea16e50d38c9a5a4a690a2f6a5bf04cd929fbd73",
-          "sha1": "d4e79935b62afcaf84d57b95f256df6a41586bfa",
-          "md5": "e0acabbb1e698252139204a38916e1de"
-        }
-      ]
-    },
-    {
-      "name": "releaseVariantReleaseSourcePublication",
-      "attributes": {
-        "org.gradle.category": "documentation",
-        "org.gradle.dependency.bundling": "external",
-        "org.gradle.docstype": "sources",
-        "org.gradle.usage": "java-runtime"
-      },
-      "files": [
-        {
-          "name": "expo.modules.backgroundtask-0.2.6-sources.jar",
-          "url": "expo.modules.backgroundtask-0.2.6-sources.jar",
-          "size": 6743,
-          "sha512": "558f8112433c958b3ce00edac1b1e08835137759aca7f9344968661df70dccbaffb9a193a2a8f186b193edb6e59d0e94021a69455a5f04f6b5495a155ba7560f",
-          "sha256": "4019bc874cc09d9187352e03c4f54941c7abd91e4a3d8b41c2aaf351dd7ba28e",
-          "sha1": "6915c923122c872b1efb67841662515629f6df68",
-          "md5": "5f6622176ce030ca75524a6962204d5f"
-        }
-      ]
-    }
-  ]
-}

package/local-maven-repo/host/exp/exponent/expo.modules.backgroundtask/0.2.6/expo.modules.backgroundtask-0.2.6.module.md5

@@ -1 +0,0 @@
-193cad2bf21c0848ad2f20311280ed57

package/local-maven-repo/host/exp/exponent/expo.modules.backgroundtask/0.2.6/expo.modules.backgroundtask-0.2.6.module.sha1

@@ -1 +0,0 @@
-1dcffaa1767bf3591015c727e246069c506145ec

package/local-maven-repo/host/exp/exponent/expo.modules.backgroundtask/0.2.6/expo.modules.backgroundtask-0.2.6.module.sha256

@@ -1 +0,0 @@
-1070ab1cece5ccfa65521802fb44a46353002ffa8335c2ce1ddb5e288d37cc73

package/local-maven-repo/host/exp/exponent/expo.modules.backgroundtask/0.2.6/expo.modules.backgroundtask-0.2.6.module.sha512

@@ -1 +0,0 @@
-88f4a2939e19813f4703963fddbe4e2428cd446c343b9c83f50f5564117d0b244b30a713885757a3fc057e7256da927e96de75c5ec957483fa26a3e384a7060a

package/local-maven-repo/host/exp/exponent/expo.modules.backgroundtask/0.2.6/expo.modules.backgroundtask-0.2.6.pom

@@ -1,46 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<project xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd" xmlns="http://maven.apache.org/POM/4.0.0"
-    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
-  <!-- This module was also published with a richer model, Gradle metadata,  -->
-  <!-- which should be used instead. Do not delete the following line which  -->
-  <!-- is to indicate to Gradle or any Gradle module metadata file consumer  -->
-  <!-- that they should prefer consuming it instead. -->
-  <!-- do_not_remove: published-with-gradle-metadata -->
-  <modelVersion>4.0.0</modelVersion>
-  <groupId>host.exp.exponent</groupId>
-  <artifactId>expo.modules.backgroundtask</artifactId>
-  <version>0.2.6</version>
-  <packaging>aar</packaging>
-  <name>expo.modules.backgroundtask</name>
-  <url>https://github.com/expo/expo</url>
-  <licenses>
-    <license>
-      <name>MIT License</name>
-      <url>https://github.com/expo/expo/blob/main/LICENSE</url>
-    </license>
-  </licenses>
-  <scm>
-    <connection>https://github.com/expo/expo.git</connection>
-    <developerConnection>https://github.com/expo/expo.git</developerConnection>
-    <url>https://github.com/expo/expo</url>
-  </scm>
-  <dependencies>
-    <dependency>
-      <groupId>org.jetbrains.kotlin</groupId>
-      <artifactId>kotlin-stdlib-jdk7</artifactId>
-      <version>2.0.21</version>
-      <scope>runtime</scope>
-    </dependency>
-    <dependency>
-      <groupId>androidx.work</groupId>
-      <artifactId>work-runtime-ktx</artifactId>
-      <version>2.9.1</version>
-      <scope>runtime</scope>
-    </dependency>
-    <dependency>
-      <groupId>com.facebook.react</groupId>
-      <artifactId>react-android</artifactId>
-      <scope>runtime</scope>
-    </dependency>
-  </dependencies>
-</project>

package/local-maven-repo/host/exp/exponent/expo.modules.backgroundtask/0.2.6/expo.modules.backgroundtask-0.2.6.pom.md5

@@ -1 +0,0 @@
-b01b44a40e7d3489fe12ff2e389357ab

package/local-maven-repo/host/exp/exponent/expo.modules.backgroundtask/0.2.6/expo.modules.backgroundtask-0.2.6.pom.sha1

@@ -1 +0,0 @@
-042f11cc6f50153ade08f17b85939fab1bcbfc69

package/local-maven-repo/host/exp/exponent/expo.modules.backgroundtask/0.2.6/expo.modules.backgroundtask-0.2.6.pom.sha256

@@ -1 +0,0 @@
-e6c998b29f76c61123792526727f3a28e870476ca1ed14cc2837a380d38dcf19

package/local-maven-repo/host/exp/exponent/expo.modules.backgroundtask/0.2.6/expo.modules.backgroundtask-0.2.6.pom.sha512

@@ -1 +0,0 @@
-34d80cb85240d24e0773d0e96155065849f218b39740647103c10295033aeec90ceb0c9f86cc0d180d34e24dfbe59b975741d1b15bcdb40cc22c9c8f7283cd8e

package/local-maven-repo/host/exp/exponent/expo.modules.backgroundtask/maven-metadata.xml

@@ -1,13 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<metadata>
-  <groupId>host.exp.exponent</groupId>
-  <artifactId>expo.modules.backgroundtask</artifactId>
-  <versioning>
-    <latest>0.2.6</latest>
-    <release>0.2.6</release>
-    <versions>
-      <version>0.2.6</version>
-    </versions>
-    <lastUpdated>20250430211459</lastUpdated>
-  </versioning>
-</metadata>

package/local-maven-repo/host/exp/exponent/expo.modules.backgroundtask/maven-metadata.xml.md5

@@ -1 +0,0 @@
-d124045fdb9bab038e1583b22f18de1f

package/local-maven-repo/host/exp/exponent/expo.modules.backgroundtask/maven-metadata.xml.sha1

@@ -1 +0,0 @@
-4c460dd9b460b2f0772988a706830108a6aa56a1

package/local-maven-repo/host/exp/exponent/expo.modules.backgroundtask/maven-metadata.xml.sha256

@@ -1 +0,0 @@
-1e386862747f3520f4ba51a9bab938dfbdb638d041f1a48c15cf05f4f81ce540

package/local-maven-repo/host/exp/exponent/expo.modules.backgroundtask/maven-metadata.xml.sha512

@@ -1 +0,0 @@
-80e5727a10efbe6c2789d0e67de8b1584bc8ce9211638f76082d9b36f80079e176e44784ca79eb0fe525d19fc50f1d67a4d9ab2ea24841844f687094476475e5