Refactor connectivity API and add platform checks

Renamed connectivity methods and event handlers for consistency (e.g., 'check_connectivity' to 'get_connectivity', 'on_connectivity_change' to 'on_change'). Updated enum name from ConnectivityResult to ConnectivityType. Added platform support checks to sensor and service classes, raising FletUnsupportedPlatformException on unsupported platforms. Improved documentation to clarify supported platforms for each service.

Author: FeodorFitsner

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

@@ -27,7 +27,7 @@ class ConnectivityService extends FletService {
 
   Future<dynamic> _invokeMethod(String name, dynamic args) async {
     switch (name) {
-      case "check_connectivity":
+      case "get_connectivity":
         final results = await _connectivity.checkConnectivity();
         return results.map((r) => r.name).toList();
       default:
@@ -36,12 +36,12 @@ class ConnectivityService extends FletService {
   }
 
   void _updateListeners() {
-    final listenChange = control.getBool("on_connectivity_change") == true;
+    final listenChange = control.getBool("on_change") == true;
     if (listenChange && _subscription == null) {
       _subscription = _connectivity.onConnectivityChanged.listen(
           (List<ConnectivityResult> result) {
-        control.triggerEvent("connectivity_change",
-            {"connectivity": result.map((r) => r.name).toList()});
+        control.triggerEvent(
+            "change", {"connectivity": result.map((r) => r.name).toList()});
       }, onError: (error) {
         debugPrint(
             "ConnectivityService: error listening to connectivity: $error");

sdk/python/examples/services/connectivity/basic.py

@@ -8,7 +8,7 @@ async def main(page: ft.Page):
     changes = ft.Text()
 
     async def refresh(_=None):
-        results = await connectivity.check_connectivity()
+        results = await connectivity.get_connectivity()
         status.value = "Current connectivity: " + ", ".join(r.value for r in results)
 
     async def on_change(e: ft.ConnectivityChangeEvent):
@@ -17,7 +17,7 @@ async def on_change(e: ft.ConnectivityChangeEvent):
         )
         await refresh()
 
-    connectivity.on_connectivity_change = on_change
+    connectivity.on_change = on_change
 
     await refresh()
 

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

@@ -429,7 +429,7 @@
 from flet.controls.services.connectivity import (
     Connectivity,
     ConnectivityChangeEvent,
-    ConnectivityResult,
+    ConnectivityType,
 )
 from flet.controls.services.file_picker import (
     FilePicker,
@@ -666,7 +666,7 @@
     "Component",
     "Connectivity",
     "ConnectivityChangeEvent",
-    "ConnectivityResult",
+    "ConnectivityType",
     "ConstrainedControl",
     "Container",
     "Context",

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

@@ -7,6 +7,7 @@
 from flet.controls.duration import Duration
 from flet.controls.services.sensor_error_event import SensorErrorEvent
 from flet.controls.services.service import Service
+from flet.utils.platform_utils import FletUnsupportedPlatformException
 
 __all__ = ["Accelerometer", "AccelerometerReadingEvent"]
 
@@ -54,7 +55,7 @@ class Accelerometer(Service):
     Accelerometer reports zero acceleration if the device is free falling.
 
     Note:
-        * Supported platforms: Android, iOS.
+        * Supported platforms: Android, iOS and web.
         * Web ignores requested sampling intervals.
     """
 
@@ -90,3 +91,9 @@ class Accelerometer(Service):
     Fired when the platform reports a sensor error (for example when the device
     does not expose the accelerometer). `event.message` contains the error text.
     """
+
+    def before_update(self):
+        if not (self.page.web or self.page.platform.is_mobile()):
+            raise FletUnsupportedPlatformException(
+                f"{self.__class__.__name__} is only supported on Android, iOS and web."
+            )

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

@@ -5,6 +5,7 @@
 from flet.controls.base_control import control
 from flet.controls.control_event import Event, EventHandler
 from flet.controls.duration import Duration
+from flet.controls.exceptions import FletUnsupportedPlatformException
 from flet.controls.services.sensor_error_event import SensorErrorEvent
 from flet.controls.services.service import Service
 
@@ -96,3 +97,9 @@ class Barometer(Service):
     Fired when the platform reports a sensor error. `event.message` is the error
     description.
     """
+
+    def before_update(self):
+        if self.page.web or not self.page.platform.is_mobile():
+            raise FletUnsupportedPlatformException(
+                f"{self.__class__.__name__} is only supported on Android and iOS."
+            )

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

@@ -6,10 +6,10 @@
 from flet.controls.control_event import Event, EventHandler
 from flet.controls.services.service import Service
 
-__all__ = ["Connectivity", "ConnectivityChangeEvent", "ConnectivityResult"]
+__all__ = ["Connectivity", "ConnectivityChangeEvent", "ConnectivityType"]
 
 
-class ConnectivityResult(Enum):
+class ConnectivityType(Enum):
     """
     Connectivity states.
     """
@@ -48,9 +48,9 @@ class ConnectivityResult(Enum):
 class ConnectivityChangeEvent(Event["Connectivity"]):
     """Event fired when connectivity changes."""
 
-    connectivity: list[ConnectivityResult]
+    connectivity: list[ConnectivityType]
     """
-    Current connectivity state(s).
+    Current connectivity type(s).
     """
 
 
@@ -60,15 +60,15 @@ class Connectivity(Service):
     Provides device connectivity status and change notifications.
     """
 
-    on_connectivity_change: Optional[EventHandler[ConnectivityChangeEvent]] = None
+    on_change: Optional[EventHandler[ConnectivityChangeEvent]] = None
     """
     Called when connectivity changes.
     """
 
-    async def check_connectivity(self) -> list[ConnectivityResult]:
+    async def get_connectivity(self) -> list[ConnectivityType]:
         """
-        Returns the current connectivity state(s).
+        Returns the current connectivity type(s).
         """
 
-        result = await self._invoke_method("check_connectivity")
-        return [ConnectivityResult(r) for r in result]
+        result = await self._invoke_method("get_connectivity")
+        return [ConnectivityType(r) for r in result]

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

@@ -5,6 +5,7 @@
 from flet.controls.base_control import control
 from flet.controls.control_event import Event, EventHandler
 from flet.controls.duration import Duration
+from flet.controls.exceptions import FletUnsupportedPlatformException
 from flet.controls.services.sensor_error_event import SensorErrorEvent
 from flet.controls.services.service import Service
 
@@ -40,7 +41,7 @@ class Gyroscope(Service):
     reporting device rotation rate around each axis in `rad/s`.
 
     Note:
-        * Supported platforms: Android, iOS.
+        * Supported platforms: Android, iOS and web.
         * Web ignores requested sampling intervals.
     """
 
@@ -73,3 +74,9 @@ class Gyroscope(Service):
     Fired when the platform reports a sensor error. `event.message` is the error
     description.
     """
+
+    def before_update(self):
+        if not (self.page.web or self.page.platform.is_mobile()):
+            raise FletUnsupportedPlatformException(
+                f"{self.__class__.__name__} is only supported on Android, iOS and web."
+            )

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

@@ -5,6 +5,7 @@
 from flet.controls.base_control import control
 from flet.controls.control_event import Event, EventHandler
 from flet.controls.duration import Duration
+from flet.controls.exceptions import FletUnsupportedPlatformException
 from flet.controls.services.sensor_error_event import SensorErrorEvent
 from flet.controls.services.service import Service
 
@@ -48,7 +49,7 @@ class Magnetometer(Service):
 
     Note:
         * Supported platforms: Android, iOS.
-        * Magnetometer APIs are not available on web
+        * Magnetometer APIs are not available on web.
           or desktop, so always handle `on_error` to detect unsupported hardware.
     """
 
@@ -81,3 +82,9 @@ class Magnetometer(Service):
     Fired when the platform reports a sensor error. `event.message` is the error
     description.
     """
+
+    def before_update(self):
+        if self.page.web or not self.page.platform.is_mobile():
+            raise FletUnsupportedPlatformException(
+                f"{self.__class__.__name__} is only supported on Android and iOS."
+            )

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

@@ -3,6 +3,7 @@
 
 from flet.controls.base_control import control
 from flet.controls.control_event import Event, EventHandler
+from flet.controls.exceptions import FletUnsupportedPlatformException
 from flet.controls.services.service import Service
 from flet.controls.types import Number
 
@@ -125,3 +126,9 @@ async def set_auto_reset(self, auto_reset: bool):
         """
 
         await self._invoke_method("set_auto_reset", {"value": auto_reset})
+
+    def before_update(self):
+        if self.page.web or not self.page.platform.is_mobile():
+            raise FletUnsupportedPlatformException(
+                f"{self.__class__.__name__} is only supported on Android and iOS."
+            )

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

@@ -5,6 +5,7 @@
 from flet.controls.base_control import control
 from flet.controls.control_event import Event, EventHandler
 from flet.controls.duration import Duration
+from flet.controls.exceptions import FletUnsupportedPlatformException
 from flet.controls.services.sensor_error_event import SensorErrorEvent
 from flet.controls.services.service import Service
 
@@ -47,7 +48,7 @@ class UserAccelerometer(Service):
     from [`AccelerometerReadingEvent`][flet.].
 
     Note:
-        * Supported platforms: Android, iOS.
+        * Supported platforms: Android, iOS and web.
         * Web ignores requested sampling intervals.
     """
 
@@ -80,3 +81,9 @@ class UserAccelerometer(Service):
     Fired when the platform reports a sensor error. `event.message` is the error
     description.
     """
+
+    def before_update(self):
+        if not (self.page.web or self.page.platform.is_mobile()):
+            raise FletUnsupportedPlatformException(
+                f"{self.__class__.__name__} is only supported on Android, iOS and web."
+            )