Primeiro projeto em Rust

Seu objetivo: criar um projeto Cargo e ver a execução refletir uma mudança salva.

Pense antes de seguir: Depois de mudar o texto e apertar ▶, o Rust deve recompilar?

A Kinein Vectis usa o Rust instalado no sistema. Este guia usa o rustup, o instalador oficial das versões do Rust, junto com o rust-analyzer, que fornece completamento e diagnósticos no editor.

Instale o Rust

O Ubuntu 24.04 tem o rustup no gerenciador de pacotes:

sudo apt install rustup

O rustup ainda não traz nenhuma versão do Rust. Peça a estável mais recente e o rust-analyzer:

rustup default stable
rustup component add rust-analyzer

Por padrão, as versões do compilador e suas ferramentas ficam em ~/.rustup. O Cargo usa ~/.cargo para seu cache e para programas instalados com cargo install. As ferramentas instaladas ocuparam cerca de 1,6 GB nesta reprodução. Confira:

cargo --version
rust-analyzer --version
cargo clippy --version

Cada linha mostra uma versão. Nesta reprodução, a estável era a 1.99.0. No perfil padrão da instalação, o Clippy, que a IDE usa na análise de código, vem junto; o comando acima confirma se está disponível.

O site do Rust, em rust-lang.org, tem outro instalador do rustup; os comandos rustup acima valem para os dois.

Crie o projeto

Guarde seus projetos em uma pasta própria. Se ainda não tiver ~/projetos, crie pelo terminal:

mkdir -p ~/projetos

Na tela inicial, clique em Novo Rust / Cargo. Na caixa Abrir ou criar projeto, dê dois cliques em projetos, clique em + projeto e digite ola-rust:

No Rust, quem cria o projeto é o próprio Cargo, com o comando mostrado na prévia.

Clique em Criar. Diferente do C++, a prévia mostra um comando: a IDE chama o cargo new, a ferramenta oficial do Rust para isso. O --vcs none diz para não criar um repositório Git.

Abra src e clique em main.rs:

O projeto Cargo recém-criado. No alto à direita, o seletor de execução mostra Cargo: debug.

Os dois arquivos principais são:

• Cargo.toml: o nome, a versão e, mais tarde, as dependências do projeto.
• src/main.rs: o programa, que imprime Hello, world!.

Execute

Abra antes o terminal com Alt+F12, para a aba da execução continuar visível depois que o programa terminar. Depois clique no ▶.

No Rust, o ▶ roda cargo run, que compila o que mudou e executa em seguida. A aba mostra as duas coisas:

Compiling, Finished e Running são do Cargo; a última linha é o programa.

O Cargo guarda os arquivos de compilação em target. O Cargo.lock registra as versões exatas das dependências resolvidas; ele é gerado pelo Cargo ao preparar o projeto para compilação.

Mude o código e rode de novo

No main.rs, troque Hello, world! por Olá, Rust!:

    println!("Olá, Rust!");

Salve com Ctrl+S e clique no ▶ de novo. Não precisa compilar antes: o cargo run percebe a mudança e compila sozinho.

A segunda execução já mostra o texto novo.

Pelo terminal, o mesmo comando faz o mesmo:

cd ~/projetos/ola-rust
cargo run

A última linha é Olá, Rust!.

Confira o que aprendeu

Sem reler as etapas, responda:

1. Depois de mudar o texto e apertar ▶, o Rust deve recompilar?
2. Qual arquivo descreve o projeto?
3. Onde fica o código inicial?

Continue em Rust

O ola-rust já executa uma mensagem. Na próxima etapa, você continua no mesmo src/main.rs e faz o programa calcular temperaturas. O Cargo e o botão ▶ continuam sendo o caminho para executar.