Guia de Instalação do Rust

Introdução

Bem-vindo(a) à Instalação. Este laboratório faz parte do Livro de Rust. Você pode praticar suas habilidades em Rust no LabEx.

Neste laboratório, você precisará instalar o Rust usando o rustup, uma ferramenta de linha de comando para gerenciar versões do Rust e ferramentas associadas, fazendo o download através de uma conexão com a internet.

Instalação

O primeiro passo é instalar o Rust. Faremos o download do Rust através do rustup, uma ferramenta de linha de comando para gerenciar versões do Rust e ferramentas associadas. Você precisará de uma conexão com a internet para o download.

Nota: Se você preferir não usar o rustup por algum motivo, consulte a página Outros Métodos de Instalação do Rust em https://forge.rust-lang.org/infra/other-installation-methods.html para mais opções.

Os passos a seguir instalam a versão estável mais recente do compilador Rust. As garantias de estabilidade do Rust garantem que todos os exemplos do livro que compilam continuarão a compilar com versões mais recentes do Rust. A saída pode diferir ligeiramente entre as versões porque o Rust frequentemente melhora as mensagens de erro e avisos. Em outras palavras, qualquer versão estável mais recente do Rust que você instalar usando estes passos deve funcionar como esperado com o conteúdo deste livro.

Notação da Linha de Comando

Neste capítulo e em todo o livro, mostraremos alguns comandos usados no terminal. As linhas que você deve inserir em um terminal começam com $. Você não precisa digitar o caractere $; ele é o prompt da linha de comando mostrado para indicar o início de cada comando. As linhas que não começam com $ normalmente mostram a saída do comando anterior. Adicionalmente, exemplos específicos do PowerShell usarão > em vez de $.

Instalando o rustup no Linux ou macOS

Se você estiver usando Linux ou macOS, abra um terminal e insira o seguinte comando:

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

O comando baixa um script e inicia a instalação da ferramenta rustup, que instala a versão estável mais recente do Rust. Você pode ser solicitado a inserir sua senha. Se a instalação for bem-sucedida, a seguinte linha aparecerá:

Rust is installed now. Great!

Você também precisará de um linker (ligador), que é um programa que o Rust usa para juntar suas saídas compiladas em um único arquivo. É provável que você já tenha um. Se você receber erros de ligador, deverá instalar um compilador C, que normalmente incluirá um ligador. Um compilador C também é útil porque alguns pacotes Rust comuns dependem de código C e precisarão de um compilador C.

Usuários Linux geralmente devem instalar GCC ou Clang, de acordo com a documentação de sua distribuição. Por exemplo, se você usa Ubuntu, pode instalar o pacote build-essential.

Solução de Problemas

Para verificar se você instalou o Rust corretamente, abra um novo shell e insira esta linha:

## Open a new terminal first!
rustc --version

Você deve ver o número da versão, o hash do commit e a data do commit da versão estável mais recente que foi lançada, no seguinte formato:

rustc x.y.z (abcabcabc yyyy-mm-dd)

Se você vir essas informações, você instalou o Rust com sucesso! Se você não vir essas informações, verifique se o Rust está na sua variável de sistema %PATH% da seguinte forma.

No Linux, use:

echo $PATH

Se tudo estiver correto e o Rust ainda não estiver funcionando, há vários lugares onde você pode obter ajuda. Descubra como entrar em contato com outros Rustaceans (um apelido engraçado que nos damos) na página da comunidade em https://www.rust-lang.org/community.

Atualizando e Desinstalando

Uma vez que o Rust é instalado via rustup, atualizar para uma versão recém-lançada é fácil. No seu shell, execute o seguinte script de atualização:

rustup update

Para desinstalar o Rust e o rustup, execute o seguinte script de desinstalação do seu shell:

rustup self uninstall

Digite N quando solicitado para confirmar que você deseja desinstalar o Rust.

Documentação Local

A instalação do Rust também inclui uma cópia local da documentação para que você possa lê-la offline. Execute rustup doc para abrir a documentação local no seu navegador.

rustup doc

Sempre que um tipo ou função for fornecido pela biblioteca padrão e você não tiver certeza do que ele faz ou como usá-lo, use a documentação da interface de programação de aplicativos (API) para descobrir!

Observação: A WebIDE não suporta a abertura de documentação local.

Resumo

Parabéns! Você concluiu o laboratório de Instalação. Você pode praticar mais laboratórios no LabEx para aprimorar suas habilidades.