Instalação
O primeiro passo é instalar o Rust. Vamos baixar o Rust pelo rustup, uma
ferramenta de linha de comando para gerenciar versões do Rust e as ferramentas
associadas. Para o download, você vai precisar de conexão com a internet.
Nota: Se, por algum motivo, você preferir não usar o
rustup, veja a página de outros métodos de instalação para mais opções.
Os passos a seguir instalam a versão estável mais recente do compilador do Rust. As garantias de estabilidade do Rust asseguram que todos os exemplos do livro que compilam continuarão compilando em versões mais novas do Rust. A saída pode variar um pouco entre versões, porque o Rust costuma melhorar as mensagens de erro e os avisos. Em outras palavras, qualquer versão estável mais nova que você instalar com estes passos deve funcionar como esperado com o conteúdo deste livro.
Notação de linha de comando
Neste capítulo e em todo o livro, vamos mostrar alguns comandos usados no
terminal. As linhas que você deve digitar em um terminal começam todas com $.
Você não precisa digitar o caractere $; ele é o prompt da linha de comando,
que indica o início de cada comando. As linhas que não começam com $
normalmente mostram a saída do comando anterior. Além disso, os exemplos
específicos do PowerShell vão usar > em vez de $.
Instalando o rustup no Linux ou macOS
Se você usa Linux ou macOS, abra um terminal e digite o seguinte comando:
$ curl --proto '=https' --tlsv1.2 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. Talvez você precise informar sua
senha. Se a instalação for bem-sucedida, esta linha vai aparecer:
Rust is installed now. Great!
Você também vai precisar de um linker, um programa que o Rust usa para juntar as saídas compiladas em um único arquivo. É provável que você já tenha um. Se aparecerem erros de linker, instale um compilador C, que normalmente inclui um linker. Um compilador C também é útil porque alguns pacotes comuns do Rust dependem de código C e precisam dele.
No macOS, você pode obter um compilador C executando:
$ xcode-select --install
Usuários de Linux normalmente devem instalar o GCC ou o Clang, de acordo com a
documentação da sua distribuição. Por exemplo, se você usa o Ubuntu, pode
instalar o pacote build-essential.
Instalando o rustup no Windows
No Windows, acesse https://www.rust-lang.org/tools/install e siga as instruções para instalar o Rust. Em algum momento da instalação, você será solicitado a instalar o Visual Studio. Ele fornece um linker e as bibliotecas nativas necessárias para compilar programas. Se precisar de mais ajuda nesta etapa, veja https://rust-lang.github.io/rustup/installation/windows-msvc.html.
O restante deste livro usa comandos que funcionam tanto no cmd.exe quanto no PowerShell. Se houver diferenças específicas, vamos explicar qual usar.
Solução de problemas
Para verificar se o Rust foi instalado corretamente, abra um shell e digite esta linha:
$ 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 lançada, no seguinte formato:
rustc x.y.z (abcabcabc yyyy-mm-dd)
Se você vir essas informações, o Rust foi instalado com sucesso! Se não vir,
confira se o Rust está na sua variável de sistema %PATH%, da seguinte forma.
No Windows CMD, use:
> echo %PATH%
No PowerShell, use:
> echo $env:Path
No Linux e no macOS, use:
$ echo $PATH
Se está tudo certo e o Rust ainda não funciona, há vários lugares onde você pode pedir ajuda. Veja como entrar em contato com outros Rustaceans (um apelido engraçado que a comunidade usa para si mesma) na página da comunidade.
Atualizando e desinstalando
Depois de instalar o Rust pelo 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
no seu shell:
$ rustup self uninstall
Lendo a 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.
Sempre que um tipo ou uma função vier da biblioteca padrão e você não tiver certeza do que ele faz ou de como usá-lo, use a documentação da API (interface de programação de aplicações) para descobrir!
Usando editores de texto e IDEs
Este livro não faz suposições sobre quais ferramentas você usa para escrever código Rust. Praticamente qualquer editor de texto resolve! Porém, muitos editores de texto e ambientes de desenvolvimento integrados (IDEs) têm suporte nativo a Rust. Você sempre pode encontrar uma lista razoavelmente atualizada de editores e IDEs na página de ferramentas do site do Rust.
Trabalhando offline com este livro
Em vários exemplos, vamos usar pacotes do Rust além da biblioteca padrão. Para
acompanhar esses exemplos, você vai precisar de conexão com a internet ou ter
baixado essas dependências antes. Para baixar as dependências com antecedência,
você pode executar os seguintes comandos. (Vamos explicar em detalhes mais
adiante o que é o cargo e o que cada um desses comandos faz.)
$ cargo new get-dependencies
$ cd get-dependencies
$ cargo add rand@0.10.1 trpl@0.2.0
Isso vai guardar em cache os downloads desses pacotes, então você não precisará
baixá-los depois. Depois de executar esse comando, você não precisa mais manter a
pasta get-dependencies. Se você executou esse comando, pode usar a flag
--offline com todos os comandos do cargo no restante do livro, para usar essas
versões em cache em vez de tentar acessar a rede.