|
| 1 | +--- |
| 2 | +layout: post |
| 3 | +title: "Announcing Rustup 1.28.0" |
| 4 | +author: The Rustup Team |
| 5 | +--- |
| 6 | + |
| 7 | +The rustup team is happy to announce the release of rustup version 1.28.0. |
| 8 | +[Rustup][install] is the recommended tool to install [Rust][rust], a programming language that is empowering everyone to build reliable and efficient software. |
| 9 | + |
| 10 | +If you have a previous version of rustup installed, getting rustup 1.28.0 is as easy as stopping any programs which may be using Rustup (e.g. closing your IDE) and running: |
| 11 | + |
| 12 | +```console |
| 13 | +$ rustup self update |
| 14 | +``` |
| 15 | + |
| 16 | +Rustup will also automatically update itself at the end of a normal toolchain update: |
| 17 | + |
| 18 | +```console |
| 19 | +$ rustup update |
| 20 | +``` |
| 21 | + |
| 22 | +If you don't have it already, you can [get rustup][install] from the appropriate page on our website. |
| 23 | + |
| 24 | +[rust]: https://www.rust-lang.org |
| 25 | +[install]: https://rustup.rs |
| 26 | + |
| 27 | +## What's new in rustup 1.28.0 |
| 28 | + |
| 29 | +This new release of rustup has been a long time in the making and comes with substantial changes. |
| 30 | + |
| 31 | +Before digging into the details, it is worth mentioning that [Chris Denton](https://github.com/chrisdenton) has joined the team. |
| 32 | +Chris has a lot of experience contributing to Windows-related parts of the Rust Project, expertise which was sorely lacking in existing team members, so we're happy to have him on board to help address Windows-specific issues. |
| 33 | + |
| 34 | +The following improvements might require changes to how you use rustup: |
| 35 | + |
| 36 | +- rustup will no longer automatically install the active toolchain if it is not installed. |
| 37 | + |
| 38 | + - To ensure its installation, run `rustup toolchain install` with no arguments. |
| 39 | + - The following command installs the active toolchain both before and after this change: |
| 40 | + ```sh |
| 41 | + rustup show active-toolchain || rustup toolchain install |
| 42 | + # Or, on older versions of PowerShell: |
| 43 | + rustup show active-toolchain; if ($LASTEXITCODE -ne 0) { rustup toolchain install } |
| 44 | + ``` |
| 45 | +
|
| 46 | +- Installing a host-incompatible toolchain via `rustup toolchain install` or `rustup default` will |
| 47 | + now be rejected unless you explicitly add the `--force-non-host` flag. |
| 48 | +
|
| 49 | +Rustup now officially supports the following host platforms: |
| 50 | +
|
| 51 | +- `aarch64-pc-windows-msvc` |
| 52 | +- `loongarch64-unknown-linux-musl` |
| 53 | +
|
| 54 | +This release also comes with various quality-of-life improvements, to name a few: |
| 55 | +
|
| 56 | +- `rustup show`'s output format has been cleaned up, making it easier to find out about your toolchains' status. |
| 57 | +- `rustup doc` now accepts a flag and a topic at the same time, enabling quick navigation to specific parts of more books. |
| 58 | +- rustup's `remove` subcommands now support more aliases such as `rm` and `del`. |
| 59 | +- Basic support for nushell has been added. |
| 60 | +
|
| 61 | +We have additionally made the following internal changes: |
| 62 | +
|
| 63 | +- The default download backend has been changed from reqwest with native-tls to reqwest with rustls. |
| 64 | + - `RUSTUP_USE_CURL` and `RUSTUP_USE_RUSTLS` can still be used to change the download backend |
| 65 | + if the new backend causes issues. If issues do happen, please [let us know](https://github.com/rust-lang/rustup/issues/3806). |
| 66 | + - The default backend now uses rustls-platform-verifier to verify server certificates, taking |
| 67 | + advantage of the platform's certificate store on platforms that support it. |
| 68 | +- When creating proxy links, rustup will now try symlinks first and fall back to hardlinks, |
| 69 | + as opposed to trying hardlinks first. |
| 70 | +- A new `RUSTUP_LOG` environment variable can be used to control tracing-based logging in |
| 71 | + rustup binaries. See the [dev guide](https://rust-lang.github.io/rustup/dev-guide/tracing.html) for more details. |
| 72 | +
|
| 73 | +Finally, there are some notable changes to our [official website][install] as well: |
| 74 | +
|
| 75 | +- The overall design of the website has been updated to better align with the Rust Project's branding. |
| 76 | +- It is now possible to download the prebuilt `rustup-init.sh` installer for the `aarch64-pc-windows-msvc` host platform via https://win.rustup.rs/aarch64. |
| 77 | +
|
| 78 | +Further details are available in the [changelog]! |
| 79 | +
|
| 80 | +Rustup's documentation is also available in [the rustup book][book]. |
| 81 | +
|
| 82 | +[other installation methods]: https://rust-lang.github.io/rustup/installation/other.html |
| 83 | +[changelog]: https://github.com/rust-lang/rustup/blob/stable/CHANGELOG.md |
| 84 | +[book]: https://rust-lang.github.io/rustup/ |
| 85 | +
|
| 86 | +## Thanks |
| 87 | +
|
| 88 | +Thanks again to all the contributors who made rustup 1.28.0 possible! |
| 89 | +
|
| 90 | +- Alovchin91 (Alovchin91) |
| 91 | +- Chris Denton (ChrisDenton) |
| 92 | +- Fabio Valentini (decathorpe) |
| 93 | +- Dirkjan Ochtman (djc) |
| 94 | +- Daniel Paoliello (dpaoliello) |
| 95 | +- hev (heiher) |
| 96 | +- Yue Fei (InfyniteHeap) |
| 97 | +- Jan David (jdno) |
| 98 | +- Josh Triplett (joshtriplett) |
| 99 | +- Josh Yu-Hang Hsieh (jtr860830) |
| 100 | +- Kenny Kerr (kennykerr) |
| 101 | +- klensy (klensy) |
| 102 | +- Jakub Beránek (Kobzol) |
| 103 | +- Kyle Leonhard (kyle-leonhard) |
| 104 | +- 简 (LittleJianCH) |
| 105 | +- Luca Casonato (lucacasonato) |
| 106 | +- Meriel Luna Mittelbach (LunarLambda) |
| 107 | +- Matt Harding (majaha) |
| 108 | +- rami3l (rami3l) |
| 109 | +- Robert Collins (rbtcollins) |
| 110 | +- roife (roife) |
| 111 | +- Rustin (Rustin170506) |
| 112 | +- Mihir Gadgil (scimas) |
| 113 | +- Bennet Bleßmann (Skgland) |
| 114 | +- Samuel Moelius (smoelius) |
| 115 | +- taylor.fish (taylordotfish) |
| 116 | +- Tim Hutt (Timmmm) |
| 117 | +- Lorenzo Zabot (Uaitt) |
| 118 | +- Victor LEFEBVRE (vic1707) |
| 119 | +- Xerxes-2 (Xerxes-2) |
| 120 | +- Renovate Bot (renovate) |
0 commit comments