8 添加第三方 Crate on 编程那些事儿

8.1 配置 Cargo.toml

Tue, 11 Aug 2026 11:30:00 +0800

译文 · 基于 Comprehensive Rust

原文链接: https://google.github.io/comprehensive-rust/chromium/adding-third-party-crates/configuring-cargo-toml.html

8.1 配置 Cargo.toml

Chromium 有一组集中管理的直接 crate 依赖。它们通过单个 Cargo.toml 管理：

1
2
3
4
5


[dependencies]
bitflags = "1"
cfg-if = "1"
cxx = "1"
# 还有很多……

与任何其他 Cargo.toml 一样，你可以指定更多依赖细节——通常，你会想指定希望在 crate 中启用的 features。

8.2 配置 `gnrt_config.toml`

Tue, 11 Aug 2026 11:30:00 +0800

译文 · 基于 Comprehensive Rust

原文链接: https://google.github.io/comprehensive-rust/chromium/adding-third-party-crates/configuring-gnrt-config-toml.html

8.2 配置 `gnrt_config.toml`

与 Cargo.toml 并列的是 gnrt_config.toml。它包含 Chromium 特有的 crate 处理扩展。

若你添加新 crate，至少应指定 group。它是以下之一：

1
2
3
4


# 'safe': 该库满足 rule-of-2，可在任何进程中使用。
# 'sandbox': 该库不满足 rule-of-2，必须在沙箱进程中使用，
# 例如渲染器或 utility 进程。
# 'test': 该库仅用于测试。

例如，

8.3 下载 Crate

Tue, 11 Aug 2026 11:30:00 +0800

译文 · 基于 Comprehensive Rust

原文链接: https://google.github.io/comprehensive-rust/chromium/adding-third-party-crates/downloading-crates.html

8.3 下载 Crate

名为 gnrt 的工具知道如何下载 crate 以及如何生成 BUILD.gn 规则。

首先，像这样下载你想要的 crate：

1
2


cd chromium/src
vpython3 tools/crates/run_gnrt.py -- vendor

虽然 gnrt 工具是 Chromium 源码的一部分，但运行此命令会从 crates.io 下载并运行其依赖。见前面讨论这一安全决策的章节。

8.4 生成 `gn` 构建规则

Tue, 11 Aug 2026 11:30:00 +0800

译文 · 基于 Comprehensive Rust

原文链接: https://google.github.io/comprehensive-rust/chromium/adding-third-party-crates/generating-gn-build-rules.html

8.4 生成 `gn` 构建规则

下载 crate 后，像这样生成 BUILD.gn 文件：

1

vpython3 tools/crates/run_gnrt.py -- gen

现在运行 git status。你应会发现：

在 third_party/rust/chromium_crates_io/vendor 中至少有一个新的 crate 源码
在 third_party/rust/<crate name>/v<major semver version> 中至少有一个新的 BUILD.gn
一个合适的 README.chromium

“major semver version” 是一个 Rust “semver” 版本号。

8.6 依赖一个 Crate

Tue, 11 Aug 2026 11:30:00 +0800

译文 · 基于 Comprehensive Rust

原文链接: https://google.github.io/comprehensive-rust/chromium/adding-third-party-crates/depending-on-a-crate.html

8.6 依赖一个 Crate

一旦你添加了第三方 crate 并生成了构建规则，依赖一个 crate 就很简单。找到你的 rust_static_library 目标，并添加对你的 crate 内 :lib 目标的 dep。

具体来说，

8.7 审查与审计

Tue, 11 Aug 2026 11:30:00 +0800

译文 · 基于 Comprehensive Rust

原文链接: https://google.github.io/comprehensive-rust/chromium/adding-third-party-crates/reviews-and-audits.html

8.7 审查与审计

添加新库须遵守 Chromium 的标准策略，当然也须经过安全审查。由于你可能带来的不只是单个 crate，还有传递依赖，可能有大量代码需要审查。另一方面，安全的 Rust 代码负面副作用可能有限。你应如何审查它？

8.8 检入 Chromium 源码

Tue, 11 Aug 2026 11:30:00 +0800

译文 · 基于 Comprehensive Rust

原文链接: https://google.github.io/comprehensive-rust/chromium/adding-third-party-crates/checking-in.html

8.8 检入 Chromium 源码

git status 应会显示：

//third_party/rust/chromium_crates_io 中的 crate 代码
//third_party/rust/<crate>/<version> 中的元数据（BUILD.gn 与 README.chromium）

请也在后一位置添加一个 OWNERS 文件。

8.9 保持 Crate 更新

Tue, 11 Aug 2026 11:30:00 +0800

译文 · 基于 Comprehensive Rust

原文链接: https://google.github.io/comprehensive-rust/chromium/adding-third-party-crates/keeping-up-to-date.html

8.9 保持 Crate 更新

作为任何第三方 Chromium 依赖的 OWNER，你被要求用任何安全修复保持其更新。希望我们很快能为 Rust crate 自动化这一点，但目前，这仍是你的责任，就像对任何其他第三方依赖一样。

8.10 练习

Tue, 11 Aug 2026 11:30:00 +0800

译文 · 基于 Comprehensive Rust

原文链接: https://google.github.io/comprehensive-rust/exercises/chromium/third-party.html

8.10 练习

把 uwuify 加到 Chromium，并关闭该 crate 的默认 features。假设该 crate 将用于发布版 Chromium，但不会用于处理不可信输入。

8 添加第三方 Crate on 编程那些事儿

8.1 配置 Cargo.toml

8.1 配置 Cargo.toml

8.2 配置 `gnrt_config.toml`

8.2 配置 gnrt_config.toml

8.3 下载 Crate

8.3 下载 Crate

8.4 生成 `gn` 构建规则

8.4 生成 gn 构建规则

8.6 依赖一个 Crate

8.6 依赖一个 Crate

8.7 审查与审计

8.7 审查与审计

8.8 检入 Chromium 源码

8.8 检入 Chromium 源码

8.9 保持 Crate 更新

8.9 保持 Crate 更新

8.10 练习

8.10 练习

8.2 配置 `gnrt_config.toml`

8.4 生成 `gn` 构建规则