lingxia 0.11.1

LingXia - Cross-platform LxApp (lightweight application) framework for Android, iOS, macOS, HarmonyOS, and Windows
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
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121

use lingxia_platform::Platform;
use lingxia_platform::traits::app_runtime::AppRuntime;
use lingxia_shell::{
    ResolvedShellActivator, ShellActivationIntent, ShellActivator, ShellError, ShellHost, ShellPin,
    ShellPinTarget, ShellResult,
};
use std::sync::Arc;

struct HostShell {
    platform: Arc<Platform>,
}

pub(crate) fn initialize(platform: Arc<Platform>) -> ShellResult<()> {
    let root = platform.app_data_dir();
    lingxia_shell::initialize(root, Arc::new(HostShell { platform }))?;
    let manager = lingxia_shell::manager()?;
    if let Some(home_appid) = lingxia_app_context::home_app_id() {
        let target = ShellPinTarget::Lxapp {
            key: home_appid.to_string(),
        };
        if let Err(error) = manager.unpin(&target) {
            log::warn!("failed to remove obsolete home lxapp Pin: {error}");
        }
    }
    let _ = lingxia_shell::apply_current_pins();
    Ok(())
}

impl ShellHost for HostShell {
    fn resolve_activators(
        &self,
        items: &[ShellActivator],
    ) -> ShellResult<Vec<ResolvedShellActivator>> {
        let owner = shell_owner();
        items
            .iter()
            .map(|item| {
                Ok(ResolvedShellActivator {
                    id: item.id.clone(),
                    label: item.label.clone(),
                    icon_path: resolve_declared_icon(owner.as_deref(), Some(&item.icon)),
                    disabled: item.disabled,
                })
            })
            .collect()
    }

    fn apply_activators(&self, items: &[ResolvedShellActivator]) -> ShellResult<()> {
        self.platform
            .set_shell_activators(items)
            .map_err(|error| ShellError::Host(error.to_string()))
    }

    fn apply_pins(&self, items: &[lingxia_shell::ShellPin]) -> ShellResult<()> {
        let visible = visible_shell_pins(items, lingxia_app_context::home_app_id());
        self.platform
            .set_shell_pins(&visible)
            .map_err(|error| ShellError::Host(error.to_string()))
    }

    fn activate(&self, intent: ShellActivationIntent) -> ShellResult<()> {
        let owner = lingxia_app_context::home_app_id().ok_or(ShellError::NotInitialized)?;
        let event = format!("lx.shell.activators:{}:{}", intent.generation, intent.id);
        lxapp::publish_app_event(owner, &event, None);
        Ok(())
    }
}

fn resolve_declared_icon(owner: Option<&lxapp::LxApp>, icon: Option<&str>) -> Option<String> {
    let icon = icon?.trim();
    if icon.is_empty() {
        return None;
    }
    let resolved = owner?.resolve_accessible_path(icon).ok()?;
    Some(resolved.to_string_lossy().into_owned())
}

pub(crate) fn visible_shell_pins(items: &[ShellPin], home_appid: Option<&str>) -> Vec<ShellPin> {
    items
        .iter()
        .filter(|pin| {
            !matches!(
                (&pin.0, home_appid),
                (ShellPinTarget::Lxapp { key }, Some(home)) if key == home
            )
        })
        .cloned()
        .collect()
}

fn shell_owner() -> Option<Arc<lxapp::LxApp>> {
    lingxia_app_context::home_app_id().and_then(lxapp::try_get)
}

#[cfg(test)]
mod tests {
    use super::*;
    use lingxia_shell::{ShellPin, ShellPinTarget};

    #[test]
    fn missing_declared_icon_stays_missing() {
        assert_eq!(resolve_declared_icon(None, None), None);
    }

    #[test]
    fn home_lxapp_is_never_applied_as_a_pin() {
        let pins = vec![
            ShellPin(ShellPinTarget::Lxapp {
                key: "home".to_string(),
            }),
            ShellPin(ShellPinTarget::Lxapp {
                key: "chat".to_string(),
            }),
            ShellPin(ShellPinTarget::Bookmark {
                key: "bookmark".to_string(),
            }),
        ];

        assert_eq!(visible_shell_pins(&pins, Some("home")), pins[1..]);
    }
}