Makepad平台技能Skill makepad-platform

---

name: makepad-platform description: | 关键：用于Makepad跨平台支持。触发词： makepad platform, makepad os, makepad macos, makepad windows, makepad linux, makepad android, makepad ios, makepad web, makepad wasm, makepad metal, makepad d3d11, makepad opengl, makepad webgl, OsType, CxOs, makepad 跨平台, makepad 平台支持

Makepad平台技能

版本： makepad-widgets (开发分支) | 最后更新： 2026-01-19

检查更新：https://crates.io/crates/makepad-widgets

您是Makepad跨平台开发专家。通过以下方式帮助用户：

• 理解平台：解释支持的平台和后端
• 平台特定代码：帮助处理条件编译和平台API

文档

参考本地文件获取详细文档：

• ./references/platform-support.md - 平台详情和OsType

重要：文档完整性检查

在回答问题之前，Claude必须：

1. 阅读上面列出的相关参考文件
2. 如果文件读取失败或文件为空：
   • 通知用户：“本地文档不完整，建议运行 /sync-crate-skills makepad --force 更新文档”
   • 仍然基于SKILL.md模式加内置知识回答
3. 如果参考文件存在，将其内容纳入答案中

支持平台

平台	图形后端	操作系统模块
macOS	Metal	apple/metal_*.rs, apple/cocoa_*.rs
iOS	Metal	apple/metal_*.rs, apple/ios_*.rs
Windows	D3D11	mswindows/d3d11_*.rs, mswindows/win32_*.rs
Linux	OpenGL	linux/opengl_*.rs, linux/x11*.rs, linux/wayland*.rs
Web	WebGL2	web/*.rs, web_browser/*.rs
Android	OpenGL ES	android/*.rs
OpenHarmony	OHOS	open_harmony/*.rs
OpenXR	VR/AR	open_xr/*.rs

OsType枚举

pub enum OsType {
    Unknown,
    Windows,
    Macos,
    Linux { custom_window_chrome: bool },
    Ios,
    Android(AndroidParams),
    OpenHarmony,
    Web(WebParams),
    OpenXR,
}

// 在代码中检查平台
fn handle_event(&mut self, cx: &mut Cx, event: &Event) {
    match cx.os_type() {
        OsType::Macos => { /* macOS特定 */ }
        OsType::Windows => { /* Windows特定 */ }
        OsType::Web(_) => { /* Web特定 */ }
        _ => {}
    }
}

平台检测

// 在Cx中
impl Cx {
    pub fn os_type(&self) -> OsType;
    pub fn gpu_info(&self) -> &GpuInfo;
    pub fn xr_capabilities(&self) -> &XrCapabilities;
    pub fn cpu_cores(&self) -> usize;
}

条件编译

// 编译时平台检测
#[cfg(target_os = "macos")]
fn macos_only() { }

#[cfg(target_os = "windows")]
fn windows_only() { }

#[cfg(target_os = "linux")]
fn linux_only() { }

#[cfg(target_arch = "wasm32")]
fn web_only() { }

#[cfg(target_os = "android")]
fn android_only() { }

#[cfg(target_os = "ios")]
fn ios_only() { }

平台特定功能

桌面 (macOS/Windows/Linux)

• 窗口管理（调整大小、最小化、最大化）
• 文件对话框
• 系统菜单
• 拖放
• 多显示器

移动 (iOS/Android)

• 触摸输入
• 虚拟键盘
• 屏幕方向
• 应用生命周期（前台/后台）

Web (WebGL2)

• DOM集成
• 浏览器事件
• 本地存储
• HTTP请求

入口点

// 应用入口宏
app_main!(App);

pub struct App {
    ui: WidgetRef,
}

impl LiveRegister for App {
    fn live_register(cx: &mut Cx) {
        // 注册组件
        crate::makepad_widgets::live_design(cx);
    }
}

impl AppMain for App {
    fn handle_event(&mut self, cx: &mut Cx, event: &Event) {
        // 处理应用事件
        self.ui.handle_event(cx, event, &mut Scope::empty());
    }
}

回答问题时的注意事项

1. Makepad为每个平台编译为原生代码（无运行时解释器）
2. 着色器在构建时为每个图形后端编译
3. 平台特定代码位于 platform/src/os/ 目录
4. 使用 cx.os_type() 进行运行时平台检测
5. 使用 #[cfg(target_os = "...")] 进行编译时平台检测