Rust-ohjelmointikieli

Asennus

Ensimmäinen askel on Rustin asentaminen. Lataamme Rustin rustup-työkalun kautta, joka on komentorivityökalu Rust-versioiden ja niihin liittyvien työkalujen hallintaan. Tarvitset internet-yhteyden latausta varten.

Huom: Jos et halua käyttää rustup-työkalua jostain syystä, katso muut Rustin asennustavat -sivulta lisää vaihtoehtoja.

Seuraavat vaiheet asentavat uusimman vakaan version Rust-kääntäjästä. Rustin vakaustakuut varmistavat, että kaikki tämän kirjan esimerkit, jotka kääntyvät, kääntyvät edelleen myös uudemmissa Rust-versioissa. Tuloste voi hieman erota versioiden välillä, koska Rust parantaa virheilmoituksia ja varoituksia säännöllisesti. Toisin sanoen, mikä tahansa näillä ohjeilla asennettu uudempi vakaa Rust-versio toimii odotetusti tämän kirjan sisällön kanssa.

rustup-asennus Linuxilla tai macOS:llä

Jos käytät Linuxia tai macOS:ää, avaa terminaali ja kirjoita seuraava komento:

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

Komento lataa skriptin ja käynnistää rustup-työkalun asennuksen, joka asentaa uusimman vakaan Rust-version. Sinua saatetaan pyytää salasanaasi. Jos asennus onnistuu, näet seuraavan rivin:

Rust is installed now. Great!

Tarvitset myös linkkerin, joka on ohjelma, jota Rust käyttää yhdistääkseen kääntämänsä tulosteet yhdeksi tiedostoksi. Sinulla on todennäköisesti jo sellainen. Jos saat linkkerivirheitä, sinun pitäisi asentaa C-kääntäjä, joka yleensä sisältää linkkerin. C-kääntäjä on hyödyllinen myös siksi, että jotkin yleiset Rust-paketit riippuvat C-koodista ja tarvitsevat C-kääntäjän.

macOS:llä voit hankkia C-kääntäjän suorittamalla:

$ xcode-select --install

Linux-käyttäjien tulisi yleensä asentaa GCC tai Clang jakelunsa dokumentaation mukaisesti. Esimerkiksi Ubuntussa voit asentaa build-essential-paketin.

rustup-asennus Windowsilla

Windowsissa siirry osoitteeseen https://www.rust-lang.org/tools/install ja seuraa Rustin asennusohjeita. Asennuksen aikana sinua pyydetään asentamaan Visual Studio. Se tarjoaa linkkerin ja natiivit kirjastot, joita ohjelmien kääntäminen tarvitsee. Jos tarvitset lisäapua tässä vaiheessa, katso https://rust-lang.github.io/rustup/installation/windows-msvc.html.

Tämän kirjan loppuosa käyttää komentoja, jotka toimivat sekä cmd.exe:ssä että PowerShellissä. Jos on erityisiä eroja, selitämme, kumpaa käyttää.

Vianmääritys

Voit tarkistaa, onko Rust asennettu oikein, avaamalla komentorivin ja kirjoittamalla:

$ rustc --version

Sinun pitäisi nähdä versionumero, commit-hash ja commit-päivämäärä uusimmalle julkaistulle vakaalle versiolle seuraavassa muodossa:

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

Jos näet nämä tiedot, Rust on asennettu onnistuneesti! Jos et näe niitä, tarkista, että Rust on %PATH%-järjestelmämuuttujassasi seuraavasti.

Windows CMD:ssä käytä:

> echo %PATH%

PowerShellissä käytä:

> echo $env:Path

Linuxissa ja macOS:ssä käytä:

$ echo $PATH

Jos kaikki on oikein ja Rust ei silti toimi, voit saada apua monista paikoista. Ota selvää, miten voit olla yhteydessä muihin Rustaceaneihin (leikkisä lempinimi, jolla kutsumme itseämme) yhteisösivulta.

Päivittäminen ja poistaminen

Kun Rust on asennettu rustup-työkalun kautta, uuteen julkaistuun versioon päivittäminen on helppoa. Suorita komentorivillä seuraava päivitysskripti:

$ rustup update

Poistaaksesi Rustin ja rustup-työkalun, suorita seuraava poistoskripti komentorivillä:

$ rustup self uninstall

Paikallisen dokumentaation lukeminen

Rustin asennuksen mukana tulee paikallinen kopio dokumentaatiosta, joten voit lukea sitä offline-tilassa. Avaa paikallinen dokumentaatio selaimessasi komennolla rustup doc.

Aina kun standardikirjasto tarjoaa tyypin tai funktion etkä ole varma, mitä se tekee tai miten sitä käytetään, käytä sovellusohjelmointirajapinnan (API) dokumentaatiota selvittääksesi!

Tekstieditorien ja IDE:iden käyttö

Tämä kirja ei tee oletuksia siitä, mitä työkaluja käytät Rust-koodin kirjoittamiseen. Melkein mikä tahansa tekstieditori hoitaa homman! Monet tekstieditorit ja integroidut kehitysympäristöt (IDE) tarjoavat kuitenkin sisäänrakennettua Rust-tukea. Löydät melko ajantasaisen listan monista editoreista ja IDE:istä työkalusivulta Rustin verkkosivustolla.

Tämän kirjan käyttö offline-tilassa

Useissa esimerkeissä käytämme Rust-paketteja standardikirjaston ulkopuolelta. Työskennelläksesi näiden esimerkkien parissa tarvitset joko internet-yhteyden tai olet ladannut riippuvuudet etukäteen. Ladataksesi riippuvuudet etukäteen voit suorittaa seuraavat komennot. (Selitämme myöhemmin tarkemmin, mikä cargo on ja mitä kukin komento tekee.)

$ cargo new get-dependencies
$ cd get-dependencies
$ cargo add rand@0.10.1 trpl@0.2.0

Tämä tallentaa näiden pakettien lataukset välimuistiin, joten sinun ei tarvitse ladata niitä myöhemmin. Kun olet suorittanut tämän komennon, sinun ei tarvitse säilyttää get-dependencies-kansiota. Jos olet suorittanut tämän komennon, voit käyttää --offline-lippua kaikissa cargo-komennoissa kirjan loppuosassa käyttääksesi näitä välimuistissa olevia versioita verkon käytön sijaan.