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

[dependencies]
winit = "0.24.0"

文档

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

有关winit范围之外的功能，请参阅维基中的 其他crate提供的功能。

联系我们

在以下任何一种方式加入我们

用法

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

Winit被设计为库层次结构中的底层砖块。因此，为了在窗口上显示内容，您需要使用winit提供的特定平台的getter或其他库。

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后端进行编译

特定平台的使用

WebAssembly

Winit支持使用 wasm32-unknown-unknown 目标进行编译，可以使用 stdweb 或 web-sys 后端在Web浏览器中使用。但是请注意，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的链接。