winit - 在 Rust 中进行跨平台窗口创建和管理

[dependencies]
winit = "0.24.0"

文档

有关 winit 作用域内的功能，请参阅 FEATURES.md。

有关 winit 作用域外的功能，请参阅维基中的 其他工具包提供的功能缺失。

联系我们

加入以下之一

用法

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

平台特定使用

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的链接。