@capacitor/background-runner 1.0.6-dev-20240416T225651.0 → 1.0.6-dev-20240423T153554.0

package/README.md

@@ -69,6 +69,23 @@ Read about [Configuring `Info.plist`](https://capacitorjs.com/docs/ios/configura
 
 ## Android
 
+Insert the following line to `android/app/build.gradle`:
+
+```diff
+...
+
+repositories {
+    flatDir{
+        dirs '../capacitor-cordova-android-plugins/src/main/libs', 'libs'
++		dirs '../../node_modules/@capacitor/background-runner/android/src/main/libs', 'libs'
+    }
+}
+...
+
+```
+
+If you are upgrading from 1.0.5 with an existing Android project, be sure to delete the `android-js-engine-release.aar` from `android/src/main/libs`.
+
 ### Geolocation
 
 This API requires the following permissions be added to your `AndroidManifest.xml`:
@@ -151,6 +168,8 @@ addEventListener('remoteNotification', (resolve, reject, args) => {
 
 Calling `resolve()` \ `reject()` is **required** within every event handler called by the runner. Failure to do this could result in your runner being killed by the OS if your event is called while the app is in the background. If the app is in the foreground, async calls to `dispatchEvent` may not resolve.
 
+For more real world examples of using Background Runner, check out the [Background Runner Test App](https://github.com/ionic-team/background-runner-testapp).
+
 ## Configuring Background Runner
 
 <docgen-config>
@@ -256,6 +275,7 @@ It’s not possible to run persistent, always running background services on mob
 
 - Each invocation of your task has approximately up to 30 seconds of runtime before you must call `completed()` or your task is killed.
 - While you can set an interval to define when your task runs after the app is backgrounded, or how often it should run, this is not guaranteed. iOS will determine when and how often you task will ultimately run, determined in part by how often you app is used.
+- Background tasks are not executed in the simulator.
 
 ### Android
 

package/ios/Plugin/BackgroundRunner.swift

@@ -11,8 +11,7 @@ public class BackgroundRunner {
 
     public init() {
         do {
-            config = try self.loadRunnerConfig()
-            runner.start()
+            config = try self.loadRunnerConfig()            
         } catch {
             print("could not initialize BackgroundRunner: \(error)")
         }

package/ios/Plugin/RunnerEngine/Runner.swift

@@ -15,36 +15,4 @@ public class Runner {
     func createContext(name: String) throws -> Context {
         return try Context(vm: machine, contextName: name, runLoop: runLoop)
     }
-
-    func start() {
-        thread = Thread { [weak self] in
-            defer {
-                Thread.exit()
-            }
-
-            guard let self = self else { return }
-            guard let thread = self.thread else { return }
-
-            while !thread.isCancelled {
-                self.runLoop.run(mode: .default, before: .distantFuture)
-            }
-        }
-
-        thread?.qualityOfService = .userInitiated
-        thread?.start()
-    }
-
-    func stop() {
-        guard let thread = self.thread else {
-            return
-        }
-
-        thread.cancel()
-        
-        while !thread.isFinished {
-            Thread.sleep(forTimeInterval: 0.05)
-        }
-
-        self.thread = nil
-    }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@capacitor/background-runner",
-  "version": "1.0.6-dev-20240416T225651.0",
+  "version": "1.0.6-dev-20240423T153554.0",
   "description": "Capacitor Background Runner",
   "main": "dist/plugin.cjs.js",
   "module": "dist/esm/index.js",
@@ -81,5 +81,5 @@
       "src": "android"
     }
   },
-  "gitHead": "e1b54f7215adfbfa3f1a173eaf3e077be6d54a02"
+  "gitHead": "bfab85e50f1a4708e9100053ade7a7a0357c1654"
 }