YSU
构建与使用

准备环境

一个 Rust 工具链,外加一个 C 编译器和 CMake。

内核是单个 Rust crate,没有工作区,也没有别的语言。

Rust

1.98.1。 工具链由仓库根的 rust-toolchain.toml 钉住:

[toolchain]
channel = "1.98.1"
components = ["rustfmt", "clippy"]

Cargo.toml 里写的 rust-version = "1.98" 是同一个下限。装了 rustup 的话,进到仓库目录就自动切到 1.98.1,不用手动装。

一个 C 编译器和 CMake

这条容易漏:仓库是纯 Rust 的,但 TLS 走 rustls,它的密码学后端是 aws-lc-rs,里面有一大坨 C 代码要编。Cargo.lock 里能查到 aws-lc-rs 与 aws-lc-sys 两条。

所以即使只构建内核,也需要:

  • 一个 C 编译器,GCC 或 Clang 都行
  • cmake

Debian 系装 build-essential 与 cmake,Fedora 系装 gcc gcc-c++ make cmake。少了它们,构建会停在一个看起来跟网络毫无关系的依赖上——错误信息里出现 aws-lc-sys、cmake 或 cc1 就是这个原因。

图形适配器

渲染层用 wgpu。要真的跑出像素,机器上得有一个找得到的图形适配器,Linux 上通常是 mesa-vulkan-drivers 或厂商驱动。

不需要窗口。examples/render_headless.rs 自己建 GPU 设备、渲到纹理、把像素读回来核对,在没有显示服务的机器上也能跑。

依赖

运行期只有六个:

依赖干什么
url地址解析
encoding_rs字符集解码
cosmic-text文本整形与栅格化
wgpuGPU 接口
rustlsTLS
webpki-roots根证书

开发依赖一个:pollster,用来在例子里同步等 GPU 的异步调用。

除此之外的每一层——HTML 词法与树构建、CSS 词法与选择器、层叠、布局、绘制、HTTP 客户端——都是仓库自己的代码。

平台

只在 Linux x86_64 上验证过。依赖都是跨平台的,代码里没有 cfg(target_os) 分支,但别的平台上没有实测过。

On this page