Add Wakelock service to Flutter and Python SDKs

Introduced a new Wakelock service to prevent device sleep in both the Flutter and Python Flet SDKs. Added the wakelock_plus dependency to the Flutter project, implemented the WakelockService in Dart, and exposed the Wakelock control in Python with documentation and an example. Updated documentation and navigation to include the new control.

Author: FeodorFitsner

packages/flet/lib/src/flet_core_extension.dart

@@ -118,6 +118,7 @@ import 'services/screen_brightness.dart';
 import 'services/storage_paths.dart';
 import 'services/tester.dart';
 import 'services/url_launcher.dart';
+import 'services/wakelock.dart';
 import 'services/window.dart';
 import 'utils/cupertino_icons.dart';
 import 'utils/material_icons.dart';
@@ -404,6 +405,8 @@ class FletCoreExtension extends FletExtension {
         return UserAccelerometerService(control: control);
       case "UrlLauncher":
         return UrlLauncherService(control: control);
+      case "Wakelock":
+        return WakelockService(control: control);
       default:
         return null;
     }

packages/flet/lib/src/services/wakelock.dart

@@ -0,0 +1,35 @@
+import 'package:flutter/foundation.dart';
+import 'package:wakelock_plus/wakelock_plus.dart';
+
+import '../flet_service.dart';
+
+class WakelockService extends FletService {
+  WakelockService({required super.control});
+
+  @override
+  void init() {
+    super.init();
+    debugPrint("WakelockService(${control.id}).init");
+    control.addInvokeMethodListener(_invokeMethod);
+  }
+
+  Future<dynamic> _invokeMethod(String name, dynamic args) async {
+    switch (name) {
+      case "enable":
+        return WakelockPlus.enable();
+      case "disable":
+        return WakelockPlus.disable();
+      case "is_enabled":
+        return WakelockPlus.enabled;
+      default:
+        throw Exception("Unknown Wakelock method: $name");
+    }
+  }
+
+  @override
+  void dispose() {
+    debugPrint("WakelockService(${control.id}).dispose()");
+    control.removeInvokeMethodListener(_invokeMethod);
+    super.dispose();
+  }
+}

packages/flet/pubspec.yaml

@@ -46,6 +46,7 @@ dependencies:
   web_socket_channel: ^3.0.2
   window_manager: ^0.5.1
   window_to_front: ^0.0.3
+  wakelock_plus: ^1.2.8
 
 dev_dependencies:
   flutter_test:

sdk/python/examples/controls/wakelock/basic.py

@@ -0,0 +1,39 @@
+import flet as ft
+
+
+async def main(page: ft.Page):
+    wakelock = ft.Wakelock()
+
+    status = ft.Text()
+
+    async def update_status():
+        enabled = await wakelock.is_enabled()
+        status.value = f"Wakelock enabled: {enabled}"
+
+    async def enable_lock():
+        await wakelock.enable()
+        await update_status()
+
+    async def disable_lock():
+        await wakelock.disable()
+        await update_status()
+
+    await update_status()
+
+    page.add(
+        ft.Column(
+            [
+                status,
+                ft.Row(
+                    [
+                        ft.Button("Enable wakelock", on_click=enable_lock),
+                        ft.Button("Disable wakelock", on_click=disable_lock),
+                    ],
+                    wrap=True,
+                ),
+            ],
+        )
+    )
+
+
+ft.run(main)

sdk/python/packages/flet/docs/controls/wakelock.md

@@ -0,0 +1,14 @@
+---
+class_name: flet.Wakelock
+examples: ../../examples/controls/wakelock
+---
+
+{{ class_summary(class_name) }}
+
+## Examples
+
+```python
+--8<-- "{{ examples }}/basic.py"
+```
+
+{{ class_members(class_name) }}

sdk/python/packages/flet/mkdocs.yml

@@ -464,6 +464,7 @@ nav:
           - VerticalDivider: controls/verticaldivider.md
           - Video: video/index.md
           - View: controls/view.md
+          - Wakelock: controls/wakelock.md
           - WebView: webview/index.md
           - WindowDragArea: controls/windowdragarea.md
       - CLI:

sdk/python/packages/flet/src/flet/__init__.py

@@ -447,6 +447,7 @@
 from flet.controls.services.storage_paths import StoragePaths
 from flet.controls.services.url_launcher import UrlLauncher
 from flet.controls.services.user_accelerometer import UserAccelerometer
+from flet.controls.services.wakelock import Wakelock
 from flet.controls.template_route import TemplateRoute
 from flet.controls.text_style import (
     StrutStyle,
@@ -1001,6 +1002,7 @@
     "View",
     "ViewPopEvent",
     "VisualDensity",
+    "Wakelock",
     "WebBrowserName",
     "WebDeviceInfo",
     "WebRenderer",

sdk/python/packages/flet/src/flet/controls/services/wakelock.py

@@ -0,0 +1,32 @@
+from flet.controls.base_control import control
+from flet.controls.services.service import Service
+
+__all__ = ["Wakelock"]
+
+
+@control("Wakelock")
+class Wakelock(Service):
+    """
+    Prevents the device from sleeping while enabled.
+    """
+
+    async def enable(self):
+        """
+        Keeps the device awake.
+        """
+
+        await self._invoke_method("enable")
+
+    async def disable(self):
+        """
+        Allows the device to sleep again.
+        """
+
+        await self._invoke_method("disable")
+
+    async def is_enabled(self) -> bool:
+        """
+        Returns `True` if the wakelock is currently enabled.
+        """
+
+        return await self._invoke_method("is_enabled")