Installazione

Il primo passo è installare Rust. Scaricheremo Rust tramite rustup, uno strumento da riga di comando per gestire le versioni di Rust e gli strumenti associati. Avrai bisogno di una connessione internet per il download.

Nota: Se preferisci non usare rustup per qualche motivo, per favore consulta la pagina Altri Metodi di Installazione di Rust per altre opzioni.

I seguenti passaggi installano l'ultima versione stabile del compilatore Rust. Le garanzie di stabilità di Rust assicurano che tutti gli esempi nel libro che compilano continueranno a compilare con le versioni più recenti di Rust. L'output potrebbe differire leggermente tra le versioni perché Rust spesso migliora i messaggi di errore e avvisi. In altre parole, qualsiasi versione stabile più recente di Rust che installi utilizzando questi passaggi dovrebbe funzionare come previsto con il contenuto di questo libro.

Notazione della Riga di Comando

In questo capitolo e in tutto il libro, mostreremo alcuni comandi utilizzati nel terminale. Le righe che dovresti inserire in un terminale iniziano tutte con $. Non è necessario digitare il carattere $; è il prompt della riga di comando mostrato per indicare l'inizio di ciascun comando. Le righe che non iniziano con $ di solito mostrano l'output del comando precedente. Inoltre, gli esempi specifici di PowerShell utilizzeranno > anziché $.

Installazione di rustup su Linux o macOS

Se utilizzi Linux o macOS, apri un terminale ed inserisci il seguente comando:

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

Il comando scarica uno script e avvia l'installazione dello strumento rustup, che installa l'ultima versione stabile di Rust. Potrebbe essere richiesto di inserire la tua password. Se l'installazione riesce, apparirà la seguente riga:

Rust is installed now. Great!

Avrai bisogno anche di un linker, che è un programma che Rust utilizza per unire i suoi output compilati in un unico file. È probabile che tu ne abbia già uno. Se ottieni errori di linker, dovresti installare un compilatore C, che tipicamente includerà un linker. Un compilatore C è utile anche poiché alcuni comuni pacchetti di Rust dipendono dal codice C e avranno bisogno di un compilatore C.

Su macOS, puoi ottenere un compilatore C eseguendo:

$ xcode-select --install

Gli utenti Linux dovrebbero generalmente installare GCC o Clang, secondo la documentazione della loro distribuzione. Ad esempio, se utilizzi Ubuntu, puoi installare il pacchetto build-essential.

Installazione di rustup su Windows

Su Windows, vai su https://www.rust-lang.org/tools/install e segui le istruzioni per installare Rust. Ad un certo punto nell'installazione, ti verrà chiesto di installare Visual Studio. Questo fornisce un linker e le librerie native necessarie per compilare i programmi. Se hai bisogno di ulteriore aiuto con questo passaggio, vedi https://rust-lang.github.io/rustup/installation/windows-msvc.html

Il resto di questo libro utilizza comandi che funzionano sia in cmd.exe che in PowerShell. Se ci sono differenze specifiche, spiegheremo quale utilizzare.

Risoluzione dei Problemi

Per verificare se hai installato correttamente Rust, apri una shell ed inserisci questa riga:

$ rustc --version

Dovresti vedere il numero di versione, l'hash del commit, e la data del commit per l'ultima versione stabile che è stata rilasciata, nel seguente formato:

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

Se vedi queste informazioni, hai installato Rust con successo! Se non vedi queste informazioni, controlla che Rust sia nella tua variabile di sistema %PATH% come segue.

In Windows CMD, usa:

> echo %PATH%

In PowerShell, usa:

> echo $env:Path

In Linux e macOS, usa:

$ echo $PATH

Se tutto è corretto e Rust continua a non funzionare, ci sono diversi posti dove puoi ottenere aiuto. Scopri come metterti in contatto con altri Rustaceans (un soprannome scherzoso che ci chiamiamo) sulla pagina della community.

Aggiornamento e Disinstallazione

Una volta installato Rust tramite rustup, aggiornare ad una versione rilasciata di recente è facile. Dal tuo shell, esegui il seguente script di aggiornamento:

$ rustup update

Per disinstallare Rust e rustup, esegui il seguente script di disinstallazione dal tuo shell:

$ rustup self uninstall

Documentazione Locale

L'installazione di Rust include anche una copia locale della documentazione in modo che tu possa leggerla offline. Esegui rustup doc per aprire la documentazione locale nel tuo browser.

Ogni volta che un tipo o una funzione viene fornito dalla libreria standard e non sei sicuro di cosa faccia o di come usarlo, usa la documentazione dell'interfaccia di programmazione dell'applicazione (API) per scoprirlo!