flet-android-background 0.0.3__tar.gz → 0.0.4__tar.gz

{flet_android_background-0.0.3 → flet_android_background-0.0.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: flet-android-background
-Version: 0.0.3
+Version: 0.0.4
 Summary: Experimental foreground tasks for Flet on Android
 Project-URL: Homepage, https://github.com/alex-stoica/flet-android-background
 Project-URL: Repository, https://github.com/alex-stoica/flet-android-background
@@ -20,7 +20,7 @@ Experimental; no process-death recovery. Pip install.
 Create `BackgroundTask` per page; set `page.on_close = task.on_session_close`.
 Use `await task.start(work, enable_wifi_lock=True)` and `await task.stop()`.
 WifiLock: default off; released on exit. Android 14+: foreground/screen-on only;
-Doze applies. Bundles `WAKE_LOCK`; no CPU lock.
+Power policies apply. `WAKE_LOCK` bundled.
 
 Before building:
 

{flet_android_background-0.0.3 → flet_android_background-0.0.4}/README.md

@@ -5,7 +5,7 @@ Experimental; no process-death recovery. Pip install.
 Create `BackgroundTask` per page; set `page.on_close = task.on_session_close`.
 Use `await task.start(work, enable_wifi_lock=True)` and `await task.stop()`.
 WifiLock: default off; released on exit. Android 14+: foreground/screen-on only;
-Doze applies. Bundles `WAKE_LOCK`; no CPU lock.
+Power policies apply. `WAKE_LOCK` bundled.
 
 Before building:
 

{flet_android_background-0.0.3 → flet_android_background-0.0.4}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "flet-android-background"
-version = "0.0.3"
+version = "0.0.4"
 description = "Experimental foreground tasks for Flet on Android"
 readme = "README.md"
 license = "MIT"

{flet_android_background-0.0.3 → flet_android_background-0.0.4}/src/flet_android_background/service.py

@@ -17,14 +17,22 @@ class ForegroundService(ft.Service):
 
     async def start_foreground_service(self, *, notification_id=1,
                                        title="Background task", body="Running",
-                                       enable_wifi_lock: bool = False):
+                                       enable_wifi_lock: bool = False,
+                                       enable_cpu_lock: bool = False,
+                                       cpu_lock_timeout: int = 3600):
+        """CPU lock expires after 1–21600 seconds and stops the service."""
         if notification_id <= 0:
             raise ValueError("notification_id must be positive")
         if not isinstance(enable_wifi_lock, bool):
             raise TypeError("enable_wifi_lock must be a bool")
+        if not isinstance(enable_cpu_lock, bool):
+            raise TypeError("enable_cpu_lock must be a bool")
+        if type(cpu_lock_timeout) is not int or not 1 <= cpu_lock_timeout <= 21600:
+            raise ValueError("cpu_lock_timeout must be an integer from 1 to 21600 seconds")
         self._owner = await self._call(
             "start", id=notification_id, title=title, body=body,
             enable_wifi_lock=enable_wifi_lock,
+            enable_cpu_lock=enable_cpu_lock, cpu_lock_timeout=cpu_lock_timeout,
         )
 
     async def stop_foreground_service(self):

{flet_android_background-0.0.3 → flet_android_background-0.0.4}/src/flutter/flet_android_background/android/src/main/java/dev/alexstoica/background/BackgroundPlugin.java

@@ -54,7 +54,10 @@ public class BackgroundPlugin implements FlutterPlugin, ActivityAware,
                         .putExtra("id", ((Number) call.argument("id")).intValue())
                         .putExtra("title", (String) call.argument("title"))
                         .putExtra("body", (String) call.argument("body"))
-                        .putExtra("enable_wifi_lock", Boolean.TRUE.equals(call.argument("enable_wifi_lock")));
+                        .putExtra("enable_wifi_lock", Boolean.TRUE.equals(call.argument("enable_wifi_lock")))
+                        .putExtra("enable_cpu_lock", Boolean.TRUE.equals(call.argument("enable_cpu_lock")))
+                        .putExtra("cpu_lock_timeout", call.argument("cpu_lock_timeout") == null ? 3600L
+                            : ((Number) call.argument("cpu_lock_timeout")).longValue());
                     token = call.argument("owner");
                     if (token == null) throw new IllegalArgumentException("Missing service owner");
                     TaskService.owner = this;

{flet_android_background-0.0.3 → flet_android_background-0.0.4}/src/flutter/flet_android_background/android/src/main/java/dev/alexstoica/background/TaskService.java

@@ -9,11 +9,17 @@ import android.content.Intent;
 import android.os.Build;
 import android.net.wifi.WifiManager;
 import android.os.IBinder;
+import android.os.Handler;
+import android.os.Looper;
+import android.os.PowerManager;
 
 public class TaskService extends Service {
     static BackgroundPlugin owner;
     private static final String CHANNEL = "python_background";
     private WifiManager.WifiLock wifiLock;
+    private PowerManager.WakeLock cpuLock;
+    private final Handler handler = new Handler(Looper.getMainLooper());
+    private final Runnable expireCpuLock = this::stopSelf;
 
     @Override public int onStartCommand(Intent intent, int flags, int startId) {
         if (owner == null || intent == null || "stop".equals(intent.getAction())) {
@@ -40,6 +46,19 @@ public class TaskService extends Service {
             if (launch != null) builder.setContentIntent(PendingIntent.getActivity(
                 this, 0, launch, PendingIntent.FLAG_IMMUTABLE | PendingIntent.FLAG_UPDATE_CURRENT));
             startForeground(intent.getIntExtra("id", 1), builder.build());
+            if (intent.getBooleanExtra("enable_cpu_lock", false) && cpuLock == null) {
+                long seconds = intent.getLongExtra("cpu_lock_timeout", 3600L);
+                if (seconds < 1 || seconds > 21600) {
+                    throw new IllegalArgumentException("CPU lock timeout must be 1–21600 seconds");
+                }
+                PowerManager power = getSystemService(PowerManager.class);
+                if (power == null) throw new IllegalStateException("Power service unavailable");
+                cpuLock = power.newWakeLock(PowerManager.PARTIAL_WAKE_LOCK,
+                    "flet_android_background:cpu");
+                cpuLock.setReferenceCounted(false);
+                cpuLock.acquire(seconds * 1000L);
+                handler.postDelayed(expireCpuLock, seconds * 1000L);
+            }
             if (intent.getBooleanExtra("enable_wifi_lock", false) && wifiLock == null) {
                 WifiManager wifi = getApplicationContext().getSystemService(WifiManager.class);
                 if (wifi == null) throw new IllegalStateException("Wi-Fi service unavailable");
@@ -50,14 +69,19 @@ public class TaskService extends Service {
             }
         } catch (Exception error) {
             failure = error;
-            releaseWifiLock();
+            releaseLocks();
             stopSelf();
         }
         owner.onStarted(failure);
         return START_NOT_STICKY;
     }
 
-    private void releaseWifiLock() {
+    private void releaseLocks() {
+        handler.removeCallbacks(expireCpuLock);
+        if (cpuLock != null) {
+            if (cpuLock.isHeld()) cpuLock.release();
+            cpuLock = null;
+        }
         if (wifiLock != null) {
             if (wifiLock.isHeld()) wifiLock.release();
             wifiLock = null;
@@ -71,7 +95,7 @@ public class TaskService extends Service {
     @Override public void onDestroy() {
         BackgroundPlugin previous = owner;
         owner = null;
-        releaseWifiLock();
+        releaseLocks();
         stopForeground(STOP_FOREGROUND_REMOVE);
         if (previous != null) previous.onStopped();
         super.onDestroy();

{flet_android_background-0.0.3 → flet_android_background-0.0.4}/src/flutter/flet_android_background/pubspec.yaml

@@ -1,6 +1,6 @@
 name: flet_android_background
 description: Foreground task lifecycle for Flet Android apps
-version: 0.0.3
+version: 0.0.4
 publish_to: none
 environment:
   sdk: '>=3.11.0 <4.0.0'