expo-task-manager 55.0.8 → 55.0.10

package/CHANGELOG.md

@@ -10,6 +10,16 @@
 
 ### 💡 Others
 
+## 55.0.10 — 2026-03-17
+
+### 🐛 Bug fixes
+
+- Fixed JS timers hanging during background task execution on Android by registering with `HeadlessJsTaskContext`. ([#43821](https://github.com/expo/expo/pull/43821) by [@janicduplessis](https://github.com/janicduplessis))
+
+## 55.0.9 — 2026-02-25
+
+_This version does not introduce any user-facing changes._
+
 ## 55.0.8 — 2026-02-20
 
 _This version does not introduce any user-facing changes._

package/android/build.gradle

@@ -4,17 +4,18 @@ plugins {
 }
 
 group = 'host.exp.exponent'
-version = '55.0.8'
+version = '55.0.10'
 
 android {
   namespace "expo.modules.taskmanager"
   defaultConfig {
     versionCode 23
-    versionName "55.0.8"
+    versionName "55.0.10"
   }
 }
 
 dependencies {
   implementation project(':unimodules-app-loader')
   api "androidx.core:core:1.17.0"
+  compileOnly "com.facebook.react:react-android"
 }

package/android/src/main/java/expo/modules/taskManager/TaskService.java

@@ -21,7 +21,16 @@ import java.util.List;
 import java.util.Map;
 import java.util.UUID;
 
+import androidx.annotation.NonNull;
 import androidx.annotation.Nullable;
+import com.facebook.react.ReactApplication;
+import com.facebook.react.ReactHost;
+import com.facebook.react.ReactInstanceEventListener;
+import com.facebook.react.bridge.ReactContext;
+import com.facebook.react.bridge.UiThreadUtil;
+import com.facebook.react.bridge.WritableNativeMap;
+import com.facebook.react.jstasks.HeadlessJsTaskConfig;
+import com.facebook.react.jstasks.HeadlessJsTaskContext;
 import expo.modules.apploader.AppLoaderProvider;
 import expo.modules.apploader.HeadlessAppLoader;
 import expo.modules.core.interfaces.SingletonModule;
@@ -67,6 +76,10 @@ public class TaskService implements SingletonModule, TaskServiceInterface {
   // Map of callbacks for task execution events. Schema: { "<eventId>": TaskExecutionCallback }
   private static final Map<String, TaskExecutionCallback> sTaskCallbacks = new HashMap<>();
 
+  // Tracks headless JS task IDs per appScopeKey, used to keep JS timers alive
+  // during background task execution. See maybeStartHeadlessTask().
+  private static final Map<String, Integer> sHeadlessTaskIds = new HashMap<>();
+
   public TaskService(Context context) {
     super();
     mContextRef = new WeakReference<>(context);
@@ -204,6 +217,7 @@ public class TaskService implements SingletonModule, TaskServiceInterface {
 
       if (appEvents.isEmpty()) {
         sEvents.remove(appScopeKey);
+        maybeFinishHeadlessTask(appScopeKey);
 
         // Invalidate app record but after 2 seconds delay so we can still take batched events.
         Handler handler = new Handler();
@@ -378,16 +392,25 @@ public class TaskService implements SingletonModule, TaskServiceInterface {
       sTaskCallbacks.put(eventId, callback);
     }
 
+    boolean isFirstEvent = sEvents.get(appScopeKey) == null;
     final List<String> appEvents;
-    if (sEvents.get(appScopeKey) == null) {
+    if (isFirstEvent) {
       appEvents = new ArrayList<>();
       appEvents.add(eventId);
       sEvents.put(appScopeKey, appEvents);
     } else {
-      appEvents = new ArrayList<>();
+      appEvents = sEvents.get(appScopeKey);
       appEvents.add(eventId);
     }
 
+    // Register with HeadlessJsTaskContext to keep JS timers alive while
+    // the app is backgrounded. Without this, JavaTimerManager pauses all
+    // timers when the Activity is paused (isPaused=true && isRunningTasks=false),
+    // causing all async JS operations (promises, setTimeout) to hang.
+    if (isFirstEvent) {
+      maybeStartHeadlessTask(appScopeKey);
+    }
+
     if (taskManager != null) {
       taskManager.executeTaskWithBody(body);
       return;
@@ -598,4 +621,100 @@ public class TaskService implements SingletonModule, TaskServiceInterface {
     Handler handler = new Handler();
     handler.postDelayed(() -> jobService.jobFinished(params, false), timeout);
   }
+
+  /**
+   * Registers a headless JS task with React Native's HeadlessJsTaskContext to signal that
+   * background work is in progress. This prevents JavaTimerManager from pausing JS timers
+   * when the Activity is backgrounded (isPaused=true), which would cause all async JS
+   * operations (promises, setTimeout, etc.) to hang indefinitely.
+   *
+   * @see <a href="https://github.com/facebook/react-native/blob/63800af9438ea9ddaec84b6f17793a4f1bffe342/packages/react-native/ReactAndroid/src/main/java/com/facebook/react/modules/core/JavaTimerManager.kt#L291">JavaTimerManager timer guard</a>
+   */
+  private void maybeStartHeadlessTask(String appScopeKey) {
+    try {
+      Context context = mContextRef.get();
+      if (context == null) return;
+
+      ReactContext reactContext = getReactContext(context);
+      if (reactContext != null) {
+        invokeStartHeadlessTask(reactContext, appScopeKey);
+      } else {
+        // App was killed — context not ready yet. Listen for creation and start then.
+        waitForReactContextAndStartTask(context, appScopeKey);
+      }
+    } catch (Exception e) {
+      Log.w(TAG, "Failed to start headless task: " + e.getMessage());
+    }
+  }
+
+  private void invokeStartHeadlessTask(ReactContext reactContext, String appScopeKey) {
+    HeadlessJsTaskContext headlessContext = HeadlessJsTaskContext.getInstance(reactContext);
+    HeadlessJsTaskConfig taskConfig = new HeadlessJsTaskConfig(
+      "expo-task-manager",
+      new WritableNativeMap(),
+      0, // no timeout, managed by the task consumer
+      true // allow in foreground to avoid exceptions if app returns
+    );
+
+    UiThreadUtil.runOnUiThread(() -> {
+      try {
+        int taskId = headlessContext.startTask(taskConfig);
+        sHeadlessTaskIds.put(appScopeKey, taskId);
+        Log.i(TAG, "Started headless task " + taskId + " to keep JS timers alive for '" + appScopeKey + "'");
+      } catch (Exception e) {
+        Log.w(TAG, "Failed to start headless task: " + e.getMessage());
+      }
+    });
+  }
+
+  private void waitForReactContextAndStartTask(Context context, String appScopeKey) {
+    ReactApplication app = (ReactApplication) context.getApplicationContext();
+    ReactHost reactHost = app.getReactHost();
+    if (reactHost == null) return;
+
+    reactHost.addReactInstanceEventListener(new ReactInstanceEventListener() {
+      @Override
+      public void onReactContextInitialized(@NonNull ReactContext reactContext) {
+        invokeStartHeadlessTask(reactContext, appScopeKey);
+        reactHost.removeReactInstanceEventListener(this);
+      }
+    });
+  }
+
+  /**
+   * Finishes the headless JS task for the given appScopeKey, allowing JavaTimerManager
+   * to pause timers again when all background tasks are complete.
+   */
+  private void maybeFinishHeadlessTask(String appScopeKey) {
+    // Run on UI thread to match startTask and ensure sHeadlessTaskIds
+    // is only accessed from the UI thread.
+    UiThreadUtil.runOnUiThread(() -> {
+      Integer taskId = sHeadlessTaskIds.remove(appScopeKey);
+      if (taskId == null) return;
+
+      try {
+        Context context = mContextRef.get();
+        if (context == null) return;
+
+        ReactContext reactContext = getReactContext(context);
+        if (reactContext == null) return;
+
+        HeadlessJsTaskContext headlessContext = HeadlessJsTaskContext.getInstance(reactContext);
+        headlessContext.finishTask(taskId);
+        Log.i(TAG, "Finished headless task " + taskId + " for '" + appScopeKey + "'");
+      } catch (Exception e) {
+        Log.w(TAG, "Failed to finish headless task: " + e.getMessage());
+      }
+    });
+  }
+
+  /**
+   * Gets the current ReactContext via ReactHost.
+   */
+  @Nullable
+  private ReactContext getReactContext(Context context) {
+    ReactApplication app = (ReactApplication) context.getApplicationContext();
+    ReactHost reactHost = app.getReactHost();
+    return reactHost != null ? reactHost.getCurrentReactContext() : null;
+  }
 }

package/build/TaskManager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TaskManager.d.ts","sourceRoot":"","sources":["../src/TaskManager.ts"],"names":[],"mappings":"AAKA;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;CACjB;AAGD;;GAEG;AACH,MAAM,WAAW,mBAAmB,CAAC,CAAC,GAAG,OAAO;IAC9C;;OAEG;IACH,IAAI,EAAE,CAAC,CAAC;IAER;;OAEG;IACH,KAAK,EAAE,gBAAgB,GAAG,IAAI,CAAC;IAE/B;;OAEG;IACH,aAAa,EAAE,gCAAgC,CAAC;CACjD;AAGD;;GAEG;AACH,MAAM,WAAW,gCAAgC;IAC/C;;;OAGG;IACH,QAAQ,CAAC,EAAE,QAAQ,GAAG,YAAY,GAAG,UAAU,CAAC;IAChD;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAChB;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;CAClB;AAGD;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,OAAO,EAAE,GAAG,CAAC;CACd;AAED;;;GAGG;AACH,MAAM,WAAW,cAAe,SAAQ,eAAe;CAAG;AAG1D;;GAEG;AACH,MAAM,MAAM,uBAAuB,CAAC,CAAC,GAAG,GAAG,IAAI,CAAC,IAAI,EAAE,mBAAmB,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,GAAG,CAAC,CAAC;AAc9F;;;;;;;;;GASG;AACH,wBAAgB,UAAU,CAAC,CAAC,GAAG,OAAO,EACpC,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,uBAAuB,CAAC,CAAC,CAAC,QAWzC;AAGD;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAEvD;AAGD;;;;;;GAMG;AACH,wBAAsB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAO9E;AAGD;;;;;;;GAOG;AACH,wBAAsB,mBAAmB,CAAC,WAAW,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAO7F;AAGD;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAsB,uBAAuB,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC,CAM1E;AAGD;;;;;;;GAOG;AACH,wBAAsB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAOzE;AAGD;;;;GAIG;AACH,wBAAsB,uBAAuB,IAAI,OAAO,CAAC,IAAI,CAAC,CAM7D;AAoCD;;;;;;GAMG;AACH,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,OAAO,CAAC,CAEzD"}
+{"version":3,"file":"TaskManager.d.ts","sourceRoot":"","sources":["../src/TaskManager.ts"],"names":[],"mappings":"AAaA;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;CACjB;AAGD;;GAEG;AACH,MAAM,WAAW,mBAAmB,CAAC,CAAC,GAAG,OAAO;IAC9C;;OAEG;IACH,IAAI,EAAE,CAAC,CAAC;IAER;;OAEG;IACH,KAAK,EAAE,gBAAgB,GAAG,IAAI,CAAC;IAE/B;;OAEG;IACH,aAAa,EAAE,gCAAgC,CAAC;CACjD;AAGD;;GAEG;AACH,MAAM,WAAW,gCAAgC;IAC/C;;;OAGG;IACH,QAAQ,CAAC,EAAE,QAAQ,GAAG,YAAY,GAAG,UAAU,CAAC;IAChD;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAChB;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;CAClB;AAGD;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,OAAO,EAAE,GAAG,CAAC;CACd;AAED;;;GAGG;AACH,MAAM,WAAW,cAAe,SAAQ,eAAe;CAAG;AAG1D;;GAEG;AACH,MAAM,MAAM,uBAAuB,CAAC,CAAC,GAAG,GAAG,IAAI,CAAC,IAAI,EAAE,mBAAmB,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,GAAG,CAAC,CAAC;AAc9F;;;;;;;;;GASG;AACH,wBAAgB,UAAU,CAAC,CAAC,GAAG,OAAO,EACpC,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,uBAAuB,CAAC,CAAC,CAAC,QAWzC;AAGD;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAEvD;AAGD;;;;;;GAMG;AACH,wBAAsB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAO9E;AAGD;;;;;;;GAOG;AACH,wBAAsB,mBAAmB,CAAC,WAAW,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAO7F;AAGD;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAsB,uBAAuB,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC,CAM1E;AAGD;;;;;;;GAOG;AACH,wBAAsB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAOzE;AAGD;;;;GAIG;AACH,wBAAsB,uBAAuB,IAAI,OAAO,CAAC,IAAI,CAAC,CAM7D;AAoCD;;;;;;GAMG;AACH,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,OAAO,CAAC,CAEzD"}

package/build/TaskManager.js

@@ -1,5 +1,12 @@
-import { LegacyEventEmitter, UnavailabilityError } from 'expo-modules-core';
+import { LegacyEventEmitter, Platform, UnavailabilityError } from 'expo-modules-core';
+import { AppRegistry } from 'react-native';
 import ExpoTaskManager from './ExpoTaskManager';
+// Register a no-op headless task so that HeadlessJsTaskContext.startTask()
+// doesn't log a warning. On Android, TaskService registers a headless task
+// in native code to keep JS timers alive during background task execution.
+if (Platform.OS === 'android') {
+    AppRegistry.registerHeadlessTask('expo-task-manager', () => async () => { });
+}
 const tasks = new Map();
 function _validate(taskName) {
     if (!taskName || typeof taskName !== 'string') {

package/build/TaskManager.js.map

@@ -1 +1 @@
-{"version":3,"file":"TaskManager.js","sourceRoot":"","sources":["../src/TaskManager.ts"],"names":[],"mappings":"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","sourcesContent":["import { LegacyEventEmitter, UnavailabilityError } from 'expo-modules-core';\n\nimport ExpoTaskManager from './ExpoTaskManager';\n\n// @needsAudit @docsMissing\n/**\n * Error object that can be received through [`TaskManagerTaskBody`](#taskmanagertaskbody) when the\n * task fails.\n */\nexport interface TaskManagerError {\n  code: string | number;\n  message: string;\n}\n\n// @needsAudit\n/**\n * Represents the object that is passed to the task executor.\n */\nexport interface TaskManagerTaskBody<T = unknown> {\n  /**\n   * An object of data passed to the task executor. Its properties depend on the type of the task.\n   */\n  data: T;\n\n  /**\n   * Error object if the task failed or `null` otherwise.\n   */\n  error: TaskManagerError | null;\n\n  /**\n   * Additional details containing unique ID of task event and name of the task.\n   */\n  executionInfo: TaskManagerTaskBodyExecutionInfo;\n}\n\n// @needsAudit\n/**\n * Additional details about execution provided in `TaskManagerTaskBody`.\n */\nexport interface TaskManagerTaskBodyExecutionInfo {\n  /**\n   * State of the application.\n   * @platform ios\n   */\n  appState?: 'active' | 'background' | 'inactive';\n  /**\n   * Unique ID of task event.\n   */\n  eventId: string;\n  /**\n   * Name of the task.\n   */\n  taskName: string;\n}\n\n// @needsAudit\n/**\n * Represents an already registered task.\n */\nexport interface TaskManagerTask {\n  /**\n   * Name that the task is registered with.\n   */\n  taskName: string;\n\n  /**\n   * Type of the task which depends on how the task was registered.\n   */\n  taskType: string;\n\n  /**\n   * Provides `options` that the task was registered with.\n   */\n  options: any;\n}\n\n/**\n * @deprecated Use `TaskManagerTask` instead.\n * @hidden\n */\nexport interface RegisteredTask extends TaskManagerTask {}\n\n// @needsAudit\n/**\n * Type of task executor – a function that handles the task.\n */\nexport type TaskManagerTaskExecutor<T = any> = (body: TaskManagerTaskBody<T>) => Promise<any>;\n\nconst tasks: Map<string, TaskManagerTaskExecutor<any>> = new Map<\n  string,\n  TaskManagerTaskExecutor<any>\n>();\n\nfunction _validate(taskName: unknown) {\n  if (!taskName || typeof taskName !== 'string') {\n    throw new TypeError('`taskName` must be a non-empty string.');\n  }\n}\n\n// @needsAudit\n/**\n * Defines task function. It must be called in the global scope of your JavaScript bundle.\n * In particular, it cannot be called in any of React lifecycle methods like `componentDidMount`.\n * This limitation is due to the fact that when the application is launched in the background,\n * we need to spin up your JavaScript app, run your task and then shut down — no views are mounted\n * in this scenario.\n *\n * @param taskName Name of the task. It must be the same as the name you provided when registering the task.\n * @param taskExecutor A function that will be invoked when the task with given `taskName` is executed.\n */\nexport function defineTask<T = unknown>(\n  taskName: string,\n  taskExecutor: TaskManagerTaskExecutor<T>\n) {\n  if (!taskName || typeof taskName !== 'string') {\n    console.warn(`TaskManager.defineTask: 'taskName' argument must be a non-empty string.`);\n    return;\n  }\n  if (!taskExecutor || typeof taskExecutor !== 'function') {\n    console.warn(`TaskManager.defineTask: 'task' argument must be a function.`);\n    return;\n  }\n  tasks.set(taskName, taskExecutor);\n}\n\n// @needsAudit\n/**\n * Checks whether the task is already defined.\n *\n * @param taskName Name of the task.\n */\nexport function isTaskDefined(taskName: string): boolean {\n  return tasks.has(taskName);\n}\n\n// @needsAudit\n/**\n * Determine whether the task is registered. Registered tasks are stored in a persistent storage and\n * preserved between sessions.\n *\n * @param taskName Name of the task.\n * @returns A promise which resolves to `true` if a task with the given name is registered, otherwise `false`.\n */\nexport async function isTaskRegisteredAsync(taskName: string): Promise<boolean> {\n  if (!ExpoTaskManager.isTaskRegisteredAsync) {\n    throw new UnavailabilityError('TaskManager', 'isTaskRegisteredAsync');\n  }\n\n  _validate(taskName);\n  return ExpoTaskManager.isTaskRegisteredAsync(taskName);\n}\n\n// @needsAudit\n/**\n * Retrieves `options` associated with the task, that were passed to the function registering the task\n * (e.g. `Location.startLocationUpdatesAsync`).\n *\n * @param taskName Name of the task.\n * @return A promise which fulfills with the `options` object that was passed while registering task\n * with given name or `null` if task couldn't be found.\n */\nexport async function getTaskOptionsAsync<TaskOptions>(taskName: string): Promise<TaskOptions> {\n  if (!ExpoTaskManager.getTaskOptionsAsync) {\n    throw new UnavailabilityError('TaskManager', 'getTaskOptionsAsync');\n  }\n\n  _validate(taskName);\n  return ExpoTaskManager.getTaskOptionsAsync(taskName);\n}\n\n// @needsAudit\n/**\n * Provides information about tasks registered in the app.\n *\n * @returns A promise which fulfills with an array of tasks registered in the app.\n * @example\n * ```js\n * [\n *   {\n *     taskName: 'location-updates-task-name',\n *     taskType: 'location',\n *     options: {\n *       accuracy: Location.Accuracy.High,\n *       showsBackgroundLocationIndicator: false,\n *     },\n *   },\n *   {\n *     taskName: 'geofencing-task-name',\n *     taskType: 'geofencing',\n *     options: {\n *       regions: [...],\n *     },\n *   },\n * ]\n * ```\n */\nexport async function getRegisteredTasksAsync(): Promise<TaskManagerTask[]> {\n  if (!ExpoTaskManager.getRegisteredTasksAsync) {\n    throw new UnavailabilityError('TaskManager', 'getRegisteredTasksAsync');\n  }\n\n  return ExpoTaskManager.getRegisteredTasksAsync();\n}\n\n// @needsAudit\n/**\n * Unregisters task from the app, so the app will not be receiving updates for that task anymore.\n * _It is recommended to use methods specialized by modules that registered the task, eg.\n * [`Location.stopLocationUpdatesAsync`](./location/#expolocationstoplocationupdatesasynctaskname)._\n *\n * @param taskName Name of the task to unregister.\n * @return A promise which fulfills as soon as the task is unregistered.\n */\nexport async function unregisterTaskAsync(taskName: string): Promise<void> {\n  if (!ExpoTaskManager.unregisterTaskAsync) {\n    throw new UnavailabilityError('TaskManager', 'unregisterTaskAsync');\n  }\n\n  _validate(taskName);\n  await ExpoTaskManager.unregisterTaskAsync(taskName);\n}\n\n// @needsAudit\n/**\n * Unregisters all tasks registered for the running app. You may want to call this when the user is\n * signing out and you no longer need to track his location or run any other background tasks.\n * @return A promise which fulfills as soon as all tasks are completely unregistered.\n */\nexport async function unregisterAllTasksAsync(): Promise<void> {\n  if (!ExpoTaskManager.unregisterAllTasksAsync) {\n    throw new UnavailabilityError('TaskManager', 'unregisterAllTasksAsync');\n  }\n\n  await ExpoTaskManager.unregisterAllTasksAsync();\n}\n\nif (ExpoTaskManager) {\n  const eventEmitter = new LegacyEventEmitter(ExpoTaskManager);\n  eventEmitter.addListener<TaskManagerTaskBody>(\n    ExpoTaskManager.EVENT_NAME,\n    async ({ data, error, executionInfo }) => {\n      const { eventId, taskName } = executionInfo;\n      const taskExecutor = tasks.get(taskName);\n      let result: any = null;\n\n      if (taskExecutor) {\n        try {\n          // Execute JS task\n          result = await taskExecutor({ data, error, executionInfo });\n        } catch (error) {\n          console.error(`TaskManager: Task \"${taskName}\" failed:`, error);\n        } finally {\n          // Notify manager the task is finished.\n          await ExpoTaskManager.notifyTaskFinishedAsync(taskName, { eventId, result });\n        }\n      } else {\n        console.warn(\n          `TaskManager: Execution of \"${taskName}\" was requested but looks like it is not defined. Available tasks: [${[...tasks.keys()].join(', ')}]. Make sure that \"TaskManager.defineTask\" is called during initialization phase.`\n        );\n        // No tasks defined -> we need to notify about finish anyway.\n        await ExpoTaskManager.notifyTaskFinishedAsync(taskName, { eventId, result });\n        // We should also unregister such tasks automatically as the task might have been removed\n        // from the app or just renamed - in that case it needs to be registered again (with the new name).\n        await ExpoTaskManager.unregisterTaskAsync(taskName);\n      }\n    }\n  );\n}\n\n// @needsAudit\n/**\n * Determine if the `TaskManager` API can be used in this app.\n * @return A promise which fulfills with `true` if the API can be used, and `false` otherwise.\n * With Expo Go, `TaskManager` is not available on Android, and does not support background execution on iOS.\n * Use a development build to avoid limitations: https://expo.fyi/dev-client.\n * On the web, it always returns `false`.\n */\nexport async function isAvailableAsync(): Promise<boolean> {\n  return ExpoTaskManager.isAvailableAsync();\n}\n"]}
+{"version":3,"file":"TaskManager.js","sourceRoot":"","sources":["../src/TaskManager.ts"],"names":[],"mappings":"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","sourcesContent":["import { LegacyEventEmitter, Platform, UnavailabilityError } from 'expo-modules-core';\nimport { AppRegistry } from 'react-native';\n\nimport ExpoTaskManager from './ExpoTaskManager';\n\n// Register a no-op headless task so that HeadlessJsTaskContext.startTask()\n// doesn't log a warning. On Android, TaskService registers a headless task\n// in native code to keep JS timers alive during background task execution.\nif (Platform.OS === 'android') {\n  AppRegistry.registerHeadlessTask('expo-task-manager', () => async () => {});\n}\n\n// @needsAudit @docsMissing\n/**\n * Error object that can be received through [`TaskManagerTaskBody`](#taskmanagertaskbody) when the\n * task fails.\n */\nexport interface TaskManagerError {\n  code: string | number;\n  message: string;\n}\n\n// @needsAudit\n/**\n * Represents the object that is passed to the task executor.\n */\nexport interface TaskManagerTaskBody<T = unknown> {\n  /**\n   * An object of data passed to the task executor. Its properties depend on the type of the task.\n   */\n  data: T;\n\n  /**\n   * Error object if the task failed or `null` otherwise.\n   */\n  error: TaskManagerError | null;\n\n  /**\n   * Additional details containing unique ID of task event and name of the task.\n   */\n  executionInfo: TaskManagerTaskBodyExecutionInfo;\n}\n\n// @needsAudit\n/**\n * Additional details about execution provided in `TaskManagerTaskBody`.\n */\nexport interface TaskManagerTaskBodyExecutionInfo {\n  /**\n   * State of the application.\n   * @platform ios\n   */\n  appState?: 'active' | 'background' | 'inactive';\n  /**\n   * Unique ID of task event.\n   */\n  eventId: string;\n  /**\n   * Name of the task.\n   */\n  taskName: string;\n}\n\n// @needsAudit\n/**\n * Represents an already registered task.\n */\nexport interface TaskManagerTask {\n  /**\n   * Name that the task is registered with.\n   */\n  taskName: string;\n\n  /**\n   * Type of the task which depends on how the task was registered.\n   */\n  taskType: string;\n\n  /**\n   * Provides `options` that the task was registered with.\n   */\n  options: any;\n}\n\n/**\n * @deprecated Use `TaskManagerTask` instead.\n * @hidden\n */\nexport interface RegisteredTask extends TaskManagerTask {}\n\n// @needsAudit\n/**\n * Type of task executor – a function that handles the task.\n */\nexport type TaskManagerTaskExecutor<T = any> = (body: TaskManagerTaskBody<T>) => Promise<any>;\n\nconst tasks: Map<string, TaskManagerTaskExecutor<any>> = new Map<\n  string,\n  TaskManagerTaskExecutor<any>\n>();\n\nfunction _validate(taskName: unknown) {\n  if (!taskName || typeof taskName !== 'string') {\n    throw new TypeError('`taskName` must be a non-empty string.');\n  }\n}\n\n// @needsAudit\n/**\n * Defines task function. It must be called in the global scope of your JavaScript bundle.\n * In particular, it cannot be called in any of React lifecycle methods like `componentDidMount`.\n * This limitation is due to the fact that when the application is launched in the background,\n * we need to spin up your JavaScript app, run your task and then shut down — no views are mounted\n * in this scenario.\n *\n * @param taskName Name of the task. It must be the same as the name you provided when registering the task.\n * @param taskExecutor A function that will be invoked when the task with given `taskName` is executed.\n */\nexport function defineTask<T = unknown>(\n  taskName: string,\n  taskExecutor: TaskManagerTaskExecutor<T>\n) {\n  if (!taskName || typeof taskName !== 'string') {\n    console.warn(`TaskManager.defineTask: 'taskName' argument must be a non-empty string.`);\n    return;\n  }\n  if (!taskExecutor || typeof taskExecutor !== 'function') {\n    console.warn(`TaskManager.defineTask: 'task' argument must be a function.`);\n    return;\n  }\n  tasks.set(taskName, taskExecutor);\n}\n\n// @needsAudit\n/**\n * Checks whether the task is already defined.\n *\n * @param taskName Name of the task.\n */\nexport function isTaskDefined(taskName: string): boolean {\n  return tasks.has(taskName);\n}\n\n// @needsAudit\n/**\n * Determine whether the task is registered. Registered tasks are stored in a persistent storage and\n * preserved between sessions.\n *\n * @param taskName Name of the task.\n * @returns A promise which resolves to `true` if a task with the given name is registered, otherwise `false`.\n */\nexport async function isTaskRegisteredAsync(taskName: string): Promise<boolean> {\n  if (!ExpoTaskManager.isTaskRegisteredAsync) {\n    throw new UnavailabilityError('TaskManager', 'isTaskRegisteredAsync');\n  }\n\n  _validate(taskName);\n  return ExpoTaskManager.isTaskRegisteredAsync(taskName);\n}\n\n// @needsAudit\n/**\n * Retrieves `options` associated with the task, that were passed to the function registering the task\n * (e.g. `Location.startLocationUpdatesAsync`).\n *\n * @param taskName Name of the task.\n * @return A promise which fulfills with the `options` object that was passed while registering task\n * with given name or `null` if task couldn't be found.\n */\nexport async function getTaskOptionsAsync<TaskOptions>(taskName: string): Promise<TaskOptions> {\n  if (!ExpoTaskManager.getTaskOptionsAsync) {\n    throw new UnavailabilityError('TaskManager', 'getTaskOptionsAsync');\n  }\n\n  _validate(taskName);\n  return ExpoTaskManager.getTaskOptionsAsync(taskName);\n}\n\n// @needsAudit\n/**\n * Provides information about tasks registered in the app.\n *\n * @returns A promise which fulfills with an array of tasks registered in the app.\n * @example\n * ```js\n * [\n *   {\n *     taskName: 'location-updates-task-name',\n *     taskType: 'location',\n *     options: {\n *       accuracy: Location.Accuracy.High,\n *       showsBackgroundLocationIndicator: false,\n *     },\n *   },\n *   {\n *     taskName: 'geofencing-task-name',\n *     taskType: 'geofencing',\n *     options: {\n *       regions: [...],\n *     },\n *   },\n * ]\n * ```\n */\nexport async function getRegisteredTasksAsync(): Promise<TaskManagerTask[]> {\n  if (!ExpoTaskManager.getRegisteredTasksAsync) {\n    throw new UnavailabilityError('TaskManager', 'getRegisteredTasksAsync');\n  }\n\n  return ExpoTaskManager.getRegisteredTasksAsync();\n}\n\n// @needsAudit\n/**\n * Unregisters task from the app, so the app will not be receiving updates for that task anymore.\n * _It is recommended to use methods specialized by modules that registered the task, eg.\n * [`Location.stopLocationUpdatesAsync`](./location/#expolocationstoplocationupdatesasynctaskname)._\n *\n * @param taskName Name of the task to unregister.\n * @return A promise which fulfills as soon as the task is unregistered.\n */\nexport async function unregisterTaskAsync(taskName: string): Promise<void> {\n  if (!ExpoTaskManager.unregisterTaskAsync) {\n    throw new UnavailabilityError('TaskManager', 'unregisterTaskAsync');\n  }\n\n  _validate(taskName);\n  await ExpoTaskManager.unregisterTaskAsync(taskName);\n}\n\n// @needsAudit\n/**\n * Unregisters all tasks registered for the running app. You may want to call this when the user is\n * signing out and you no longer need to track his location or run any other background tasks.\n * @return A promise which fulfills as soon as all tasks are completely unregistered.\n */\nexport async function unregisterAllTasksAsync(): Promise<void> {\n  if (!ExpoTaskManager.unregisterAllTasksAsync) {\n    throw new UnavailabilityError('TaskManager', 'unregisterAllTasksAsync');\n  }\n\n  await ExpoTaskManager.unregisterAllTasksAsync();\n}\n\nif (ExpoTaskManager) {\n  const eventEmitter = new LegacyEventEmitter(ExpoTaskManager);\n  eventEmitter.addListener<TaskManagerTaskBody>(\n    ExpoTaskManager.EVENT_NAME,\n    async ({ data, error, executionInfo }) => {\n      const { eventId, taskName } = executionInfo;\n      const taskExecutor = tasks.get(taskName);\n      let result: any = null;\n\n      if (taskExecutor) {\n        try {\n          // Execute JS task\n          result = await taskExecutor({ data, error, executionInfo });\n        } catch (error) {\n          console.error(`TaskManager: Task \"${taskName}\" failed:`, error);\n        } finally {\n          // Notify manager the task is finished.\n          await ExpoTaskManager.notifyTaskFinishedAsync(taskName, { eventId, result });\n        }\n      } else {\n        console.warn(\n          `TaskManager: Execution of \"${taskName}\" was requested but looks like it is not defined. Available tasks: [${[...tasks.keys()].join(', ')}]. Make sure that \"TaskManager.defineTask\" is called during initialization phase.`\n        );\n        // No tasks defined -> we need to notify about finish anyway.\n        await ExpoTaskManager.notifyTaskFinishedAsync(taskName, { eventId, result });\n        // We should also unregister such tasks automatically as the task might have been removed\n        // from the app or just renamed - in that case it needs to be registered again (with the new name).\n        await ExpoTaskManager.unregisterTaskAsync(taskName);\n      }\n    }\n  );\n}\n\n// @needsAudit\n/**\n * Determine if the `TaskManager` API can be used in this app.\n * @return A promise which fulfills with `true` if the API can be used, and `false` otherwise.\n * With Expo Go, `TaskManager` is not available on Android, and does not support background execution on iOS.\n * Use a development build to avoid limitations: https://expo.fyi/dev-client.\n * On the web, it always returns `false`.\n */\nexport async function isAvailableAsync(): Promise<boolean> {\n  return ExpoTaskManager.isAvailableAsync();\n}\n"]}

package/expo-module.config.json

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

package/local-maven-repo/host/exp/exponent/expo.modules.taskmanager/55.0.10/expo.modules.taskmanager-55.0.10-sources.jar.md5

@@ -0,0 +1 @@
+342e4cf635e65d5098667d442ef9669c

package/local-maven-repo/host/exp/exponent/expo.modules.taskmanager/55.0.10/expo.modules.taskmanager-55.0.10-sources.jar.sha1

@@ -0,0 +1 @@
+c94c865c679390da383bfdaa0a2e99d3d2d58e19

package/local-maven-repo/host/exp/exponent/expo.modules.taskmanager/55.0.10/expo.modules.taskmanager-55.0.10-sources.jar.sha256

@@ -0,0 +1 @@
+ff54d12878b8c372e3a44b7de50a4ffda59a6b95e0a6b5892ab4ebd117279b8d

package/local-maven-repo/host/exp/exponent/expo.modules.taskmanager/55.0.10/expo.modules.taskmanager-55.0.10-sources.jar.sha512

@@ -0,0 +1 @@
+981f984ba5e43c5bf3b0762f68772154da6ac53255876854ee11172dc6a6e61ff088168985432f8afd7b52cbb51f3829311ce437c93750438c8b05169dbcdbba

package/local-maven-repo/host/exp/exponent/expo.modules.taskmanager/55.0.10/expo.modules.taskmanager-55.0.10.aar.md5

@@ -0,0 +1 @@
+758a53c78e427f104485da9c2acc336c

package/local-maven-repo/host/exp/exponent/expo.modules.taskmanager/55.0.10/expo.modules.taskmanager-55.0.10.aar.sha1

@@ -0,0 +1 @@
+2c202a226c8de0f2f8c2ba9c1e66b16c3637ca74

package/local-maven-repo/host/exp/exponent/expo.modules.taskmanager/55.0.10/expo.modules.taskmanager-55.0.10.aar.sha256

@@ -0,0 +1 @@
+be28fd8efcf562566557851a25ca74f812633678b67428ce4228a7b5b8a4f0ea

package/local-maven-repo/host/exp/exponent/expo.modules.taskmanager/55.0.10/expo.modules.taskmanager-55.0.10.aar.sha512

@@ -0,0 +1 @@
+4f33007a612a32cb636d0b6b857b5697e8a9b9773414b0751631cefb1cd04e6b5238c904e346dbcf7fe51080fcfbe4d0953fa9bbda05c93f94d5dbf589ca798f

package/local-maven-repo/host/exp/exponent/expo.modules.taskmanager/{55.0.8/expo.modules.taskmanager-55.0.8.module → 55.0.10/expo.modules.taskmanager-55.0.10.module}

@@ -3,7 +3,7 @@
   "component": {
     "group": "host.exp.exponent",
     "module": "expo.modules.taskmanager",
-    "version": "55.0.8",
+    "version": "55.0.10",
     "attributes": {
       "org.gradle.status": "release"
     }
@@ -33,13 +33,13 @@
       ],
       "files": [
         {
-          "name": "expo.modules.taskmanager-55.0.8.aar",
-          "url": "expo.modules.taskmanager-55.0.8.aar",
-          "size": 63242,
-          "sha512": "cd82576f43c8b2300966dff0c640590cc4c00933cd6ede6d682a2d46b13a47a12798d8e547e3693be3211651f5c3879b14754be054e683a54e59a1e44bc930a9",
-          "sha256": "a1243705ad1e8528fb334a20d31756ff78f1a7ab0ee15406890004f92f653993",
-          "sha1": "86d96fac2316eea17764907e879ba885d2adeb18",
-          "md5": "fc74e9e574a5be051bdbafe46d563e08"
+          "name": "expo.modules.taskmanager-55.0.10.aar",
+          "url": "expo.modules.taskmanager-55.0.10.aar",
+          "size": 65649,
+          "sha512": "4f33007a612a32cb636d0b6b857b5697e8a9b9773414b0751631cefb1cd04e6b5238c904e346dbcf7fe51080fcfbe4d0953fa9bbda05c93f94d5dbf589ca798f",
+          "sha256": "be28fd8efcf562566557851a25ca74f812633678b67428ce4228a7b5b8a4f0ea",
+          "sha1": "2c202a226c8de0f2f8c2ba9c1e66b16c3637ca74",
+          "md5": "758a53c78e427f104485da9c2acc336c"
         }
       ]
     },
@@ -76,13 +76,13 @@
       ],
       "files": [
         {
-          "name": "expo.modules.taskmanager-55.0.8.aar",
-          "url": "expo.modules.taskmanager-55.0.8.aar",
-          "size": 63242,
-          "sha512": "cd82576f43c8b2300966dff0c640590cc4c00933cd6ede6d682a2d46b13a47a12798d8e547e3693be3211651f5c3879b14754be054e683a54e59a1e44bc930a9",
-          "sha256": "a1243705ad1e8528fb334a20d31756ff78f1a7ab0ee15406890004f92f653993",
-          "sha1": "86d96fac2316eea17764907e879ba885d2adeb18",
-          "md5": "fc74e9e574a5be051bdbafe46d563e08"
+          "name": "expo.modules.taskmanager-55.0.10.aar",
+          "url": "expo.modules.taskmanager-55.0.10.aar",
+          "size": 65649,
+          "sha512": "4f33007a612a32cb636d0b6b857b5697e8a9b9773414b0751631cefb1cd04e6b5238c904e346dbcf7fe51080fcfbe4d0953fa9bbda05c93f94d5dbf589ca798f",
+          "sha256": "be28fd8efcf562566557851a25ca74f812633678b67428ce4228a7b5b8a4f0ea",
+          "sha1": "2c202a226c8de0f2f8c2ba9c1e66b16c3637ca74",
+          "md5": "758a53c78e427f104485da9c2acc336c"
         }
       ]
     },
@@ -96,13 +96,13 @@
       },
       "files": [
         {
-          "name": "expo.modules.taskmanager-55.0.8-sources.jar",
-          "url": "expo.modules.taskmanager-55.0.8-sources.jar",
-          "size": 22873,
-          "sha512": "755c124c19182bd5f33e1ef1f9061190b731e8e3137f094edfaee8ed0a880fccab5f1011e1a5c48205c86df424e9776bb9e59020e062dea6c8db1a8bca4af50d",
-          "sha256": "1a13d4a1c5042d7b5296e9db9937989f7f1fe3d3620bdfffffd2e243292fbcf5",
-          "sha1": "200a9dbd20ac61a820c7e2f25a0b3d88add38684",
-          "md5": "a495364d98cfab4cfdd72dcc40ded29f"
+          "name": "expo.modules.taskmanager-55.0.10-sources.jar",
+          "url": "expo.modules.taskmanager-55.0.10-sources.jar",
+          "size": 24108,
+          "sha512": "981f984ba5e43c5bf3b0762f68772154da6ac53255876854ee11172dc6a6e61ff088168985432f8afd7b52cbb51f3829311ce437c93750438c8b05169dbcdbba",
+          "sha256": "ff54d12878b8c372e3a44b7de50a4ffda59a6b95e0a6b5892ab4ebd117279b8d",
+          "sha1": "c94c865c679390da383bfdaa0a2e99d3d2d58e19",
+          "md5": "342e4cf635e65d5098667d442ef9669c"
         }
       ]
     }

package/local-maven-repo/host/exp/exponent/expo.modules.taskmanager/55.0.10/expo.modules.taskmanager-55.0.10.module.md5

@@ -0,0 +1 @@
+162b31de9260a00db3766425606e84cb

package/local-maven-repo/host/exp/exponent/expo.modules.taskmanager/55.0.10/expo.modules.taskmanager-55.0.10.module.sha1

@@ -0,0 +1 @@
+6594204bdd8a17714140ee7b7da9faeb2cf035c4

package/local-maven-repo/host/exp/exponent/expo.modules.taskmanager/55.0.10/expo.modules.taskmanager-55.0.10.module.sha256

@@ -0,0 +1 @@
+1edca8c346947444ab689a475dd96388e746a8d4b469776ea2903df818d4e628

package/local-maven-repo/host/exp/exponent/expo.modules.taskmanager/55.0.10/expo.modules.taskmanager-55.0.10.module.sha512

@@ -0,0 +1 @@
+376a617210aff84ea40ef5db9faf8a59bf4a6db80d5ff1d4fc733b1cfc9b5065746a03f7082bc3a370a3500834a5ed26ae4d3c98438b2875b5b6b1ce18ff7a4c

package/local-maven-repo/host/exp/exponent/expo.modules.taskmanager/{55.0.8/expo.modules.taskmanager-55.0.8.pom → 55.0.10/expo.modules.taskmanager-55.0.10.pom}

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

package/local-maven-repo/host/exp/exponent/expo.modules.taskmanager/55.0.10/expo.modules.taskmanager-55.0.10.pom.md5

@@ -0,0 +1 @@
+5899fdfda1e6cc660eb475cf584f135a

package/local-maven-repo/host/exp/exponent/expo.modules.taskmanager/55.0.10/expo.modules.taskmanager-55.0.10.pom.sha1

@@ -0,0 +1 @@
+b6dd05008e3f4825e0b1acb7d342286b13e74781

package/local-maven-repo/host/exp/exponent/expo.modules.taskmanager/55.0.10/expo.modules.taskmanager-55.0.10.pom.sha256

@@ -0,0 +1 @@
+00acc1a69d167e7e01dc9cb5f82c4b0e49553cc19e57777b6271512f49b17a6d

package/local-maven-repo/host/exp/exponent/expo.modules.taskmanager/55.0.10/expo.modules.taskmanager-55.0.10.pom.sha512

@@ -0,0 +1 @@
+f61c2355eb59a41ac20c8904e90f585519efeca03879eda82649d30c135859e5a1bafbfaca7237d789d8b08dd37d107c6c2228db04103c57d734eb303cb62979

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

@@ -3,11 +3,11 @@
   <groupId>host.exp.exponent</groupId>
   <artifactId>expo.modules.taskmanager</artifactId>
   <versioning>
-    <latest>55.0.8</latest>
-    <release>55.0.8</release>
+    <latest>55.0.10</latest>
+    <release>55.0.10</release>
     <versions>
-      <version>55.0.8</version>
+      <version>55.0.10</version>
     </versions>
-    <lastUpdated>20260220175821</lastUpdated>
+    <lastUpdated>20260317165310</lastUpdated>
   </versioning>
 </metadata>

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

@@ -1 +1 @@
-4361d4c93608583133a3b7093bdaf03c
+d8e399bddb9b6e43f90f200e287e3336

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

@@ -1 +1 @@
-bdb080d03682fd1ed8d3317d77ed416d9918726c
+9f28052ab1b3d4efbc2eb5e520112fcf80497354

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

@@ -1 +1 @@
-16cdff0d963a61ba27a360eecf69517490f174796b000024f198d2b1149eda53
+9fce977db89a139b4d673fd5a7e83a9650a71e537e98d8591276b6cb0e59a8f1

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

@@ -1 +1 @@
-aa021153cefa3f52956a75e8181563e54ed37f8ff19f490fefcf32dbdcedc003e8ebc1c562f889eeb0af4fd8005b417008b0c362a061c574e122c67416c2a191
+e0d7fd85b52c68f38d365503b99b3742e4ac5846c482facbfe3b9c8d74a2a9600e4857bfe56d3ea20aba51377f95150af5b828fc440280b6ef2ca955a46ab6f4

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "expo-task-manager",
-  "version": "55.0.8",
+  "version": "55.0.10",
   "description": "Expo module that provides support for tasks that can run in the background.",
   "main": "build/TaskManager.js",
   "types": "build/TaskManager.d.ts",
@@ -42,5 +42,5 @@
     "expo": "*",
     "react-native": "*"
   },
-  "gitHead": "22e2ad4afba05b91f833f8cf07a36637748a1f70"
+  "gitHead": "9260ae10a08271027d85792b7128e0d4883dca4d"
 }

package/src/TaskManager.ts

@@ -1,7 +1,15 @@
-import { LegacyEventEmitter, UnavailabilityError } from 'expo-modules-core';
+import { LegacyEventEmitter, Platform, UnavailabilityError } from 'expo-modules-core';
+import { AppRegistry } from 'react-native';
 
 import ExpoTaskManager from './ExpoTaskManager';
 
+// Register a no-op headless task so that HeadlessJsTaskContext.startTask()
+// doesn't log a warning. On Android, TaskService registers a headless task
+// in native code to keep JS timers alive during background task execution.
+if (Platform.OS === 'android') {
+  AppRegistry.registerHeadlessTask('expo-task-manager', () => async () => {});
+}
+
 // @needsAudit @docsMissing
 /**
  * Error object that can be received through [`TaskManagerTaskBody`](#taskmanagertaskbody) when the

package/local-maven-repo/host/exp/exponent/expo.modules.taskmanager/55.0.8/expo.modules.taskmanager-55.0.8-sources.jar.md5

@@ -1 +0,0 @@
-a495364d98cfab4cfdd72dcc40ded29f

package/local-maven-repo/host/exp/exponent/expo.modules.taskmanager/55.0.8/expo.modules.taskmanager-55.0.8-sources.jar.sha1

@@ -1 +0,0 @@
-200a9dbd20ac61a820c7e2f25a0b3d88add38684

package/local-maven-repo/host/exp/exponent/expo.modules.taskmanager/55.0.8/expo.modules.taskmanager-55.0.8-sources.jar.sha256

@@ -1 +0,0 @@
-1a13d4a1c5042d7b5296e9db9937989f7f1fe3d3620bdfffffd2e243292fbcf5

package/local-maven-repo/host/exp/exponent/expo.modules.taskmanager/55.0.8/expo.modules.taskmanager-55.0.8-sources.jar.sha512

@@ -1 +0,0 @@
-755c124c19182bd5f33e1ef1f9061190b731e8e3137f094edfaee8ed0a880fccab5f1011e1a5c48205c86df424e9776bb9e59020e062dea6c8db1a8bca4af50d

package/local-maven-repo/host/exp/exponent/expo.modules.taskmanager/55.0.8/expo.modules.taskmanager-55.0.8.aar.md5

@@ -1 +0,0 @@
-fc74e9e574a5be051bdbafe46d563e08

package/local-maven-repo/host/exp/exponent/expo.modules.taskmanager/55.0.8/expo.modules.taskmanager-55.0.8.aar.sha1

@@ -1 +0,0 @@
-86d96fac2316eea17764907e879ba885d2adeb18

package/local-maven-repo/host/exp/exponent/expo.modules.taskmanager/55.0.8/expo.modules.taskmanager-55.0.8.aar.sha256

@@ -1 +0,0 @@
-a1243705ad1e8528fb334a20d31756ff78f1a7ab0ee15406890004f92f653993

package/local-maven-repo/host/exp/exponent/expo.modules.taskmanager/55.0.8/expo.modules.taskmanager-55.0.8.aar.sha512

@@ -1 +0,0 @@
-cd82576f43c8b2300966dff0c640590cc4c00933cd6ede6d682a2d46b13a47a12798d8e547e3693be3211651f5c3879b14754be054e683a54e59a1e44bc930a9

package/local-maven-repo/host/exp/exponent/expo.modules.taskmanager/55.0.8/expo.modules.taskmanager-55.0.8.module.md5

@@ -1 +0,0 @@
-0d02a0bba3ee3faf99fd4d5901197081

package/local-maven-repo/host/exp/exponent/expo.modules.taskmanager/55.0.8/expo.modules.taskmanager-55.0.8.module.sha1

@@ -1 +0,0 @@
-64a9bcf921120d3a68197e07e9c688e2b75b91d6

package/local-maven-repo/host/exp/exponent/expo.modules.taskmanager/55.0.8/expo.modules.taskmanager-55.0.8.module.sha256

@@ -1 +0,0 @@
-07dcc1fd9541f956b4998890f11978d4d7ac504d66a1d5c473f0449826fb3832

package/local-maven-repo/host/exp/exponent/expo.modules.taskmanager/55.0.8/expo.modules.taskmanager-55.0.8.module.sha512

@@ -1 +0,0 @@
-8f7a41322fd255276013657e37f6aa9140366ce08ecca8bc21c2c6e7829658221e5f664a9bff4f7d207ef3bfe76c5dc23dba7110eb81d89b477d10aa54892231

package/local-maven-repo/host/exp/exponent/expo.modules.taskmanager/55.0.8/expo.modules.taskmanager-55.0.8.pom.md5

@@ -1 +0,0 @@
-ebba0cad45a29da316ca948aaff43013

package/local-maven-repo/host/exp/exponent/expo.modules.taskmanager/55.0.8/expo.modules.taskmanager-55.0.8.pom.sha1

@@ -1 +0,0 @@
-3d4e37e1e95c9c9856dd08a4f3d30148c5769cc9

package/local-maven-repo/host/exp/exponent/expo.modules.taskmanager/55.0.8/expo.modules.taskmanager-55.0.8.pom.sha256

@@ -1 +0,0 @@
-0d8ef20d9e4bf0896f1fdcc77abf43bb949c07f3b3a7c8b45a4b09b84c79629a

package/local-maven-repo/host/exp/exponent/expo.modules.taskmanager/55.0.8/expo.modules.taskmanager-55.0.8.pom.sha512

@@ -1 +0,0 @@
-aed859f984cb25d17e67de7384a5401d1f49fe631c6b30595daed44de405479dd383741be5ed5957f4a6ec17e1ba99876d428685d38de8c995196f79a413c342