Managing Thunderbird’s Cargo workspace

Thunderbird now builds gkrust as its own library, using gkrust-shared from mozilla-central to allow us to add our own Rust crates and components.

Note, however, this is a slightly odd arrangement as Cargo doesn’t support using workspaces within the parent directory. As a result, we must keep track of the first-level dependencies of our crates (i.e. shallow transitive).

Updating dependencies

To update the version of all dependencies in the workspace, run:

./mach tb-rust sync

This command reads the dependencies from the Cargo workspace in mozilla-central, adds any dependencies specific to Thunderbird, and regenerates comm/rust/Cargo.toml and comm/rust/Cargo.lock accordingly.

Sync the vendored dependencies

When crate dependencies change, we need to synchronize the dependencies. This is done to support use from the root of mozilla-central and account for all crate dependencies.

./mach tb-rust vendor

Note

Under the hood, this command runs ./mach tb-rust sync to ensure the workspace’s dependencies are up to date, then completely recreates comm/rust/.cargo/config.toml.in and comm/third_party/rust/.

Do not directly modify comm/rust/.cargo/*!