lingxia-platform 0.6.3

Platform abstraction layer for LingXia framework (Android, iOS, HarmonyOS)
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102

use crate::error::PlatformError;
use crate::traits::wifi::{Wifi, WifiConnectRequest, WifiGetConnectedRequest};

use super::Platform;

#[cfg(any(target_os = "ios", target_os = "macos"))]
use super::ffi;

#[cfg(not(any(target_os = "ios", target_os = "macos")))]
fn wifi_api_not_supported_error(api: &str) -> PlatformError {
    PlatformError::NotSupported(format!(
        "WiFi capability `{}` is not supported by Apple platform module on this target. Supported targets: `ios`, `macos`.",
        api
    ))
}

// Macro to reduce cfg block duplication for Apple-only functions
macro_rules! apple_only {
    ($api:expr, $callback_id:ident, $ffi_call:expr) => {{
        #[cfg(any(target_os = "ios", target_os = "macos"))]
        {
            $ffi_call;
            Ok(())
        }
        #[cfg(not(any(target_os = "ios", target_os = "macos")))]
        {
            let _ = $callback_id;
            Err(wifi_api_not_supported_error($api))
        }
    }};
}

impl Wifi for Platform {
    fn start_wifi(&self, callback_id: u64) -> Result<(), PlatformError> {
        apple_only!("start_wifi", callback_id, ffi::start_wifi(callback_id))
    }

    fn stop_wifi(&self, callback_id: u64) -> Result<(), PlatformError> {
        apple_only!("stop_wifi", callback_id, ffi::stop_wifi(callback_id))
    }

    fn connect_wifi(&self, request: WifiConnectRequest) -> Result<(), PlatformError> {
        #[cfg(any(target_os = "ios", target_os = "macos"))]
        {
            ffi::connect_wifi(
                request.callback_id,
                &request.ssid,
                request.password.as_deref(),
            );
            Ok(())
        }
        #[cfg(not(any(target_os = "ios", target_os = "macos")))]
        {
            let _ = request;
            Err(wifi_api_not_supported_error("connect_wifi"))
        }
    }

    fn get_wifi_list(&self, callback_id: u64) -> Result<(), PlatformError> {
        apple_only!(
            "get_wifi_list",
            callback_id,
            ffi::get_wifi_list(callback_id)
        )
    }

    fn get_connected_wifi(&self, request: WifiGetConnectedRequest) -> Result<(), PlatformError> {
        let callback_id = request.callback_id;
        apple_only!(
            "get_connected_wifi",
            callback_id,
            ffi::get_connected_wifi(callback_id)
        )
    }

    fn is_wifi_enabled(&self) -> Result<bool, PlatformError> {
        #[cfg(any(target_os = "ios", target_os = "macos"))]
        {
            Ok(ffi::is_wifi_enabled())
        }
        #[cfg(not(any(target_os = "ios", target_os = "macos")))]
        {
            Err(wifi_api_not_supported_error("is_wifi_enabled"))
        }
    }

    fn add_wifi_state_listener(&self, callback_id: u64) -> Result<(), PlatformError> {
        apple_only!(
            "add_wifi_state_listener",
            callback_id,
            ffi::add_wifi_state_listener(callback_id)
        )
    }

    fn remove_wifi_state_listener(&self, callback_id: u64) -> Result<(), PlatformError> {
        apple_only!(
            "remove_wifi_state_listener",
            callback_id,
            ffi::remove_wifi_state_listener(callback_id)
        )
    }
}