Skip to content

Commit 77cce1c

Browse files
authored
Add warning about 0.16.x and earlier examples in quick start guide (#2244)
1 parent 40d4723 commit 77cce1c

File tree

1 file changed

+8
-0
lines changed
  • content/learn/quick-start/getting-started

1 file changed

+8
-0
lines changed

content/learn/quick-start/getting-started/_index.md

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -49,6 +49,14 @@ You can also speed up compile times by following the ["fast compiles"] section.
4949
cargo run --example breakout
5050
```
5151

52+
{% callout(type="warning") %}
53+
When using Rust `1.89+` and Bevy `0.16.x or earlier` the examples will not run and instead error. For more info on *why* see the issue: [bevyengine/bevy#20475 "0.16 fails to build breakout example due to bevy_mikktspace not compiling on Rust 1.89"](<https://github.com/bevyengine/bevy/issues/20475>)
54+
55+
Some workarounds:
56+
- Use Rust 1.88 or earlier using this command: `rustup default 1.88.0`
57+
- Use Rust 1.88 *only* in your Bevy Engine directory using this command: `rustup override set 1.88` (See https://rust-lang.github.io/rustup/overrides.html#directory-overrides for more on this)
58+
{% end %}
59+
5260
### Add Bevy as a Dependency
5361

5462
Bevy is [available as a library on crates.io](https://crates.io/crates/bevy).

0 commit comments

Comments
 (0)