expo-background-task 0.2.4 → 0.2.6

package/CHANGELOG.md

@@ -10,6 +10,16 @@
 
 ### 💡 Others
 
+## 0.2.6 — 2025-04-30
+
+_This version does not introduce any user-facing changes._
+
+## 0.2.5 — 2025-04-25
+
+### 💡 Others
+
+- Removed throwing an exception if registerTaskAsync/unregisterTaskAsync is called on a task that is already registered/unregistered ([#36393](https://github.com/expo/expo/pull/36393) by [@chrfalch](https://github.com/chrfalch))
+
 ## 0.2.4 — 2025-04-14
 
 _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.4'
+version = '0.2.6'
 
 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.4"
+    versionName "0.2.6"
     consumerProguardFiles("proguard-rules.pro")
   }
 }

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,CAyBf;AAGD;;;;GAIG;AACH,wBAAsB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAUzE;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,OAAO,EACL,oBAAoB,EACpB,oBAAoB,EACpB,qBAAqB,GACtB,MAAM,wBAAwB,CAAC"}

package/build/BackgroundTask.js

@@ -70,9 +70,6 @@ export async function registerTaskAsync(taskName, options = {}) {
     if (!TaskManager.isTaskDefined(taskName)) {
         throw new Error(`Task '${taskName}' is not defined. You must define a task using TaskManager.defineTask before registering.`);
     }
-    if (await TaskManager.isTaskRegisteredAsync(taskName)) {
-        throw new Error(`Task '${taskName}' is already registered.`);
-    }
     if ((await ExpoBackgroundTaskModule.getStatusAsync()) === BackgroundTaskStatus.Restricted) {
         if (!warnAboutRunningOniOSSimulator) {
             const message = Platform.OS === 'ios'
@@ -84,6 +81,9 @@ export async function registerTaskAsync(taskName, options = {}) {
         return;
     }
     _validate(taskName);
+    if (await TaskManager.isTaskRegisteredAsync(taskName)) {
+        return;
+    }
     await ExpoBackgroundTaskModule.registerTaskAsync(taskName, options);
 }
 // @needsAudit
@@ -96,10 +96,10 @@ export async function unregisterTaskAsync(taskName) {
     if (!ExpoBackgroundTaskModule.unregisterTaskAsync) {
         throw new UnavailabilityError('BackgroundTask', 'unregisterTaskAsync');
     }
+    _validate(taskName);
     if (!(await TaskManager.isTaskRegisteredAsync(taskName))) {
-        throw new Error(`Task '${taskName}' is not registered.`);
+        return;
     }
-    _validate(taskName);
     await ExpoBackgroundTaskModule.unregisterTaskAsync(taskName);
 }
 // @needsAudit

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  if (await TaskManager.isTaskRegisteredAsync(taskName)) {\n    throw new Error(`Task '${taskName}' is already registered.`);\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  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  if (!(await TaskManager.isTaskRegisteredAsync(taskName))) {\n    throw new Error(`Task '${taskName}' is not registered.`);\n  }\n\n  _validate(taskName);\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 * @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"]}

package/expo-module.config.json

@@ -9,7 +9,7 @@
     "publication": {
       "groupId": "host.exp.exponent",
       "artifactId": "expo.modules.backgroundtask",
-      "version": "0.2.4",
+      "version": "0.2.6",
       "repository": "local-maven-repo"
     }
   }

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

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

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

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

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

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

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

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

package/local-maven-repo/host/exp/exponent/expo.modules.backgroundtask/{0.2.4/expo.modules.backgroundtask-0.2.4.module → 0.2.6/expo.modules.backgroundtask-0.2.6.module}

@@ -3,7 +3,7 @@
   "component": {
     "group": "host.exp.exponent",
     "module": "expo.modules.backgroundtask",
-    "version": "0.2.4",
+    "version": "0.2.6",
     "attributes": {
       "org.gradle.status": "release"
     }
@@ -24,13 +24,13 @@
       },
       "files": [
         {
-          "name": "expo.modules.backgroundtask-0.2.4.aar",
-          "url": "expo.modules.backgroundtask-0.2.4.aar",
-          "size": 47938,
-          "sha512": "df365cff219528667a5ad1a044439dd3d46be3018c473bff6907568fb2ff5f484fa43b988c9dc4283b0edfc7035f1207f4d715d0483d12b30e37170aa94b6e8a",
-          "sha256": "812c871ecce58021366e8bffc1b201cff6c121bdeeba5b53711f8c11635724fe",
-          "sha1": "4b3529965f7a73a32b4624997c0161d52fbb8e6d",
-          "md5": "f5d314c1b9764e51a897f9ce429090d7"
+          "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"
         }
       ]
     },
@@ -64,13 +64,13 @@
       ],
       "files": [
         {
-          "name": "expo.modules.backgroundtask-0.2.4.aar",
-          "url": "expo.modules.backgroundtask-0.2.4.aar",
-          "size": 47938,
-          "sha512": "df365cff219528667a5ad1a044439dd3d46be3018c473bff6907568fb2ff5f484fa43b988c9dc4283b0edfc7035f1207f4d715d0483d12b30e37170aa94b6e8a",
-          "sha256": "812c871ecce58021366e8bffc1b201cff6c121bdeeba5b53711f8c11635724fe",
-          "sha1": "4b3529965f7a73a32b4624997c0161d52fbb8e6d",
-          "md5": "f5d314c1b9764e51a897f9ce429090d7"
+          "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"
         }
       ]
     },
@@ -84,8 +84,8 @@
       },
       "files": [
         {
-          "name": "expo.modules.backgroundtask-0.2.4-sources.jar",
-          "url": "expo.modules.backgroundtask-0.2.4-sources.jar",
+          "name": "expo.modules.backgroundtask-0.2.6-sources.jar",
+          "url": "expo.modules.backgroundtask-0.2.6-sources.jar",
           "size": 6743,
           "sha512": "558f8112433c958b3ce00edac1b1e08835137759aca7f9344968661df70dccbaffb9a193a2a8f186b193edb6e59d0e94021a69455a5f04f6b5495a155ba7560f",
           "sha256": "4019bc874cc09d9187352e03c4f54941c7abd91e4a3d8b41c2aaf351dd7ba28e",

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

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

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

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

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

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

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

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

package/local-maven-repo/host/exp/exponent/expo.modules.backgroundtask/{0.2.4/expo.modules.backgroundtask-0.2.4.pom → 0.2.6/expo.modules.backgroundtask-0.2.6.pom}

@@ -9,7 +9,7 @@
   <modelVersion>4.0.0</modelVersion>
   <groupId>host.exp.exponent</groupId>
   <artifactId>expo.modules.backgroundtask</artifactId>
-  <version>0.2.4</version>
+  <version>0.2.6</version>
   <packaging>aar</packaging>
   <name>expo.modules.backgroundtask</name>
   <url>https://github.com/expo/expo</url>

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

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

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

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

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

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

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

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

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

@@ -3,11 +3,11 @@
   <groupId>host.exp.exponent</groupId>
   <artifactId>expo.modules.backgroundtask</artifactId>
   <versioning>
-    <latest>0.2.4</latest>
-    <release>0.2.4</release>
+    <latest>0.2.6</latest>
+    <release>0.2.6</release>
     <versions>
-      <version>0.2.4</version>
+      <version>0.2.6</version>
     </versions>
-    <lastUpdated>20250414185046</lastUpdated>
+    <lastUpdated>20250430211459</lastUpdated>
   </versioning>
 </metadata>

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

@@ -1 +1 @@
-c96c48d8de8e08a6ff9146a147d56f98
+d124045fdb9bab038e1583b22f18de1f

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

@@ -1 +1 @@
-394f89b925ce418966f11c26404f9d18ce80336b
+4c460dd9b460b2f0772988a706830108a6aa56a1

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

@@ -1 +1 @@
-4ff1c210ca818ca471a6a1a12bec983d7779aa8a6b21ec607b2ccb163e759488
+1e386862747f3520f4ba51a9bab938dfbdb638d041f1a48c15cf05f4f81ce540

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

@@ -1 +1 @@
-94ab7f51f87f662cdacce518ca43e4eeb52695455ec28dd41db8908df4f0bebb7169c5091735ecad4de336da99d4cbf83f9161905fbc4582350fe497fa733b52
+80e5727a10efbe6c2789d0e67de8b1584bc8ce9211638f76082d9b36f80079e176e44784ca79eb0fe525d19fc50f1d67a4d9ab2ea24841844f687094476475e5

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "expo-background-task",
-  "version": "0.2.4",
+  "version": "0.2.6",
   "description": "Expo Android and iOS module for Background Task APIs",
   "main": "build/BackgroundTask.js",
   "types": "build/BackgroundTask.d.ts",
@@ -32,13 +32,13 @@
   "license": "MIT",
   "homepage": "https://docs.expo.dev/versions/latest/sdk/background-task/",
   "dependencies": {
-    "expo-task-manager": "~13.1.3"
+    "expo-task-manager": "~13.1.5"
   },
   "devDependencies": {
-    "expo-module-scripts": "^4.1.2"
+    "expo-module-scripts": "^4.1.6"
   },
   "peerDependencies": {
     "expo": "*"
   },
-  "gitHead": "cb9fdd93f76f28e2ace4f66080b2386d87239553"
+  "gitHead": "84355076bc31a356aa3d23257f387f221885f53d"
 }

package/src/BackgroundTask.ts

@@ -83,9 +83,7 @@ export async function registerTaskAsync(
       `Task '${taskName}' is not defined. You must define a task using TaskManager.defineTask before registering.`
     );
   }
-  if (await TaskManager.isTaskRegisteredAsync(taskName)) {
-    throw new Error(`Task '${taskName}' is already registered.`);
-  }
+
   if ((await ExpoBackgroundTaskModule.getStatusAsync()) === BackgroundTaskStatus.Restricted) {
     if (!warnAboutRunningOniOSSimulator) {
       const message =
@@ -98,6 +96,9 @@ export async function registerTaskAsync(
     return;
   }
   _validate(taskName);
+  if (await TaskManager.isTaskRegisteredAsync(taskName)) {
+    return;
+  }
   await ExpoBackgroundTaskModule.registerTaskAsync(taskName, options);
 }
 
@@ -111,11 +112,10 @@ export async function unregisterTaskAsync(taskName: string): Promise<void> {
   if (!ExpoBackgroundTaskModule.unregisterTaskAsync) {
     throw new UnavailabilityError('BackgroundTask', 'unregisterTaskAsync');
   }
+  _validate(taskName);
   if (!(await TaskManager.isTaskRegisteredAsync(taskName))) {
-    throw new Error(`Task '${taskName}' is not registered.`);
+    return;
   }
-
-  _validate(taskName);
   await ExpoBackgroundTaskModule.unregisterTaskAsync(taskName);
 }
 

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

@@ -1 +0,0 @@
-f5d314c1b9764e51a897f9ce429090d7

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

@@ -1 +0,0 @@
-4b3529965f7a73a32b4624997c0161d52fbb8e6d

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

@@ -1 +0,0 @@
-812c871ecce58021366e8bffc1b201cff6c121bdeeba5b53711f8c11635724fe

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

@@ -1 +0,0 @@
-df365cff219528667a5ad1a044439dd3d46be3018c473bff6907568fb2ff5f484fa43b988c9dc4283b0edfc7035f1207f4d715d0483d12b30e37170aa94b6e8a

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

@@ -1 +0,0 @@
-f20d358cb717a8720519fa607fd9bace

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

@@ -1 +0,0 @@
-9b4e4541aa148fa4e4190028ff4ed739e1501b2a

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

@@ -1 +0,0 @@
-3336622265f7251719c91c2a89bb22d358b94ce92642c9e4141beab1f832a1d3

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

@@ -1 +0,0 @@
-7a0ba9debc9fe387c9342daebf841530dd3a75967b1ff969a6c7aa92abf63a8f2fd151ffeb1c3531df494386675c1b072b04715502da21d72c541d2ff1e95f1b

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

@@ -1 +0,0 @@
-8573b7ae6e45fb56f7e12c5da1aacb98

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

@@ -1 +0,0 @@
-dddfd08b254a49abf771740e27205849ab37baad

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

@@ -1 +0,0 @@
-f9367c7fa56e5bb1017a2f26b5971baac7d3cccca63a2f64dbcdd9241900bbc8

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

@@ -1 +0,0 @@
-d26f9eea02c07404cdbf4d8fa4cde84c0afb686026ca0c7332f593234d5c54d6746cfb39466426eb6ae338320c2bfbaed9981eb34438d0ce77d33f453fa98df5