Visão geral

rustup é o instalador e gerenciador de ferramentas oficial para a linguagem de programação Rust. Ele fornece uma maneira conveniente de instalar, atualizar e gerenciar múltiplas ferramentas Rust em seu sistema. Este relatório abordará o processo de instalação para várias plataformas, o uso básico do rustup e fornecerá um exemplo de gerenciamento de múltiplos ambientes Rust.

Instalação

macOS e Linux

Para instalar rustup em sistemas macOS e Linux, abra o terminal e digite o seguinte comando:

curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

O script irá baixar e instalar os componentes necessários. Uma vez concluído, reinicie o terminal ou execute o seguinte comando para atualizar as variáveis de ambiente do shell:

source $HOME/.cargo/env

Windows

Para usuários do Windows, baixe e execute o arquivo executável rustup-init.exe no site oficial do Rust. Siga as instruções na tela para concluir a instalação. Após a instalação, reinicie o prompt de comando ou o terminal.

Uso

Instalando uma versão específica do Rust

Para instalar uma versão específica do Rust, use o seguinte comando:

rustup install <versão>

Substitua <versão> pela versão do Rust desejada, por exemplo, 1.52.0.

Definindo a versão padrão do Rust

Para definir a versão padrão do Rust para novos projetos, use o seguinte comando:

rustup default <versão>

Substitua <versão> pela versão do Rust desejada, por exemplo, 1.52.0.

Alternando entre versões do Rust

Para alternar entre diferentes versões do Rust para um projeto específico, navegue até o diretório do projeto e use o seguinte comando:

rustup override set <versão>

Substitua <versão> pela versão do Rust desejada, por exemplo, 1.52.0.

Atualizando o Rust

Para atualizar todas as ferramentas Rust instaladas para suas versões mais recentes, execute o seguinte comando:

rustup update

Desinstalando o Rust

Para desinstalar o Rust e o rustup do seu sistema, execute o seguinte comando:

rustup self uninstall

Exemplo

Suponha que você esteja trabalhando em dois projetos Rust: project_old e project_new. project_old requer a versão 1.52.0 do Rust, enquanto project_new requer a última versão estável.

Primeiro, instale as versões do Rust necessárias:

rustup install 1.52.0
rustup install stable

Em seguida, navegue até o diretório project_old e defina a versão do Rust para o projeto:

cd project_old
rustup override set 1.52.0

Agora, navegue até o diretório project_new e defina a versão do Rust para o projeto:

cd project_new
rustup override set stable

Com essas configurações, cada projeto usará a versão apropriada do Rust quando você construí-lo ou executá-lo.

Por exemplo, quando você executa cargo build ou cargo run no diretório project_old, o Rust 1.52.0 será usado:

cd project_old
cargo build

Da mesma forma, quando você executa cargo build ou cargo run no diretório project_new, a versão mais recente estável do Rust será usada:

cd project_new
cargo build

Com o rustup, você pode trabalhar sem problemas em vários projetos com diferentes requisitos de versão do Rust sem conflitos ou intervenção manual.

Conclusão

O rustup é uma ferramenta essencial para desenvolvedores Rust, pois simplifica o processo de gerenciamento de múltiplos ambientes Rust em um único sistema. Este relatório cobriu o processo de instalação para várias plataformas, o uso básico e forneceu um exemplo de gerenciamento de diferentes versões do Rust para vários projetos. Ao usar o rustup, os desenvolvedores podem garantir que seus projetos sejam sempre construídos e executados usando a versão correta do Rust, melhorando a produtividade e reduzindo a probabilidade de problemas relacionados à versão.