winit - Rust 中的跨平台窗口创建和管理

[dependencies]
winit = "0.24.0"

文档

关于 winit 范围内的功能，请参阅 FEATURES.md。

关于 winit 范围外的功能，请参阅维基上的 其他 crate 提供的功能缺失。

联系我们

在这些中任何一个加入我们

使用方法

Winit 是一个窗口创建和管理库。它可以创建窗口，并允许您处理窗口（例如：窗口大小调整、按键、鼠标移动等）产生的事件。

Winit 被设计成一个库层次结构中的底层砖块。因此，为了在窗口上显示内容，您需要使用 winit 提供的特定于平台的获取器，或另一个库。

use winit::{
    event::{Event, WindowEvent},
    event_loop::{ControlFlow, EventLoop},
    window::WindowBuilder,
};

fn main() {
    let event_loop = EventLoop::new();
    let window = WindowBuilder::new().build(&event_loop).unwrap();

    event_loop.run(move |event, _, control_flow| {
        *control_flow = ControlFlow::Wait;

        match event {
            Event::WindowEvent {
                event: WindowEvent::CloseRequested,
                window_id,
            } if window_id == window.id() => *control_flow = ControlFlow::Exit,
            _ => (),
        }
    });
}

Winit 仅官方支持 Rust 编译器的最新稳定版本。

Cargo 特性

Winit 提供以下特性，您可以在 Cargo.toml 文件中启用这些特性

• serde: 使用 Serde 启用某些类型的序列化/反序列化。
• x11（默认启用）：在 Unix 平台上，使用 X11 后端进行编译
• wayland（默认启用）：在 Unix 平台上，使用 Wayland 后端进行编译
• mint: 启用 mint（数学互操作性标准类型）转换。

平台特定使用

WebAssembly

Winit 支持wasm32-unknown-unknown目标的编译，使用 stdweb 或 web-sys 后端，用于在网页浏览器上使用。但是，请注意，stdweb 后端正在被弃用，可能在 Winit 的未来版本中删除。 web-sys 后端也功能更完善。

在Web平台中，Winit窗口由一个<canvas>元素支持。您可以提供Winit一个<canvas>元素，或者让Winit创建一个<canvas>元素，然后您可以从DOM中检索并插入它。

有关使用Winit和WebAssembly的示例代码，请参阅Web示例。有关在WebAssembly上使用Rust的信息，请参阅Rust和WebAssembly书籍。

Android

这个库使用了ndk-rs包，更多文档请参阅该仓库。

在Android设备上运行需要动态系统库，将其添加到Cargo.toml中

[[example]]
name = "request_redraw_threaded"
crate-type = ["cdylib"]

并将以下内容添加到示例文件中，以添加原生活动粘合剂

#[cfg_attr(target_os = "android", ndk_glue::main(backtrace = "on"))]
fn main() {
    ...
}

然后使用以下命令运行应用程序：cargo apk run --example request_redraw_threaded

MacOS

为了确保与较旧的MacOS系统的兼容性，winit通过CoreGraphics框架链接到CGDisplayCreateUUIDFromDisplayID。然而，在某些设置下，此函数仅可通过较新的ColorSync框架进行链接。因此，winit提供了一个WINIT_LINK_COLORSYNC环境变量，可以在编译时将其设置为1或true以启用通过ColorSync的链接。