expo-background-task 0.2.1 → 0.2.3

package/CHANGELOG.md

@@ -10,6 +10,16 @@
 
 ### 💡 Others
 
+## 0.2.3 — 2025-04-11
+
+### 💡 Others
+
+- Added warning about Background Tasks not being supported in Expo Go ([#36063](https://github.com/expo/expo/pull/36063) by [@chrfalch](https://github.com/chrfalch))
+
+## 0.2.2 — 2025-04-09
+
+_This version does not introduce any user-facing changes._
+
 ## 0.2.1 — 2025-04-08
 
 ### 🐛 Bug fixes

package/android/build.gradle

@@ -4,7 +4,7 @@ plugins {
 }
 
 group = 'host.exp.exponent'
-version = '0.2.1'
+version = '0.2.3'
 
 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.1"
+    versionName "0.2.3"
     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":"AAGA,OAAO,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAOrF;;;;;GAKG;AACH,eAAO,MAAM,cAAc,QAAa,QAAQ,oBAAoB,CAMnE,CAAC;AAGF;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAsB,iBAAiB,CACrC,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,qBAA0B,GAClC,OAAO,CAAC,IAAI,CAAC,CAwBf;AAGD;;;;GAIG;AACH,wBAAsB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAQzE;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,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"}

package/build/BackgroundTask.js

@@ -1,9 +1,24 @@
+import { isRunningInExpoGo } from 'expo';
 import { Platform, UnavailabilityError } from 'expo-modules-core';
 import * as TaskManager from 'expo-task-manager';
 import { BackgroundTaskStatus } from './BackgroundTask.types';
 import ExpoBackgroundTaskModule from './ExpoBackgroundTaskModule';
 // Flag to warn about running on Apple simulator
 let warnAboutRunningOniOSSimulator = false;
+let warnedAboutExpoGo = false;
+function _validate(taskName) {
+    if (isRunningInExpoGo()) {
+        if (!warnedAboutExpoGo) {
+            const message = '`Background Task` functionality is not available in Expo Go:\n' +
+                'Please use a development build to avoid limitations. Learn more: https://expo.fyi/dev-client.';
+            console.warn(message);
+            warnedAboutExpoGo = true;
+        }
+    }
+    if (!taskName || typeof taskName !== 'string') {
+        throw new TypeError('`taskName` must be a non-empty string.');
+    }
+}
 // @needsAudit
 /**
  * Returns the status for the Background Task API. On web, it always returns `BackgroundTaskStatus.Restricted`,
@@ -15,7 +30,9 @@ export const getStatusAsync = async () => {
     if (!ExpoBackgroundTaskModule.getStatusAsync) {
         throw new UnavailabilityError('BackgroundTask', 'getStatusAsync');
     }
-    return ExpoBackgroundTaskModule.getStatusAsync();
+    return isRunningInExpoGo()
+        ? BackgroundTaskStatus.Restricted
+        : ExpoBackgroundTaskModule.getStatusAsync();
 };
 // @needsAudit
 /**
@@ -66,6 +83,7 @@ export async function registerTaskAsync(taskName, options = {}) {
         }
         return;
     }
+    _validate(taskName);
     await ExpoBackgroundTaskModule.registerTaskAsync(taskName, options);
 }
 // @needsAudit
@@ -81,6 +99,7 @@ export async function unregisterTaskAsync(taskName) {
     if (!(await TaskManager.isTaskRegisteredAsync(taskName))) {
         throw new Error(`Task '${taskName}' is not registered.`);
     }
+    _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":"AAAA,OAAO,EAAE,QAAQ,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAClE,OAAO,KAAK,WAAW,MAAM,mBAAmB,CAAC;AAEjD,OAAO,EAAyB,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AACrF,OAAO,wBAAwB,MAAM,4BAA4B,CAAC;AAElE,gDAAgD;AAChD,IAAI,8BAA8B,GAAG,KAAK,CAAC;AAE3C,cAAc;AACd;;;;;GAKG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,KAAK,IAAmC,EAAE;IACtE,IAAI,CAAC,wBAAwB,CAAC,cAAc,EAAE;QAC5C,MAAM,IAAI,mBAAmB,CAAC,gBAAgB,EAAE,gBAAgB,CAAC,CAAC;KACnE;IAED,OAAO,wBAAwB,CAAC,cAAc,EAAE,CAAC;AACnD,CAAC,CAAC;AAEF,cAAc;AACd;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,QAAgB,EAChB,UAAiC,EAAE;IAEnC,IAAI,CAAC,wBAAwB,CAAC,iBAAiB,EAAE;QAC/C,MAAM,IAAI,mBAAmB,CAAC,gBAAgB,EAAE,mBAAmB,CAAC,CAAC;KACtE;IACD,IAAI,CAAC,WAAW,CAAC,aAAa,CAAC,QAAQ,CAAC,EAAE;QACxC,MAAM,IAAI,KAAK,CACb,SAAS,QAAQ,2FAA2F,CAC7G,CAAC;KACH;IACD,IAAI,MAAM,WAAW,CAAC,qBAAqB,CAAC,QAAQ,CAAC,EAAE;QACrD,MAAM,IAAI,KAAK,CAAC,SAAS,QAAQ,0BAA0B,CAAC,CAAC;KAC9D;IACD,IAAI,CAAC,MAAM,wBAAwB,CAAC,cAAc,EAAE,CAAC,KAAK,oBAAoB,CAAC,UAAU,EAAE;QACzF,IAAI,CAAC,8BAA8B,EAAE;YACnC,MAAM,OAAO,GACX,QAAQ,CAAC,EAAE,KAAK,KAAK;gBACnB,CAAC,CAAC,mFAAmF,QAAQ,GAAG;gBAChG,CAAC,CAAC,4FAA4F,QAAQ,GAAG,CAAC;YAC9G,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACtB,8BAA8B,GAAG,IAAI,CAAC;SACvC;QACD,OAAO;KACR;IACD,MAAM,wBAAwB,CAAC,iBAAiB,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;AACtE,CAAC;AAED,cAAc;AACd;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,QAAgB;IACxD,IAAI,CAAC,wBAAwB,CAAC,mBAAmB,EAAE;QACjD,MAAM,IAAI,mBAAmB,CAAC,gBAAgB,EAAE,qBAAqB,CAAC,CAAC;KACxE;IACD,IAAI,CAAC,CAAC,MAAM,WAAW,CAAC,qBAAqB,CAAC,QAAQ,CAAC,CAAC,EAAE;QACxD,MAAM,IAAI,KAAK,CAAC,SAAS,QAAQ,sBAAsB,CAAC,CAAC;KAC1D;IACD,MAAM,wBAAwB,CAAC,mBAAmB,CAAC,QAAQ,CAAC,CAAC;AAC/D,CAAC;AAED,cAAc;AACd;;;;;GAKG;AACH,+EAA+E;AAC/E,mBAAmB;AACnB,wEAAwE;AACxE,6FAA6F;AAC7F,QAAQ;AACR,+DAA+D;AAC/D,gFAAgF;AAChF,aAAa;AACb,qCAAqC;AACrC,MAAM;AACN,IAAI;AAEJ,eAAe;AACf,OAAO,EACL,oBAAoB,EACpB,oBAAoB,GAErB,MAAM,wBAAwB,CAAC","sourcesContent":["import { 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\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 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  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  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  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"]}

package/build/ExpoBackgroundTaskModule.web.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ExpoBackgroundTaskModule.web.d.ts","sourceRoot":"","sources":["../src/ExpoBackgroundTaskModule.web.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;;sBAGpC,QAAQ,oBAAoB,CAAC;;AADvD,wBAIE"}
+{"version":3,"file":"ExpoBackgroundTaskModule.web.d.ts","sourceRoot":"","sources":["../src/ExpoBackgroundTaskModule.web.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;;sBAGpC,OAAO,CAAC,oBAAoB,CAAC;;AADvD,wBAIE"}

package/expo-module.config.json

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

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

@@ -3,7 +3,7 @@
   "component": {
     "group": "host.exp.exponent",
     "module": "expo.modules.backgroundtask",
-    "version": "0.2.1",
+    "version": "0.2.3",
     "attributes": {
       "org.gradle.status": "release"
     }
@@ -24,8 +24,8 @@
       },
       "files": [
         {
-          "name": "expo.modules.backgroundtask-0.2.1.aar",
-          "url": "expo.modules.backgroundtask-0.2.1.aar",
+          "name": "expo.modules.backgroundtask-0.2.3.aar",
+          "url": "expo.modules.backgroundtask-0.2.3.aar",
           "size": 47938,
           "sha512": "df365cff219528667a5ad1a044439dd3d46be3018c473bff6907568fb2ff5f484fa43b988c9dc4283b0edfc7035f1207f4d715d0483d12b30e37170aa94b6e8a",
           "sha256": "812c871ecce58021366e8bffc1b201cff6c121bdeeba5b53711f8c11635724fe",
@@ -64,8 +64,8 @@
       ],
       "files": [
         {
-          "name": "expo.modules.backgroundtask-0.2.1.aar",
-          "url": "expo.modules.backgroundtask-0.2.1.aar",
+          "name": "expo.modules.backgroundtask-0.2.3.aar",
+          "url": "expo.modules.backgroundtask-0.2.3.aar",
           "size": 47938,
           "sha512": "df365cff219528667a5ad1a044439dd3d46be3018c473bff6907568fb2ff5f484fa43b988c9dc4283b0edfc7035f1207f4d715d0483d12b30e37170aa94b6e8a",
           "sha256": "812c871ecce58021366e8bffc1b201cff6c121bdeeba5b53711f8c11635724fe",
@@ -84,8 +84,8 @@
       },
       "files": [
         {
-          "name": "expo.modules.backgroundtask-0.2.1-sources.jar",
-          "url": "expo.modules.backgroundtask-0.2.1-sources.jar",
+          "name": "expo.modules.backgroundtask-0.2.3-sources.jar",
+          "url": "expo.modules.backgroundtask-0.2.3-sources.jar",
           "size": 6743,
           "sha512": "558f8112433c958b3ce00edac1b1e08835137759aca7f9344968661df70dccbaffb9a193a2a8f186b193edb6e59d0e94021a69455a5f04f6b5495a155ba7560f",
           "sha256": "4019bc874cc09d9187352e03c4f54941c7abd91e4a3d8b41c2aaf351dd7ba28e",

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

@@ -0,0 +1 @@
+28107c44985e18f680fe62cc1d8b32f5

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

@@ -0,0 +1 @@
+c923e068d5637bc96ab20cbae9d397502fd9afd9

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

@@ -0,0 +1 @@
+37cf664232d2b5f79bd42bb6934d7cf8d26cd2a0d4cc1d1b6fc71c2925f483c1

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

@@ -0,0 +1 @@
+75c7d8731b6f37248c0e7c77ca35fbfc238a8e7262c4a429bab732bb5b0663d0412eaf8185ff4d8d31acded3d298641c7f49f4bacacc48d0c5bc7df3cd650c3f

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

@@ -9,7 +9,7 @@
   <modelVersion>4.0.0</modelVersion>
   <groupId>host.exp.exponent</groupId>
   <artifactId>expo.modules.backgroundtask</artifactId>
-  <version>0.2.1</version>
+  <version>0.2.3</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.3/expo.modules.backgroundtask-0.2.3.pom.md5

@@ -0,0 +1 @@
+1fdc684a91bad68fd1919b5573bf4735

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

@@ -0,0 +1 @@
+8380b1da22c47f7fbdbb2982d7f5096de5a5e05d

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

@@ -0,0 +1 @@
+4ba9bdc3d1a78d103bda8d7a28dcf1492f7d279e323a6255d73d0a0e38726b02

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

@@ -0,0 +1 @@
+0a2f48582849c4eaa4b0690f0cb00ac96df1dfd5775403bf17a61a8dd18624697b0169db47ec1ab63c183d26ec4ed14c2ca3bf98e0bdfc2706646eb0d24192be

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.1</latest>
-    <release>0.2.1</release>
+    <latest>0.2.3</latest>
+    <release>0.2.3</release>
     <versions>
-      <version>0.2.1</version>
+      <version>0.2.3</version>
     </versions>
-    <lastUpdated>20250408212901</lastUpdated>
+    <lastUpdated>20250411043200</lastUpdated>
   </versioning>
 </metadata>

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

@@ -1 +1 @@
-0615517e5eb408519211f4e158b4c753
+3197afbb5116a75292619128ba4927b0

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

@@ -1 +1 @@
-455a0b63e3a0bca5b704faf6bad7d7af067e6a06
+e4a8af23b63c9ad31e8e1f3149348dcf78c97d88

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

@@ -1 +1 @@
-089ecfd44d81580eceeaa66504cec3285882d73e2b690d37d1040d84508d5032
+b85d7dbad6c4d61e45947510ade78cac16a0294e6443e0f7ec55dcd48ee59194

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

@@ -1 +1 @@
-3bfddac092cfc9b8fb4d11283595bac4aabe063a888c8b97279dc2a44d6b6711b00d584c809928acab6410383ced229cb74c498a4343572c033252b7f1713f59
+01e76bfe49114b9593679028628b99e1991fc5e82d7d417365c472b6bfa768d64977233b3eb53141271d6312557cabab730adde321bace0f010fc8d92a3021f8

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "expo-background-task",
-  "version": "0.2.1",
+  "version": "0.2.3",
   "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.0"
+    "expo-task-manager": "~13.1.2"
   },
   "devDependencies": {
-    "expo-module-scripts": "^4.1.0"
+    "expo-module-scripts": "^4.1.1"
   },
   "peerDependencies": {
     "expo": "*"
   },
-  "gitHead": "2487c7aa9b5ef6a7052e82bbf9a53604c2ed273f"
+  "gitHead": "c81263062bf24ad09e51e019f1d7dc29fa651c55"
 }

package/src/BackgroundTask.ts

@@ -1,3 +1,4 @@
+import { isRunningInExpoGo } from 'expo';
 import { Platform, UnavailabilityError } from 'expo-modules-core';
 import * as TaskManager from 'expo-task-manager';
 
@@ -7,6 +8,23 @@ import ExpoBackgroundTaskModule from './ExpoBackgroundTaskModule';
 // Flag to warn about running on Apple simulator
 let warnAboutRunningOniOSSimulator = false;
 
+let warnedAboutExpoGo = false;
+
+function _validate(taskName: unknown) {
+  if (isRunningInExpoGo()) {
+    if (!warnedAboutExpoGo) {
+      const message =
+        '`Background Task` functionality is not available in Expo Go:\n' +
+        'Please use a development build to avoid limitations. Learn more: https://expo.fyi/dev-client.';
+      console.warn(message);
+      warnedAboutExpoGo = true;
+    }
+  }
+  if (!taskName || typeof taskName !== 'string') {
+    throw new TypeError('`taskName` must be a non-empty string.');
+  }
+}
+
 // @needsAudit
 /**
  * Returns the status for the Background Task API. On web, it always returns `BackgroundTaskStatus.Restricted`,
@@ -19,7 +37,9 @@ export const getStatusAsync = async (): Promise<BackgroundTaskStatus> => {
     throw new UnavailabilityError('BackgroundTask', 'getStatusAsync');
   }
 
-  return ExpoBackgroundTaskModule.getStatusAsync();
+  return isRunningInExpoGo()
+    ? BackgroundTaskStatus.Restricted
+    : ExpoBackgroundTaskModule.getStatusAsync();
 };
 
 // @needsAudit
@@ -77,6 +97,7 @@ export async function registerTaskAsync(
     }
     return;
   }
+  _validate(taskName);
   await ExpoBackgroundTaskModule.registerTaskAsync(taskName, options);
 }
 
@@ -93,6 +114,8 @@ export async function unregisterTaskAsync(taskName: string): Promise<void> {
   if (!(await TaskManager.isTaskRegisteredAsync(taskName))) {
     throw new Error(`Task '${taskName}' is not registered.`);
   }
+
+  _validate(taskName);
   await ExpoBackgroundTaskModule.unregisterTaskAsync(taskName);
 }
 

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

@@ -1 +0,0 @@
-65ad7c9966f594aa22436def82907bd7

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

@@ -1 +0,0 @@
-fdde2f1871ff255486592db942272a9a32119b58

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

@@ -1 +0,0 @@
-9630af27f6d6f99458ea047c9ee6d8fc926f666b766a383db32a8a0970e3a14b

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

@@ -1 +0,0 @@
-a949f20e3b3507ce58629154203a2cccd5f126797772783b971e7dda13ba5485b42bcc203b8a4e3b40b5bfc118d14a966610299af2a3d415b04f867cc92251ef

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

@@ -1 +0,0 @@
-07546022499e0d54a776d412d9d0d5c4

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

@@ -1 +0,0 @@
-faa1cd7eb6411e0347a76c63bff6b63e73c55369

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

@@ -1 +0,0 @@
-79a804b5a324d77b77f9ead754891d8f5c1cd848a57315f01ba072b94e699b87

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

@@ -1 +0,0 @@
-e435e6e67e5d03548ac1b15737308a1242f28cdcbf7773a8fb03948bd2d7d60ba99cf9edcff75b871bfbf4f201714b75e2ca6d417ec08789b3051b3a9a6e8ec0