Instalação e Configuração do Ambiente (rustup)

Olá! 👋 Bem-vindo(a) à primeira aula prática do nosso curso de Rust! Hoje, daremos o passo fundamental para começar a programar em Rust: a instalação e configuração do ambiente de desenvolvimento. Usaremos a ferramenta oficial e recomendada, o rustup.

🚀 1. Introdução: Preparando o Terreno para o Rust

Antes de mergulharmos na sintaxe e nos conceitos de Rust, precisamos garantir que seu computador esteja pronto para compilar e executar código Rust. É aqui que entra o rustup.

O rustup é o instalador e gerenciador de toolchains (conjuntos de ferramentas) de Rust oficial. Ele é crucial porque:

• Facilita a instalação do Rust e suas ferramentas associadas (rustc, cargo).
• Permite alternar facilmente entre diferentes versões do Rust (stable, beta, nightly).
• Gerencia a instalação de componentes adicionais (como formatadores de código e linters).
• Suporta compilação cruzada para diferentes plataformas.

Pense no rustup como o maestro da sua orquestra de desenvolvimento Rust! 🎻

🛠️ 2. Entendendo e Instalando rustup

O que é uma Toolchain?

Uma "toolchain" em Rust é um conjunto completo de ferramentas necessárias para desenvolver em Rust. Isso inclui:

• rustc: O compilador Rust. Ele transforma seu código Rust em um executável.
• cargo: O gerenciador de pacotes e sistema de build de Rust. Ele gerencia dependências, compila seu projeto, executa testes e muito mais. É uma ferramenta indispensável!
• rust-std: A biblioteca padrão do Rust.

O rustup gerencia essas toolchains para você, permitindo que você tenha múltiplas versões instaladas e alterne entre elas conforme a necessidade.

Instalação Oficial do rustup

A instalação do rustup é o método preferido e mais recomendado para todos os sistemas operacionais.

🐧 Sistema Operacional tipo Unix (Linux, macOS, WSL)

Para sistemas Linux, macOS ou Windows Subsystem for Linux (WSL), abra seu terminal e execute o seguinte comando:

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

Este comando baixa um script e o executa. Siga as instruções no terminal. Na maioria dos casos, você pode simplesmente pressionar Enter para aceitar a instalação padrão.

Após a instalação, você precisará configurar seu PATH. O script de instalação geralmente tenta fazer isso automaticamente, mas se você vir uma mensagem como:

Rust is installed now. Great!

To get started you need Cargo's bin directory in your PATH environment variable.
This has been done automatically for you, but you may need to restart your shell.

...então você pode precisar fechar e reabrir seu terminal, ou executar source $HOME/.cargo/env para atualizar sua sessão atual.

🪟 Windows

Para Windows, o método mais fácil é baixar e executar o instalador rustup-init.exe.

1. Acesse a página oficial de instalação do Rust: https://www.rust-lang.org/tools/install
2. Baixe o rustup-init.exe para Windows (64-bit).
3. Execute o arquivo baixado. Siga as instruções do instalador. Assim como nos sistemas Unix, você pode geralmente aceitar as opções padrão.

Importante para Windows: Para que o Rust funcione corretamente no Windows, você precisará das ferramentas de build do C++ para Visual Studio. A maneira mais fácil de obtê-las é instalando o Build Tools para Visual Studio 2022 (ou versão mais recente) e selecionando a carga de trabalho "Desenvolvimento de desktop com C++" durante a instalação. Você pode baixar isso de: https://visualstudio.microsoft.com/downloads/

Verificando a Instalação

Após a instalação, você pode verificar se o Rust e o Cargo foram instalados corretamente executando os seguintes comandos no seu terminal:

rustc --version
cargo --version
rustup --version

Você deverá ver a versão do compilador Rust, do Cargo e do rustup instalada. Por exemplo:

rustc 1.76.0 (07d1ca009 2024-02-13) # Sua versão pode ser diferente
cargo 1.76.0 (c84b36747 2024-01-29) # Sua versão pode ser diferente
rustup 1.26.0 (5234a580a 2023-04-05) # Sua versão pode ser diferente

Se você vir algo parecido com isso, parabéns! 🎉 Seu ambiente Rust está configurado!

Comandos Essenciais do rustup

Aqui estão alguns comandos rustup que você usará frequentemente:

• Atualizar o Rust: Mantenha sua toolchain atualizada.

  rustup update

  Este comando verifica por novas versões do Rust e as instala, atualizando sua toolchain padrão.

• Listar Toolchains Instaladas: Veja quais toolchains você tem.

  rustup toolchain list

  Exemplo de saída:

  stable-x86_64-unknown-linux-gnu (default)
  nightly-x86_64-unknown-linux-gnu
  

• Definir uma Toolchain Padrão: Altere a toolchain que é usada por padrão.

  rustup default stable

  Ou para uma versão específica:

  rustup default nightly

• Instalar uma Toolchain Específica: Adicione uma nova toolchain.

  rustup install nightly

  Ou uma versão específica:

  rustup install 1.70.0

• Remover uma Toolchain: Limpe toolchains que não são mais necessárias.

  rustup uninstall nightly

• Instalar Componentes Adicionais: rustup pode instalar ferramentas úteis como formatadores de código (rustfmt) e linters (clippy).

  rustup component add rustfmt clippy

  • rustfmt: Formata seu código Rust de acordo com as diretrizes de estilo padrão. Essencial para manter a consistência do código.
  • clippy: Um linter que detecta erros comuns, potenciais bugs e código não idiomático. É como ter um revisor de código super atencioso!

🧑‍💻 3. Exercícios e Desafios Práticos

Agora que você conhece o básico, é hora de colocar a mão na massa! Siga estas tarefas no seu próprio terminal.

📝 Tarefas

• 1. Instale o rustup:

  • Se você ainda não o fez, instale o rustup usando o comando apropriado para o seu sistema operacional (ou o instalador para Windows).
  • Dica: Reinicie seu terminal após a instalação para garantir que o PATH esteja configurado corretamente.

• 2. Verifique a Instalação:

  • Execute rustc --version, cargo --version e rustup --version.
  • Anote as versões que foram instaladas.

• 3. Atualize sua Toolchain:

  • Execute rustup update.
  • Verifique a saída para confirmar que sua toolchain padrão está atualizada.

• 4. Liste as Toolchains:

  • Execute rustup toolchain list.
  • Você deve ver pelo menos a toolchain stable listada.

• 5. Instale e Defina uma Toolchain Específica (Opcional, mas recomendado para prática):

  • Instale a toolchain nightly:

    rustup install nightly

  • Defina a toolchain nightly como padrão temporariamente:

    rustup default nightly

  • Verifique se rustc --version agora mostra a versão nightly.
  • Volte para a toolchain stable:

    rustup default stable

  • Verifique novamente com rustc --version.

• 6. Instale Componentes Essenciais:

  • Instale rustfmt e clippy:

    rustup component add rustfmt clippy

  • Para verificar se foram instalados, você pode tentar executar:

    cargo fmt --version
    cargo clippy --version

    Se você vir as versões, eles estão prontos para uso!

💡 4. Resumo e Próximos Passos

Parabéns! Você acaba de dar o primeiro e mais importante passo para se tornar um(a) desenvolvedor(a) Rust.

Nesta aula, você aprendeu:

• A importância do rustup como gerenciador de toolchains do Rust.
• Como instalar o rustup em diferentes sistemas operacionais.
• Como verificar sua instalação.
• Comandos essenciais do rustup para gerenciar toolchains e componentes.
• Instalou ferramentas cruciais como rustfmt e clippy.

Com seu ambiente configurado, estamos prontos para mergulhar no mundo da programação Rust!

No próximo módulo, vamos criar nosso primeiro projeto Rust usando o cargo e entender a estrutura básica de um programa Rust. Prepare-se para escrever seu primeiro "Hello, world!" em Rust! 🦀

Até a próxima! 👋