Skip to content

Update "Enable Fast Compiles" to reflect Windows doesn't require installing lld. #7

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 1 commit into from
Aug 14, 2020
Merged

Update "Enable Fast Compiles" to reflect Windows doesn't require installing lld. #7

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
3 changes: 2 additions & 1 deletion content/learn/book/getting-started/setup/_index.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -71,13 +71,14 @@ Bevy can be built just fine using default configuration on stable Rust. However
* **LLD linker**: The Rust compiler spends a lot of time in the "link" step. LLD is _much faster_ at linking than the default Rust linker. To install LLD, find your OS below and run the given command:
* **Ubuntu**: `sudo apt-get install lld`
* **Arch**: `sudo pacman -S lld`
* **Windows**: `scoop install llvm` (using [scoop](https://scoop.sh/) package manager)
* **Windows**: Go to next step, Bevy's cargo config uses the Rust bundled lld
* **MacOS**: Sorry MacOS users ... modern LLD does not support MacOS. They are working on a rewrite, but it will take time. Fortunately Bevy will soon support dynamic linking of App Plugins, which will give massive iterative compile speedups and make LLD less necessary.
* **Nightly Rust Compiler**: This gives access to the latest performance improvements and "unstable" optimizations
```
rustup toolchain install nightly
rustup default nightly
```
* You can use `cargo +nightly ...` if you don't want to change the default to nightly.
* You can always switch back to stable by running: ```rustup default stable```.
* **Generic Sharing**: Allows crates to share monomorphized generic code instead of duplicating it. In some cases this allows us to "precompile" generic code so it doesn't affect iterative compiles. This is only available on nightly Rust.

Expand Down