mirror of
https://github.com/bevyengine/bevy
synced 2024-12-24 12:03:14 +00:00
99449931d2
# Objective It is unclear how to run Bevy's benchmarks ## Solution Add a README to the benches, with documentation that tells you what the benchmarks are, and how to run them. --------- Co-authored-by: Rob Parrett <robparrett@gmail.com>
28 lines
969 B
Markdown
28 lines
969 B
Markdown
# Bevy Benchmarks
|
|
|
|
This is a crate with a collection of benchmarks for Bevy, separate from the rest of the Bevy crates.
|
|
|
|
## Running the benchmarks
|
|
|
|
1. Setup everything you need for Bevy with the [setup guide](https://bevyengine.org/learn/book/getting-started/setup/).
|
|
2. Move into the `benches` directory (where this README is located).
|
|
|
|
```sh
|
|
bevy $ cd benches
|
|
```
|
|
|
|
3. Run the benchmarks with cargo (This will take a while)
|
|
|
|
```sh
|
|
bevy/benches $ cargo bench
|
|
```
|
|
|
|
If you'd like to only compile the benchmarks (without running them), you can do that like this:
|
|
|
|
```sh
|
|
bevy/benches $ cargo bench --no-run
|
|
```
|
|
|
|
## Criterion
|
|
|
|
Bevy's benchmarks use [Criterion](https://crates.io/crates/criterion). If you want to learn more about using Criterion for comparing performance against a baseline or generating detailed reports, you can read the [Criterion.rs documentation](https://bheisler.github.io/criterion.rs/book/criterion_rs.html).
|