@capacitor/background-runner 2.3.1 → 4.0.0-dev.28jul2026

package/CapacitorBackgroundRunner.podspec

@@ -11,7 +11,7 @@ Pod::Spec.new do |s|
   s.author = package['author']
   s.source = { :git => package['repository']['url'], :tag => s.version.to_s }
   s.source_files = 'ios/Sources/**/*.{swift,h,m,c,cc,mm,cpp}'
-  s.ios.deployment_target  = '14.0'
+  s.ios.deployment_target = '16.0'
   s.dependency 'Capacitor'
   s.swift_version = '5.1'
 end

package/Package.swift

@@ -5,7 +5,7 @@ import PackageDescription
 
 let package = Package(
     name: "CapacitorBackgroundRunner",
-    platforms: [.iOS(.v14), .macOS(.v13)],
+    platforms: [.iOS(.v16), .macOS(.v13)],
     products: [
         // Products define the executables and libraries a package produces, making them visible to other packages.
         .library(
@@ -14,7 +14,7 @@ let package = Package(
         )
     ],
     dependencies: [
-        .package(url: "https://github.com/ionic-team/capacitor-swift-pm.git", from: "7.0.0")
+        .package(url: "https://github.com/ionic-team/capacitor-swift-pm.git", from: "9.0.0-alpha.5")
     ],
     targets: [
         // Targets are the basic building blocks of a package, defining a module or a test suite.
@@ -23,7 +23,6 @@ let package = Package(
             name: "CapacitorBackgroundRunner",
             dependencies: [
                 .product(name: "Capacitor", package: "capacitor-swift-pm"),
-                .product(name: "Cordova", package: "capacitor-swift-pm"),
                 "RunnerEngine"
             ],
             path: "ios/Sources/CapacitorBackgroundRunner"

package/README.md

@@ -5,7 +5,7 @@ Background Runner provides an event-based standalone JavaScript environment for
 ## Install
 
 ```bash
-npm install @capacitor/background-runner@latest-7
+npm install @capacitor/background-runner
 npx cap sync
 ```
 
@@ -189,14 +189,14 @@ On load, Background Runner will automatically register a
 background task that will be scheduled and run once your app is
 backgrounded.
 
-| Prop            | Type                 | Description                                                                                                                                                                                          | Since |
-| --------------- | -------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----- |
-| **`label`**     | <code>string</code>  | The name of the runner, used in logs.                                                                                                                                                                | 1.0.0 |
-| **`src`**       | <code>string</code>  | The path to the runner JavaScript file, relative to the app bundle.                                                                                                                                  | 1.0.0 |
-| **`event`**     | <code>string</code>  | The name of the event that will be called when the OS executes the background task.                                                                                                                  | 1.0.0 |
-| **`repeat`**    | <code>boolean</code> | If background task should repeat based on the interval set in `interval`.                                                                                                                            | 1.0.0 |
-| **`interval`**  | <code>number</code>  | The number of minutes after the the app is put into the background in which the background task should begin. If `repeat` is true, this also specifies the number of minutes between each execution. | 1.0.0 |
-| **`autoStart`** | <code>boolean</code> | Automatically register and schedule background task on app load.                                                                                                                                     | 1.0.0 |
+| Prop            | Type                 | Description                                                                                                                                                                                      | Since |
+| --------------- | -------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ----- |
+| **`label`**     | <code>string</code>  | The name of the runner, used in logs.                                                                                                                                                            | 1.0.0 |
+| **`src`**       | <code>string</code>  | The path to the runner JavaScript file, relative to the app bundle.                                                                                                                              | 1.0.0 |
+| **`event`**     | <code>string</code>  | The name of the event that will be called when the OS executes the background task.                                                                                                              | 1.0.0 |
+| **`repeat`**    | <code>boolean</code> | If background task should repeat based on the interval set in `interval`.                                                                                                                        | 1.0.0 |
+| **`interval`**  | <code>number</code>  | The number of minutes after the app is put into the background in which the background task should begin. If `repeat` is true, this also specifies the number of minutes between each execution. | 1.0.0 |
+| **`autoStart`** | <code>boolean</code> | Automatically register and schedule background task on app load.                                                                                                                                 | 1.0.0 |
 
 ### Examples
 

package/android/build.gradle

@@ -1,35 +1,31 @@
 ext {
     junitVersion = project.hasProperty('junitVersion') ? rootProject.ext.junitVersion : '4.13.2'
-    androidxAppCompatVersion = project.hasProperty('androidxAppCompatVersion') ? rootProject.ext.androidxAppCompatVersion : '1.7.0'
-    androidxCoreKTXVersion = project.hasProperty('androidxCoreKTXVersion') ? rootProject.ext.androidxCoreKTXVersion : '1.12.0'
-    androidxJunitVersion = project.hasProperty('androidxJunitVersion') ? rootProject.ext.androidxJunitVersion : '1.2.1'
-    androidxEspressoCoreVersion = project.hasProperty('androidxEspressoCoreVersion') ? rootProject.ext.androidxEspressoCoreVersion : '3.6.1'
-    workManagerVersion = project.hasProperty('workManagerVersion') ? rootProject.ext.workManagerVersion : '2.8.1'
+    androidxAppCompatVersion = project.hasProperty('androidxAppCompatVersion') ? rootProject.ext.androidxAppCompatVersion : '1.7.1'
+    androidxCoreVersion = project.hasProperty('androidxCoreVersion') ? rootProject.ext.androidxCoreVersion : '1.19.0'
+    androidxJunitVersion = project.hasProperty('androidxJunitVersion') ? rootProject.ext.androidxJunitVersion : '1.3.0'
+    androidxEspressoCoreVersion = project.hasProperty('androidxEspressoCoreVersion') ? rootProject.ext.androidxEspressoCoreVersion : '3.7.0'
+    workManagerVersion = project.hasProperty('workManagerVersion') ? rootProject.ext.workManagerVersion : '2.11.0'
 
 }
 
 buildscript {
-    ext.kotlin_version = project.hasProperty("kotlin_version") ? rootProject.ext.kotlin_version : '1.9.25'
     repositories {
         google()
         mavenCentral()
     }
     dependencies {
-        classpath 'com.android.tools.build:gradle:8.7.2'
-        classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:$kotlin_version"
+        classpath 'com.android.tools.build:gradle:9.2.1'
 
     }
 }
 
 apply plugin: 'com.android.library'
-apply plugin: 'org.jetbrains.kotlin.android'
 
 android {
-    namespace "com.capacitorjs.plugins.backgroundrunner"
-    compileSdk project.hasProperty('compileSdkVersion') ? rootProject.ext.compileSdkVersion : 35
+    namespace = "com.capacitorjs.plugins.backgroundrunner"
+    compileSdk = project.hasProperty('compileSdkVersion') ? rootProject.ext.compileSdkVersion : 37
     defaultConfig {
-        minSdkVersion project.hasProperty('minSdkVersion') ? rootProject.ext.minSdkVersion : 23
-        targetSdkVersion project.hasProperty('targetSdkVersion') ? rootProject.ext.targetSdkVersion : 35
+        minSdkVersion project.hasProperty('minSdkVersion') ? rootProject.ext.minSdkVersion : 26
         versionCode 1
         versionName "1.0"
         testInstrumentationRunner "androidx.test.runner.AndroidJUnitRunner"
@@ -37,11 +33,11 @@ android {
     buildTypes {
         release {
             minifyEnabled false
-            proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
+            proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'
         }
     }
     lintOptions {
-        abortOnError false
+        abortOnError = false
     }
     compileOptions {
         sourceCompatibility JavaVersion.VERSION_21
@@ -61,10 +57,10 @@ repositories {
 dependencies {
     implementation fileTree(dir: 'libs', include: ['*.jar'])
     implementation project(':capacitor-android')
-    implementation (name: "android-js-engine-release", ext: "aar")
+    implementation ":android-js-engine-release@aar"
     implementation "androidx.work:work-runtime-ktx:$workManagerVersion"
     implementation "androidx.appcompat:appcompat:$androidxAppCompatVersion"
-    implementation "androidx.core:core-ktx:$androidxCoreKTXVersion"
+    implementation "androidx.core:core:$androidxCoreVersion"
     testImplementation "junit:junit:$junitVersion"
     androidTestImplementation "androidx.test.ext:junit:$androidxJunitVersion"
     androidTestImplementation "androidx.test.espresso:espresso-core:$androidxEspressoCoreVersion"

package/android/src/main/java/io/ionic/backgroundrunner/plugin/api/Device.kt

@@ -80,7 +80,7 @@ class Device (context: android.content.Context) : DeviceAPI {
         return false
     }
 
-    @SuppressWarnings("deprecation")
+    @Suppress("DEPRECATION")
     private fun getAndParseNetworkInfo(): NetworkStatus {
         val networkStatus = NetworkStatus()
         val networkInfo = connectivityManager.activeNetworkInfo

package/android/src/main/java/io/ionic/backgroundrunner/plugin/api/Notifications.kt

@@ -211,17 +211,9 @@ class Notifications(context: Context) : NotificationsAPI {
             PendingIntent.getBroadcast(context, request.id, intent, flags)
 
         if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.S && !alarmManager.canScheduleExactAlarms()) {
-            if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.M) {
-                alarmManager.setAndAllowWhileIdle(AlarmManager.RTC_WAKEUP, request.scheduleAt.time, pendingIntent);
-            } else {
-                alarmManager.set(AlarmManager.RTC, request.scheduleAt.time, pendingIntent);
-            }
+            alarmManager.setAndAllowWhileIdle(AlarmManager.RTC_WAKEUP, request.scheduleAt.time, pendingIntent)
         } else {
-            if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.M) {
-                alarmManager.setExactAndAllowWhileIdle(AlarmManager.RTC_WAKEUP, request.scheduleAt.time, pendingIntent);
-            } else {
-                alarmManager.setExact(AlarmManager.RTC, request.scheduleAt.time, pendingIntent);
-            }
+            alarmManager.setExactAndAllowWhileIdle(AlarmManager.RTC_WAKEUP, request.scheduleAt.time, pendingIntent)
         }
     }
 }

package/android/src/main/java/io/ionic/backgroundrunner/plugin/api/TimedNotificationPublisher.kt

@@ -34,6 +34,7 @@ class TimedNotificationPublisher : BroadcastReceiver() {
         notificationManager.notify(id, notification)
     }
 
+    @Suppress("DEPRECATION")
     private fun getParcelableExtraLegacy(intent: Intent): android.app.Notification? {
         return intent.getParcelableExtra(NOTIFICATION_KEY)
     }

package/dist/docs-api.json

@@ -948,7 +948,7 @@
               "name": "example"
             }
           ],
-          "docs": "The number of minutes after the the app is put into the background in which the background task should begin.\n\nIf `repeat` is true, this also specifies the number of minutes between each execution.",
+          "docs": "The number of minutes after the app is put into the background in which the background task should begin.\n\nIf `repeat` is true, this also specifies the number of minutes between each execution.",
           "complexTypes": [],
           "type": "number"
         },

package/dist/docs.json

@@ -369,7 +369,7 @@
               "name": "example"
             }
           ],
-          "docs": "The number of minutes after the the app is put into the background in which the background task should begin.\n\nIf `repeat` is true, this also specifies the number of minutes between each execution.",
+          "docs": "The number of minutes after the app is put into the background in which the background task should begin.\n\nIf `repeat` is true, this also specifies the number of minutes between each execution.",
           "complexTypes": [],
           "type": "number"
         },

package/dist/esm/definitions.d.ts

@@ -25,7 +25,7 @@ export interface BackgroundRunnerConfig {
      */
     repeat: boolean;
     /**
-     * The number of minutes after the the app is put into the background in which the background task should begin.
+     * The number of minutes after the app is put into the background in which the background task should begin.
      *
      * If `repeat` is true, this also specifies the number of minutes between each execution.
      *
@@ -76,7 +76,7 @@ declare module '@capacitor/cli' {
              */
             repeat: boolean;
             /**
-             * The number of minutes after the the app is put into the background in which the background task should begin.
+             * The number of minutes after the app is put into the background in which the background task should begin.
              *
              * If `repeat` is true, this also specifies the number of minutes between each execution.
              *

package/dist/esm/definitions.js.map

@@ -1 +1 @@
-{"version":3,"file":"definitions.js","sourceRoot":"","sources":["../../src/definitions.ts"],"names":[],"mappings":"AAAA,wCAAwC","sourcesContent":["/// <reference types=\"@capacitor/cli\" />\n\nimport type { PermissionState, PluginListenerHandle } from '@capacitor/core';\n\nexport interface BackgroundRunnerConfig {\n  /**\n   * The name of the runner, used in logs.\n   *\n   * @since 1.0.0\n   */\n  label: string;\n  /**\n   * The path to the runner JavaScript file, relative to the app bundle.\n   *\n   * @since 1.0.0\n   */\n  src: string;\n  /**\n   * The name of the event that will be called when the OS executes the background task.\n   *\n   * @since 1.0.0\n   */\n  event: string;\n  /**\n   * If background task should repeat based on the interval set in `interval`.\n   *\n   * @since 1.0.0\n   */\n  repeat: boolean;\n  /**\n   * The number of minutes after the the app is put into the background in which the background task should begin.\n   *\n   * If `repeat` is true, this also specifies the number of minutes between each execution.\n   *\n   * @since 1.0.0\n   */\n  interval: number;\n  /**\n   * Automatically register and schedule background task on app load.\n   *\n   * @since 1.0.0\n   */\n  autoStart?: boolean;\n}\n\ndeclare module '@capacitor/cli' {\n  export interface PluginsConfig {\n    /**\n     * On load, Background Runner will automatically register a\n     * background task that will be scheduled and run once your app is\n     * backgrounded.\n     */\n    BackgroundRunner?: {\n      /**\n       * The name of the runner, used in logs.\n       *\n       * @since 1.0.0\n       * @example \"com.example.background.task\"\n       */\n      label: string;\n      /**\n       * The path to the runner JavaScript file, relative to the app bundle.\n       *\n       * @since 1.0.0\n       * @example \"runners/background.js\"\n       */\n      src: string;\n      /**\n       * The name of the event that will be called when the OS executes the background task.\n       *\n       * @since 1.0.0\n       * @example \"myCustomEvent\"\n       */\n      event: string;\n      /**\n       * If background task should repeat based on the interval set in `interval`.\n       *\n       * @since 1.0.0\n       * @example true\n       */\n      repeat: boolean;\n      /**\n       * The number of minutes after the the app is put into the background in which the background task should begin.\n       *\n       * If `repeat` is true, this also specifies the number of minutes between each execution.\n       *\n       * @since 1.0.0\n       * @example 15\n       */\n      interval: number;\n      /**\n       * Automatically register and schedule background task on app load.\n       *\n       * @since 1.0.0\n       * @example true\n       */\n      autoStart?: boolean;\n    };\n  }\n}\n\nexport type API = 'geolocation' | 'notifications';\n\nexport interface PermissionStatus {\n  geolocation: PermissionState;\n  notifications: PermissionState;\n}\n\nexport interface DispatchEventOptions {\n  /**\n   * The runner label to dispatch the event to\n   *\n   * @since 1.0.0\n   */\n  label: string;\n  /**\n   * The name of the registered event listener.\n   *\n   * @since 1.0.0\n   */\n  event: string;\n  details: { [key: string]: any };\n}\n\nexport interface RequestPermissionOptions {\n  apis: API[];\n}\n\nexport interface RegisterBackgroundTaskOptions {\n  runner: BackgroundRunnerConfig;\n}\n\nexport interface NotificationActionEvent {\n  actionTypeId: string;\n  notificationId: number;\n}\n\nexport interface BackgroundRunnerPlugin {\n  /**\n   * Check permissions for the various Capacitor device APIs.\n   *\n   * @since 1.0.0\n   */\n  checkPermissions(): Promise<PermissionStatus>;\n  /**\n   * Request permission to display local notifications.\n   *\n   * @since 1.0.0\n   */\n  requestPermissions(options: RequestPermissionOptions): Promise<PermissionStatus>;\n  /**\n   * Dispatches an event to the configured runner.\n   * @param options\n   * @since 1.0.0\n   */\n  dispatchEvent<T = void>(options: DispatchEventOptions): Promise<T>;\n  /**\n   * Add a listener for notification actions.\n   *\n   * @since 2.1.1\n   */\n  addListener(\n    eventName: 'backgroundRunnerNotificationReceived',\n    listenerFunc: (event: NotificationActionEvent) => void,\n  ): Promise<PluginListenerHandle>;\n  /**\n   * Remove notification action listeners for this plugin.\n   *\n   * @since 2.1.1\n   */\n  removeNotificationListeners(): Promise<void>;\n}\n\ndeclare module '@capacitor/cli' {\n  export interface PluginsConfig {\n    BackgroundRunner?: BackgroundRunnerConfig;\n  }\n}\n"]}
+{"version":3,"file":"definitions.js","sourceRoot":"","sources":["../../src/definitions.ts"],"names":[],"mappings":"AAAA,wCAAwC","sourcesContent":["/// <reference types=\"@capacitor/cli\" />\n\nimport type { PermissionState, PluginListenerHandle } from '@capacitor/core';\n\nexport interface BackgroundRunnerConfig {\n  /**\n   * The name of the runner, used in logs.\n   *\n   * @since 1.0.0\n   */\n  label: string;\n  /**\n   * The path to the runner JavaScript file, relative to the app bundle.\n   *\n   * @since 1.0.0\n   */\n  src: string;\n  /**\n   * The name of the event that will be called when the OS executes the background task.\n   *\n   * @since 1.0.0\n   */\n  event: string;\n  /**\n   * If background task should repeat based on the interval set in `interval`.\n   *\n   * @since 1.0.0\n   */\n  repeat: boolean;\n  /**\n   * The number of minutes after the app is put into the background in which the background task should begin.\n   *\n   * If `repeat` is true, this also specifies the number of minutes between each execution.\n   *\n   * @since 1.0.0\n   */\n  interval: number;\n  /**\n   * Automatically register and schedule background task on app load.\n   *\n   * @since 1.0.0\n   */\n  autoStart?: boolean;\n}\n\ndeclare module '@capacitor/cli' {\n  export interface PluginsConfig {\n    /**\n     * On load, Background Runner will automatically register a\n     * background task that will be scheduled and run once your app is\n     * backgrounded.\n     */\n    BackgroundRunner?: {\n      /**\n       * The name of the runner, used in logs.\n       *\n       * @since 1.0.0\n       * @example \"com.example.background.task\"\n       */\n      label: string;\n      /**\n       * The path to the runner JavaScript file, relative to the app bundle.\n       *\n       * @since 1.0.0\n       * @example \"runners/background.js\"\n       */\n      src: string;\n      /**\n       * The name of the event that will be called when the OS executes the background task.\n       *\n       * @since 1.0.0\n       * @example \"myCustomEvent\"\n       */\n      event: string;\n      /**\n       * If background task should repeat based on the interval set in `interval`.\n       *\n       * @since 1.0.0\n       * @example true\n       */\n      repeat: boolean;\n      /**\n       * The number of minutes after the app is put into the background in which the background task should begin.\n       *\n       * If `repeat` is true, this also specifies the number of minutes between each execution.\n       *\n       * @since 1.0.0\n       * @example 15\n       */\n      interval: number;\n      /**\n       * Automatically register and schedule background task on app load.\n       *\n       * @since 1.0.0\n       * @example true\n       */\n      autoStart?: boolean;\n    };\n  }\n}\n\nexport type API = 'geolocation' | 'notifications';\n\nexport interface PermissionStatus {\n  geolocation: PermissionState;\n  notifications: PermissionState;\n}\n\nexport interface DispatchEventOptions {\n  /**\n   * The runner label to dispatch the event to\n   *\n   * @since 1.0.0\n   */\n  label: string;\n  /**\n   * The name of the registered event listener.\n   *\n   * @since 1.0.0\n   */\n  event: string;\n  details: { [key: string]: any };\n}\n\nexport interface RequestPermissionOptions {\n  apis: API[];\n}\n\nexport interface RegisterBackgroundTaskOptions {\n  runner: BackgroundRunnerConfig;\n}\n\nexport interface NotificationActionEvent {\n  actionTypeId: string;\n  notificationId: number;\n}\n\nexport interface BackgroundRunnerPlugin {\n  /**\n   * Check permissions for the various Capacitor device APIs.\n   *\n   * @since 1.0.0\n   */\n  checkPermissions(): Promise<PermissionStatus>;\n  /**\n   * Request permission to display local notifications.\n   *\n   * @since 1.0.0\n   */\n  requestPermissions(options: RequestPermissionOptions): Promise<PermissionStatus>;\n  /**\n   * Dispatches an event to the configured runner.\n   * @param options\n   * @since 1.0.0\n   */\n  dispatchEvent<T = void>(options: DispatchEventOptions): Promise<T>;\n  /**\n   * Add a listener for notification actions.\n   *\n   * @since 2.1.1\n   */\n  addListener(\n    eventName: 'backgroundRunnerNotificationReceived',\n    listenerFunc: (event: NotificationActionEvent) => void,\n  ): Promise<PluginListenerHandle>;\n  /**\n   * Remove notification action listeners for this plugin.\n   *\n   * @since 2.1.1\n   */\n  removeNotificationListeners(): Promise<void>;\n}\n\ndeclare module '@capacitor/cli' {\n  export interface PluginsConfig {\n    BackgroundRunner?: BackgroundRunnerConfig;\n  }\n}\n"]}

package/ios/Sources/CapacitorBackgroundRunner/CapacitorBackgroundRunner.swift

@@ -1,281 +1,308 @@
-import Foundation
 import Capacitor
-import WatchConnectivity
+import Foundation
 import UserNotifications
+import WatchConnectivity
 
 @objc(BackgroundRunnerPlugin)
 public class BackgroundRunnerPlugin: CAPPlugin, CAPBridgedPlugin {
-    public let identifier = "CapacitorBackgroundRunnerPlugin"
-    public let jsName = "CapacitorBackgroundRunner"
-    public let pluginMethods: [CAPPluginMethod] = [
-        CAPPluginMethod(name: "checkPermissions", returnType: CAPPluginReturnPromise),
-        CAPPluginMethod(name: "requestPermissions", returnType: CAPPluginReturnPromise),
-        CAPPluginMethod(name: "dispatchEvent", returnType: CAPPluginReturnPromise),
-        CAPPluginMethod(name: "registerBackgroundTask", returnType: CAPPluginReturnPromise),
-        CAPPluginMethod(name: "removeNotificationListeners", returnType: CAPPluginReturnPromise)
-    ]
-    private let impl = BackgroundRunner()
-    private weak var originalDelegate: UNUserNotificationCenterDelegate?
-
-    override public func load() {
-        NotificationCenter.default.addObserver(
-            self,
-            selector: #selector(didEnterBackground),
-            name: UIApplication.didEnterBackgroundNotification,
-            object: nil
-        )
+  public let identifier = "CapacitorBackgroundRunnerPlugin"
+  public let jsName = "CapacitorBackgroundRunner"
+  public let pluginMethods: [CAPPluginMethod] = [
+    CAPPluginMethod(name: "checkPermissions", returnType: CAPPluginReturnPromise),
+    CAPPluginMethod(name: "requestPermissions", returnType: CAPPluginReturnPromise),
+    CAPPluginMethod(name: "dispatchEvent", returnType: CAPPluginReturnPromise),
+    CAPPluginMethod(name: "registerBackgroundTask", returnType: CAPPluginReturnPromise),
+    CAPPluginMethod(name: "removeNotificationListeners", returnType: CAPPluginReturnPromise),
+  ]
+  private let impl = BackgroundRunner()
+  private weak var originalDelegate: UNUserNotificationCenterDelegate?
+
+  override public func load() {
+    NotificationCenter.default.addObserver(
+      self,
+      selector: #selector(didEnterBackground),
+      name: UIApplication.didEnterBackgroundNotification,
+      object: nil
+    )
+
+    // Register as notification delegate
+    registerNotificationCategories()
+
+    initWatchConnectivity()
+  }
+
+  @objc override public func checkPermissions(_ call: CAPPluginCall) {
+    // check geolocation permissions
+    let geolocationState = CapacitorGeolocation.checkPermission()
+
+    // check notification permissions
+    let notificationState = CapacitorNotifications.checkPermission()
+
+    call.resolve([
+      "geolocation": geolocationState,
+      "notifications": notificationState,
+    ])
+  }
+
+  @objc override public func requestPermissions(_ call: CAPPluginCall) {
+    Task {
+      let permissions = call.getArray("apis") as? [String] ?? []
+
+      do {
+        if permissions.contains("notifications") {
+          try CapacitorNotifications.requestPermission()
+        }
 
-        // Register as notification delegate
-        registerNotificationCategories()
+        if permissions.contains("geolocation") {
+          let geolocation = CapacitorGeolocation()
+          print("geolocation requested...")
+          try await geolocation.requestPermission()
+          print("geolocation requested...done")
+        }
 
-        initWatchConnectivity()
+        self.checkPermissions(call)
+      } catch {
+        call.reject("\(error)")
+      }
     }
+  }
 
-    @objc override public func checkPermissions(_ call: CAPPluginCall) {
-        // check geolocation permissions
-        let geolocationState = CapacitorGeolocation.checkPermission()
+  @objc func dispatchEvent(_ call: CAPPluginCall) {
+    do {
+      guard let runnerEvent = call.getString("event"), !runnerEvent.isEmpty else {
+        throw BackgroundRunnerPluginError.invalidArgument(reason: "event is missing or invalid")
+      }
 
-        // check notification permissions
-        let notificationState = CapacitorNotifications.checkPermission()
+      let details = call.getObject("details", JSObject())
 
-        call.resolve([
-            "geolocation": geolocationState,
-            "notifications": notificationState
-        ])
-    }
+      guard var config = impl.config else {
+        throw BackgroundRunnerPluginError.noRunnerConfig
+      }
 
-    @objc override public func requestPermissions(_ call: CAPPluginCall) {
-        Task {
-            let permissions = call.getArray("apis") as? [String] ?? []
-
-            do {
-                if permissions.contains("notifications") {
-                    try CapacitorNotifications.requestPermission()
-                }
-
-                if permissions.contains("geolocation") {
-                    let geolocation = CapacitorGeolocation()
-                    print("geolocation requested...")
-                    try await geolocation.requestPermission()
-                    print("geolocation requested...done")
-                }
-
-                self.checkPermissions(call)
-            } catch {
-                call.reject("\(error)")
-            }
-        }
-    }
+      config.event = runnerEvent
 
-    @objc func dispatchEvent(_ call: CAPPluginCall) {
+      // swiftlint:disable:next unowned_variable_capture
+      DispatchQueue.global(qos: .userInitiated).async { [unowned self] in
         do {
-            guard let runnerEvent = call.getString("event"), !runnerEvent.isEmpty else {
-                throw BackgroundRunnerPluginError.invalidArgument(reason: "event is missing or invalid")
-            }
-
-            let details = call.getObject("details", JSObject())
-
-            guard var config = impl.config else {
-                throw BackgroundRunnerPluginError.noRunnerConfig
-            }
-
-            config.event = runnerEvent
-
-            // swiftlint:disable:next unowned_variable_capture
-            DispatchQueue.global(qos: .userInitiated).async { [unowned self] in
-                do {
-                    let result = try self.impl.execute(
-                        config: config,
-                        inputArgs: details as [String: Any],
-                        callbackId: call.callbackId
-                    )
-
-                    if let result = result {
-                        call.resolve(result)
-                        return
-                    }
-
-                    call.resolve()
-                } catch {
-                    call.reject("\(error)")
-                }
-            }
+          let result = try self.impl.execute(
+            config: config,
+            inputArgs: details as [String: Any],
+            callbackId: call.callbackId
+          )
+
+          if let result = result {
+            call.resolve(result)
+            return
+          }
+
+          call.resolve()
         } catch {
-            call.reject("\(error)")
+          call.reject("\(error)")
         }
+      }
+    } catch {
+      call.reject("\(error)")
+    }
+  }
+
+  @objc func registerBackgroundTask(_ call: CAPPluginCall) {
+    call.resolve()
+  }
+
+  @objc func removeNotificationListeners(_ call: CAPPluginCall) {
+    notifyListeners("backgroundRunnerNotificationReceived", data: nil)
+    call.resolve()
+  }
+
+  @objc private func didEnterBackground() {
+    do {
+      try impl.scheduleBackgroundTasks()
+    } catch {
+      print("could not schedule background task: \(error)")
     }
+  }
 
-    @objc func registerBackgroundTask(_ call: CAPPluginCall) {
-        call.resolve()
+  public static func registerBackgroundTask() {
+    do {
+      try BackgroundRunner.shared.registerBackgroundTask()
+    } catch {
+      print("could not register background task: \(error)")
+    }
+  }
+
+  public static func dispatchEvent(
+    event: String, eventArgs: [AnyHashable: Any], completionHandler: ((Result<Bool, Error>) -> Void)
+  ) {
+    if event.isEmpty {
+      completionHandler(
+        .failure(BackgroundRunnerPluginError.invalidArgument(reason: "event is missing or invalid"))
+      )
+      return
     }
 
-    @objc func removeNotificationListeners(_ call: CAPPluginCall) {
-        notifyListeners("backgroundRunnerNotificationReceived", data: nil)
-        call.resolve()
+    var args: [String: Any] = [:]
+
+    eventArgs.forEach { (key: AnyHashable, value: Any) in
+      if let strKey = key as? String {
+        args[strKey] = value
+      }
     }
 
-    @objc private func didEnterBackground() {
-        do {
-            try impl.scheduleBackgroundTasks()
-        } catch {
-            print("could not schedule background task: \(error)")
-        }
+    do {
+      try BackgroundRunner.shared.dispatchEvent(event: event, inputArgs: args)
+      completionHandler(.success(true))
+    } catch {
+      completionHandler(.failure(error))
     }
+  }
 
-    public static func registerBackgroundTask() {
-        do {
-            try BackgroundRunner.shared.registerBackgroundTask()
-        } catch {
-            print("could not register background task: \(error)")
-        }
+  public static func handleApplicationDidFinishLaunching(
+    launchOptions: [UIApplication.LaunchOptionsKey: Any]?
+  ) {
+    guard let launchOptions = launchOptions else {
+      return
     }
 
-    public static func dispatchEvent(event: String, eventArgs: [AnyHashable: Any], completionHandler: ((Result<Bool, Error>) -> Void)) {
-        if event.isEmpty {
-            completionHandler(.failure(BackgroundRunnerPluginError.invalidArgument(reason: "event is missing or invalid")))
-            return
-        }
+    var events: [String: [String: Any]?] = [:]
 
-        var args: [String: Any] = [:]
+    if launchOptions[.location] != nil {
+      // application was launched for a location event
+      var details: [String: Any] = [:]
+      details["locations"] = nil
 
-        eventArgs.forEach { (key: AnyHashable, value: Any) in
-            if let strKey = key as? String {
-                args[strKey] = value
-            }
-        }
+      if let location = CapacitorGeolocation.getCurrentKnownLocation() {
+        var details: [String: Any] = [:]
+        details["locations"] = [location]
+      }
 
-        do {
-            try BackgroundRunner.shared.dispatchEvent(event: event, inputArgs: args)
-            completionHandler(.success(true))
-        } catch {
-            completionHandler(.failure(error))
-        }
+      events["currentLocation"] = details
     }
 
-    public static func handleApplicationDidFinishLaunching(launchOptions: [UIApplication.LaunchOptionsKey: Any]?) {
-        guard let launchOptions = launchOptions else {
-            return
-        }
-
-        var events: [String: [String: Any]?] = [:]
-
-        if launchOptions[.location] != nil {
-            // application was launched for a location event
-            var details: [String: Any] = [:]
-            details["locations"] = nil
+    print("emit events: \(events)")
 
-            if let location = CapacitorGeolocation.getCurrentKnownLocation() {
-                var details: [String: Any] = [:]
-                details["locations"] = [location]
-            }
+  }
 
-            events["currentLocation"] = details
-        }
+  private func initWatchConnectivity() {
+    if !WCSession.isSupported() {
+      return
+    }
 
-        print("emit events: \(events)")
+    guard let config = impl.config else {
+      return
+    }
 
+    if !config.enableWatchConnectivity {
+      return
     }
 
-    private func initWatchConnectivity() {
-        if !WCSession.isSupported() {
-            return
-        }
+    WCSession.default.delegate = self
+    WCSession.default.activate()
 
-        guard let config = impl.config else {
-            return
-        }
-
-        if !config.enableWatchConnectivity {
-            return
-        }
+    print("Watch Connectivity Enabled")
+  }
 
-        WCSession.default.delegate = self
-        WCSession.default.activate()
+  @objc func registerNotificationCategories() {
+    let notificationCenter = UNUserNotificationCenter.current()
 
-        print("Watch Connectivity Enabled")
+    // Capture the original delegate if it's not self
+    if notificationCenter.delegate !== self {
+      originalDelegate = notificationCenter.delegate
     }
 
-    @objc func registerNotificationCategories() {
-        let notificationCenter = UNUserNotificationCenter.current()
-
-        // Capture the original delegate if it's not self
-        if notificationCenter.delegate !== self {
-            originalDelegate = notificationCenter.delegate
-        }
-
-        // Set the plugin as the notification delegate
-        notificationCenter.delegate = self
-    }
+    // Set the plugin as the notification delegate
+    notificationCenter.delegate = self
+  }
 }
 
 // MARK: - UNUserNotificationCenterDelegate
 extension BackgroundRunnerPlugin: UNUserNotificationCenterDelegate {
-    // This method will be called when a notification is tapped
-    public func userNotificationCenter(_ center: UNUserNotificationCenter,
-                                       didReceive response: UNNotificationResponse,
-                                       withCompletionHandler completionHandler: @escaping () -> Void) {
-        let userInfo = response.notification.request.content.userInfo
-
-        if isBackgroundRunnerNotification(userInfo) {
-            handleBackgroundRunnerNotification(response, completionHandler: completionHandler)
-        } else {
-            forwardToOriginalDelegate(center, didReceive: response, withCompletionHandler: completionHandler)
-        }
+  // This method will be called when a notification is tapped
+  public func userNotificationCenter(
+    _ center: UNUserNotificationCenter,
+    didReceive response: UNNotificationResponse,
+    withCompletionHandler completionHandler: @escaping () -> Void
+  ) {
+    let userInfo = response.notification.request.content.userInfo
+
+    if isBackgroundRunnerNotification(userInfo) {
+      handleBackgroundRunnerNotification(response, completionHandler: completionHandler)
+    } else {
+      forwardToOriginalDelegate(
+        center, didReceive: response, withCompletionHandler: completionHandler)
     }
-
-    // This is needed to present notifications when the app is in the foreground
-    public func userNotificationCenter(_ center: UNUserNotificationCenter,
-                                       willPresent notification: UNNotification,
-                                       withCompletionHandler completionHandler: @escaping (UNNotificationPresentationOptions) -> Void) {
-        let userInfo = notification.request.content.userInfo
-
-        if isBackgroundRunnerNotification(userInfo) {
-            handleBackgroundRunnerPresentation(completionHandler: completionHandler)
-        } else {
-            forwardToOriginalDelegate(center, willPresent: notification, withCompletionHandler: completionHandler)
-        }
+  }
+
+  // This is needed to present notifications when the app is in the foreground
+  public func userNotificationCenter(
+    _ center: UNUserNotificationCenter,
+    willPresent notification: UNNotification,
+    withCompletionHandler completionHandler: @escaping (UNNotificationPresentationOptions) -> Void
+  ) {
+    let userInfo = notification.request.content.userInfo
+
+    if isBackgroundRunnerNotification(userInfo) {
+      handleBackgroundRunnerPresentation(completionHandler: completionHandler)
+    } else {
+      forwardToOriginalDelegate(
+        center, willPresent: notification, withCompletionHandler: completionHandler)
     }
+  }
 
-    // MARK: - Helper Methods
-
-    private func isBackgroundRunnerNotification(_ userInfo: [AnyHashable: Any]) -> Bool {
-        return (userInfo["source"] as? String) == "capacitor-background-runner"
-    }
+  // MARK: - Helper Methods
 
-    private func handleBackgroundRunnerNotification(_ response: UNNotificationResponse, completionHandler: @escaping () -> Void) {
-        let actionTypeId = response.notification.request.content.categoryIdentifier
-        let notificationId = Int(response.notification.request.identifier) ?? -1
+  private func isBackgroundRunnerNotification(_ userInfo: [AnyHashable: Any]) -> Bool {
+    return (userInfo["source"] as? String) == "capacitor-background-runner"
+  }
 
-        let eventData: [String: Any] = [
-            "actionTypeId": actionTypeId,
-            "notificationId": notificationId
-        ]
+  private func handleBackgroundRunnerNotification(
+    _ response: UNNotificationResponse, completionHandler: @escaping () -> Void
+  ) {
+    let actionTypeId = response.notification.request.content.categoryIdentifier
+    let notificationId = Int(response.notification.request.identifier) ?? -1
 
-        notifyListeners("backgroundRunnerNotificationReceived", data: eventData, retainUntilConsumed: true)
-        completionHandler()
-    }
+    let eventData: [String: Any] = [
+      "actionTypeId": actionTypeId,
+      "notificationId": notificationId,
+    ]
 
-    private func forwardToOriginalDelegate(_ center: UNUserNotificationCenter, didReceive response: UNNotificationResponse, withCompletionHandler completionHandler: @escaping () -> Void) {
-        if let originalDelegate = originalDelegate, originalDelegate.responds(to: #selector(userNotificationCenter(_:didReceive:withCompletionHandler:))) {
-            originalDelegate.userNotificationCenter?(center, didReceive: response, withCompletionHandler: completionHandler)
-        } else {
-            completionHandler()
-        }
+    notifyListeners(
+      "backgroundRunnerNotificationReceived", data: eventData, retainUntilConsumed: true)
+    completionHandler()
+  }
+
+  private func forwardToOriginalDelegate(
+    _ center: UNUserNotificationCenter, didReceive response: UNNotificationResponse,
+    withCompletionHandler completionHandler: @escaping () -> Void
+  ) {
+    if let originalDelegate = originalDelegate,
+      originalDelegate.responds(
+        to: #selector(userNotificationCenter(_:didReceive:withCompletionHandler:)))
+    {
+      originalDelegate.userNotificationCenter?(
+        center, didReceive: response, withCompletionHandler: completionHandler)
+    } else {
+      completionHandler()
     }
-
-    private func handleBackgroundRunnerPresentation(completionHandler: @escaping (UNNotificationPresentationOptions) -> Void) {
-        if #available(iOS 14.0, *) {
-            completionHandler([.banner, .sound, .badge])
-        } else {
-            completionHandler([.alert, .sound, .badge])
-        }
-    }
-
-    private func forwardToOriginalDelegate(_ center: UNUserNotificationCenter, willPresent notification: UNNotification, withCompletionHandler completionHandler: @escaping (UNNotificationPresentationOptions) -> Void) {
-        if let originalDelegate = originalDelegate, originalDelegate.responds(to: #selector(userNotificationCenter(_:willPresent:withCompletionHandler:))) {
-            originalDelegate.userNotificationCenter?(center, willPresent: notification, withCompletionHandler: completionHandler)
-        } else {
-            handleBackgroundRunnerPresentation(completionHandler: completionHandler)
-        }
+  }
+
+  private func handleBackgroundRunnerPresentation(
+    completionHandler: @escaping (UNNotificationPresentationOptions) -> Void
+  ) {
+    completionHandler([.banner, .sound, .badge])
+  }
+
+  private func forwardToOriginalDelegate(
+    _ center: UNUserNotificationCenter, willPresent notification: UNNotification,
+    withCompletionHandler completionHandler: @escaping (UNNotificationPresentationOptions) -> Void
+  ) {
+    if let originalDelegate = originalDelegate,
+      originalDelegate.responds(
+        to: #selector(userNotificationCenter(_:willPresent:withCompletionHandler:)))
+    {
+      originalDelegate.userNotificationCenter?(
+        center, willPresent: notification, withCompletionHandler: completionHandler)
+    } else {
+      handleBackgroundRunnerPresentation(completionHandler: completionHandler)
     }
+  }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@capacitor/background-runner",
-  "version": "2.3.1",
+  "version": "4.0.0-dev.28jul2026",
   "description": "Capacitor Background Runner",
   "main": "dist/plugin.cjs.js",
   "module": "dist/esm/index.js",
@@ -32,7 +32,7 @@
   ],
   "scripts": {
     "verify": "npm run verify:ios && npm run verify:android && npm run verify:web",
-    "verify:ios": "xcodebuild -scheme CapacitorBackgroundRunner -destination generic/platform=iOS && xcodebuild test -scheme CapacitorBackgroundRunner -destination 'platform=iOS Simulator,OS=18.6,name=iPhone 16 Pro'",
+    "verify:ios": "xcodebuild -scheme CapacitorBackgroundRunner -destination generic/platform=iOS && xcodebuild test -scheme CapacitorBackgroundRunner -destination 'platform=iOS Simulator,OS=26.0.1,name=iPhone 17 Pro'",
     "verify:android": "cd android && ./gradlew clean build test && cd ..",
     "verify:web": "npm run build",
     "lint": "npm run eslint && npm run prettier -- --check && npm run swiftlint -- lint",
@@ -43,7 +43,7 @@
     "docgen": "docgen --api BackgroundRunnerPlugin --output-readme README.md --output-json dist/docs.json",
     "docgen-api": "docgen --api CapacitorAPI --output-readme API.md --output-json dist/docs-api.json && node ./scripts/combine_docs.js",
     "build-sdk": "./scripts/build-native-sdks.sh",
-    "build": "npm run clean && npm run docgen && npm run docgen-api && tsc && rollup -c rollup.config.js --bundleConfigAsCjs && npm run build-sdk && ./scripts/copy-native-sdks.sh && npm pack && mv ./capacitor-background-runner-*.tgz ../../ && ./scripts/copy-readme.sh",
+    "build": "npm run clean && npm run docgen && npm run docgen-api && tsc && rollup -c rollup.config.mjs --bundleConfigAsCjs && npm run build-sdk && ./scripts/copy-native-sdks.sh && npm pack && mv ./capacitor-background-runner-*.tgz ../../ && ./scripts/copy-readme.sh",
     "pack": "npm run build && ./scripts/copy-native-sdks.sh && npm pack && mv ./capacitor-background-runner-*.tgz ../../",
     "clean": "rimraf ./dist",
     "watch": "tsc --watch",
@@ -51,24 +51,24 @@
     "postinstall": "node ./scripts/install_libs.js"
   },
   "devDependencies": {
-    "@capacitor/android": "^6.2.1",
-    "@capacitor/cli": "^6.2.1",
-    "@capacitor/core": "^6.2.1",
-    "@capacitor/docgen": "0.3.0",
-    "@capacitor/ios": "^6.2.1",
+    "@capacitor/android": "next",
+    "@capacitor/cli": "next",
+    "@capacitor/core": "next",
+    "@capacitor/docgen": "^0.3.1",
+    "@capacitor/ios": "next",
     "@ionic/eslint-config": "^0.4.0",
     "@ionic/prettier-config": "^4.0.0",
     "@ionic/swiftlint-config": "^2.0.0",
     "eslint": "^8.57.1",
     "prettier": "^3.6.2",
     "prettier-plugin-java": "^2.7.7",
-    "rimraf": "^6.1.2",
-    "rollup": "^4.53.3",
+    "rimraf": "^6.1.0",
+    "rollup": "^4.53.2",
     "swiftlint": "^2.0.0",
     "typescript": "^5.9.3"
   },
   "peerDependencies": {
-    "@capacitor/core": ">=6.0.0"
+    "@capacitor/core": ">=9.0.0-alpha.5"
   },
   "prettier": "@ionic/prettier-config",
   "swiftlint": "@ionic/swiftlint-config",
@@ -82,6 +82,5 @@
     "android": {
       "src": "android"
     }
-  },
-  "gitHead": "894e33fd34e7906e17d03a62602f3c5ab4101100"
+  }
 }