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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: flet-android-background
-Version: 0.0.2
+Version: 0.0.3
 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
@@ -15,14 +15,14 @@ Description-Content-Type: text/markdown
 
 # flet-android-background
 
-Experimental Flet Android tasks; one owns the foreground service.
-Locking permits continued execution; Android restrictions still apply.
-Dismissal or runtime loss stops the service. Process death has no recovery.
+Experimental; no process-death recovery. Pip install.
 
-Install the wheel with pip. Add `BackgroundTask` to your Flet app, then
-`await task.start(work)` or `await task.stop()`.
+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.
 
-Before building the generated Flutter project:
+Before building:
 
 ```python
 from flet_android_background.android import configure_android_project
@@ -30,5 +30,4 @@ from flet_android_background.android import configure_android_project
 configure_android_project(path, service_type="dataSync")
 ```
 
-Supported types: `dataSync`, `shortService`, `specialUse`. The latter requires
-an app-specific `subtype` explanation. Android time limits apply.
+Types: `dataSync`, `shortService`, `specialUse` (requires `subtype`). Time limits apply.

flet_android_background-0.0.3/README.md

@@ -0,0 +1,18 @@
+# flet-android-background
+
+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.
+
+Before building:
+
+```python
+from flet_android_background.android import configure_android_project
+
+configure_android_project(path, service_type="dataSync")
+```
+
+Types: `dataSync`, `shortService`, `specialUse` (requires `subtype`). Time limits apply.

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

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

{flet_android_background-0.0.2 → flet_android_background-0.0.3}/src/flet_android_background/__init__.py

@@ -16,6 +16,7 @@ class BackgroundTask:
         self._task: asyncio.Task[None] | None = None
         self._work: asyncio.Task[None] | None = None
         self._lock = asyncio.Lock()
+        self._session_closed = False
 
     @property
     def running(self) -> bool:
@@ -25,6 +26,7 @@ class BackgroundTask:
                     **notification) -> bool:
         """Start once after notification permission; duplicates return False."""
         async with self._lock:
+            self._check_session()
             if self.running:
                 return False
             self.error = None
@@ -35,6 +37,7 @@ class BackgroundTask:
                 self._task = asyncio.create_task(self._rollback(starting))
                 await asyncio.shield(self._task)
                 raise
+            self._check_session()
             if failure is not None:
                 raise failure
             self._work = asyncio.create_task(self._invoke(work))
@@ -53,7 +56,7 @@ class BackgroundTask:
     async def _rollback(self, starting):
         try:
             self.error = await starting
-            if self.error is None:
+            if self.error is None and not self._session_closed:
                 await self.service.stop_foreground_service()
         except Exception as exc:
             self.error = exc
@@ -73,7 +76,8 @@ class BackgroundTask:
                 self.error = self.error or exc
             finally:
                 try:
-                    await self.service.stop_foreground_service()
+                    if not self._session_closed:
+                        await self.service.stop_foreground_service()
                 except Exception as exc:
                     self.error = self.error or exc
 
@@ -85,6 +89,15 @@ class BackgroundTask:
                     self._work.cancel()
                 await asyncio.shield(self._task)
 
+    def _check_session(self):
+        if self._session_closed:
+            raise RuntimeError("Flet session closed; create a new BackgroundTask")
+
+    async def on_session_close(self, event=None):
+        """Cancel Python work after session loss; native teardown stops the service."""
+        self._session_closed = True
+        await self.stop()
+
     async def _stopped(self, event):
         async with self._lock:
             if event.data == self.service._owner and self.running:

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

@@ -16,10 +16,16 @@ class ForegroundService(ft.Service):
         return await self._call("permission")
 
     async def start_foreground_service(self, *, notification_id=1,
-                                       title="Background task", body="Running"):
+                                       title="Background task", body="Running",
+                                       enable_wifi_lock: bool = False):
         if notification_id <= 0:
             raise ValueError("notification_id must be positive")
-        self._owner = await self._call("start", id=notification_id, title=title, body=body)
+        if not isinstance(enable_wifi_lock, bool):
+            raise TypeError("enable_wifi_lock must be a bool")
+        self._owner = await self._call(
+            "start", id=notification_id, title=title, body=body,
+            enable_wifi_lock=enable_wifi_lock,
+        )
 
     async def stop_foreground_service(self):
         await self._call("stop")

{flet_android_background-0.0.2 → flet_android_background-0.0.3}/src/flutter/flet_android_background/android/src/main/AndroidManifest.xml

@@ -1,6 +1,7 @@
 <manifest xmlns:android="http://schemas.android.com/apk/res/android">
     <uses-permission android:name="android.permission.POST_NOTIFICATIONS" />
     <uses-permission android:name="android.permission.FOREGROUND_SERVICE" />
+    <uses-permission android:name="android.permission.WAKE_LOCK" />
     <application>
         <service android:name="dev.alexstoica.background.TaskService"
             android:exported="false" />

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

@@ -53,7 +53,8 @@ public class BackgroundPlugin implements FlutterPlugin, ActivityAware,
                     Intent intent = new Intent(context, TaskService.class)
                         .putExtra("id", ((Number) call.argument("id")).intValue())
                         .putExtra("title", (String) call.argument("title"))
-                        .putExtra("body", (String) call.argument("body"));
+                        .putExtra("body", (String) call.argument("body"))
+                        .putExtra("enable_wifi_lock", Boolean.TRUE.equals(call.argument("enable_wifi_lock")));
                     token = call.argument("owner");
                     if (token == null) throw new IllegalArgumentException("Missing service owner");
                     TaskService.owner = this;

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

@@ -7,11 +7,13 @@ import android.app.PendingIntent;
 import android.app.Service;
 import android.content.Intent;
 import android.os.Build;
+import android.net.wifi.WifiManager;
 import android.os.IBinder;
 
 public class TaskService extends Service {
     static BackgroundPlugin owner;
     private static final String CHANNEL = "python_background";
+    private WifiManager.WifiLock wifiLock;
 
     @Override public int onStartCommand(Intent intent, int flags, int startId) {
         if (owner == null || intent == null || "stop".equals(intent.getAction())) {
@@ -38,14 +40,30 @@ 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_wifi_lock", false) && wifiLock == null) {
+                WifiManager wifi = getApplicationContext().getSystemService(WifiManager.class);
+                if (wifi == null) throw new IllegalStateException("Wi-Fi service unavailable");
+                wifiLock = wifi.createWifiLock(
+                    WifiManager.WIFI_MODE_FULL_HIGH_PERF, "flet_android_background:wifi");
+                wifiLock.setReferenceCounted(false);
+                wifiLock.acquire();
+            }
         } catch (Exception error) {
             failure = error;
+            releaseWifiLock();
             stopSelf();
         }
         owner.onStarted(failure);
         return START_NOT_STICKY;
     }
 
+    private void releaseWifiLock() {
+        if (wifiLock != null) {
+            if (wifiLock.isHeld()) wifiLock.release();
+            wifiLock = null;
+        }
+    }
+
     @Override public void onTaskRemoved(Intent intent) { stopSelf(); }
     @Override public void onTimeout(int startId) { stopSelf(); }
     @Override public void onTimeout(int startId, int type) { stopSelf(); }
@@ -53,6 +71,7 @@ public class TaskService extends Service {
     @Override public void onDestroy() {
         BackgroundPlugin previous = owner;
         owner = null;
+        releaseWifiLock();
         stopForeground(STOP_FOREGROUND_REMOVE);
         if (previous != null) previous.onStopped();
         super.onDestroy();

{flet_android_background-0.0.2 → flet_android_background-0.0.3}/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.2
+version: 0.0.3
 publish_to: none
 environment:
   sdk: '>=3.11.0 <4.0.0'

flet_android_background-0.0.2/README.md

@@ -1,19 +0,0 @@
-# flet-android-background
-
-Experimental Flet Android tasks; one owns the foreground service.
-Locking permits continued execution; Android restrictions still apply.
-Dismissal or runtime loss stops the service. Process death has no recovery.
-
-Install the wheel with pip. Add `BackgroundTask` to your Flet app, then
-`await task.start(work)` or `await task.stop()`.
-
-Before building the generated Flutter project:
-
-```python
-from flet_android_background.android import configure_android_project
-
-configure_android_project(path, service_type="dataSync")
-```
-
-Supported types: `dataSync`, `shortService`, `specialUse`. The latter requires
-an app-specific `subtype` explanation. Android time limits apply.