mirror of
https://github.com/google/comprehensive-rust.git
synced 2025-05-15 07:06:52 +02:00
7f469fb2c7
This is a contribution of a Chromium section for Comprehensive Rust. --------- Co-authored-by: Nicole L <dlegare.1001@gmail.com> Co-authored-by: Martin Geisler <martin@geisler.net>
25 lines
834 B
Markdown
25 lines
834 B
Markdown
# Generating `gn` build rules
|
|
|
|
Once you've downloaded the crate, generate the `BUILD.gn` files like this:
|
|
|
|
```shell
|
|
vpython3 tools/crates/run_gnrt.py -- gen
|
|
```
|
|
|
|
Now run `git status`. You should find:
|
|
|
|
* At least one new crate source code in `third_party/rust/chromium_crates_io/vendor`
|
|
* At least one new `BUILD.gn` in `third_party/rust/<crate name>/v<major semver version>`
|
|
* An appropriate `README.chromium`
|
|
|
|
The "major semver version" is a [Rust "semver" version number][0].
|
|
|
|
Take a close look, especially at the things generated in `third_party/rust`.
|
|
|
|
<details>
|
|
Talk a little about semver - and specifically the way that in Chromium
|
|
it's to allow multiple incompatible versions of a crate, which is discouraged
|
|
but sometimes necessary in the cargo ecosystem.
|
|
</detail>
|
|
|
|
[0]: https://doc.rust-lang.org/cargo/reference/semver.html |