Język programowania Rust

Instalacja

Pierwszym krokiem jest zainstalowanie Rusta. Pobierzemy Rusta za pośrednictwem rustup, narzędzia wiersza poleceń do zarządzania wersjami Rusta i powiązanymi narzędziami. Do pobrania będziesz potrzebować połączenia z internetem.

Uwaga: Jeśli z jakiegoś powodu wolisz nie używać rustup, zapoznaj się z stroną Inne metody instalacji Rusta w celu uzyskania dodatkowych opcji.

Poniższe kroki instalują najnowszą stabilną wersję kompilatora Rusta. Gwarancje stabilności Rusta zapewniają, że wszystkie przykłady w książce, które się kompilują, będą nadal kompilować się z nowszymi wersjami Rusta. Wynik może nieznacznie różnić się między wersjami, ponieważ Rust często poprawia komunikaty o błędach i ostrzeżenia. Innymi słowy, każda nowsza, stabilna wersja Rusta zainstalowana za pomocą tych kroków powinna działać zgodnie z oczekiwaniami z treścią tej książki.

Notacja wiersza poleceń

W tym rozdziale i w całej książce będziemy pokazywać niektóre polecenia używane w terminalu. Wiersze, które powinieneś wpisać w terminalu, zaczynają się od $. Nie musisz wpisywać znaku $; jest to znak zachęty wiersza poleceń, który wskazuje początek każdego polecenia. Wiersze, które nie zaczynają się od $, zazwyczaj pokazują wynik poprzedniego polecenia. Dodatkowo, przykłady specyficzne dla PowerShell będą używać > zamiast $.

Instalacja rustup na Linuksie lub macOS

Jeśli używasz Linuksa lub macOS, otwórz terminal i wprowadź następujące polecenie:

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

Polecenie pobiera skrypt i rozpoczyna instalację narzędzia rustup, które instaluje najnowszą stabilną wersję Rusta. Może zostać wyświetlony monit o hasło. Jeśli instalacja zakończy się pomyślnie, pojawi się następujący wiersz:

Rust jest już zainstalowany. Świetnie!

Będziesz także potrzebował linkera, czyli programu, którego Rust używa do łączenia skompilowanych wyników w jeden plik. Prawdopodobnie już go masz. Jeśli otrzymasz błędy linkera, powinieneś zainstalować kompilator C, który zazwyczaj zawiera linker. Kompilator C jest również przydatny, ponieważ niektóre popularne pakiety Rusta zależą od kodu C i będą wymagały kompilatora C.

Na macOS możesz uzyskać kompilator C, uruchamiając:

$ xcode-select --install

Użytkownicy Linuksa powinni zazwyczaj instalować GCC lub Clang, zgodnie z dokumentacją swojej dystrybucji. Na przykład, jeśli używasz Ubuntu, możesz zainstalować pakiet build-essential.

Instalacja rustup na Windows

Na Windows, przejdź na https://www.rust-lang.org/tools/install i postępuj zgodnie z instrukcjami instalacji Rusta. W pewnym momencie instalacji zostaniesz poproszony o zainstalowanie Visual Studio. Zapewnia to linker i natywne biblioteki potrzebne do kompilowania programów. Jeśli potrzebujesz więcej pomocy w tym kroku, zobacz https://rust-lang.github.io/rustup/installation/windows-msvc.html.

Reszta tej książki używa poleceń, które działają zarówno w cmd.exe, jak i PowerShell. Jeśli wystąpią specyficzne różnice, wyjaśnimy, którego użyć.

Rozwiązywanie problemów

Aby sprawdzić, czy Rust jest poprawnie zainstalowany, otwórz powłokę i wrowadź ten wiersz:

$ rustc --version

Ppowinien pojawić się numer wersji, skrót commita i data commita dla najnowszej stabilnej wersji, która została wydana, w następującym formacie:

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

Jeśli widzisz te informacje, pomyślnie zainstalowałeś Rusta! Jeśli ich nie widzisz, sprawdź, czy Rust znajduje się w zmiennej systemowej %PATH% w następujący sposób.

W systemie Windows CMD użyj:

> echo %PATH%

W PowerShellu użyj:

> echo $env:Path

Na Linuksie i macOS użyj:

$ echo $PATH

Jeśli wszystko jest w porządku, a Rust nadal nie działa, istnieje wiele miejsc, w których możesz uzyskać pomoc. Dowiedz się, jak skontaktować się z innymi Rustaceanami (tak się nazywamy) na stronie społeczności.

Aktualizacja i deinstalacja

Po zainstalowaniu Rusta za pomocą rustup, aktualizacja do nowo wydanej wersji jest łatwa. Z poziomu powłoki uruchom następujący skrypt aktualizacji:

$ rustup update

Aby odinstalować Rusta i rustup, uruchom następujący skrypt odinstalowujący z poziomu powłoki:

$ rustup self uninstall

Czytanie lokalnej dokumentacji

Instalacja Rusta zawiera również lokalną kopię dokumentacji, dzięki czemu możesz czytać ją offline. Uruchom rustup doc, aby otworzyć lokalną dokumentację w przeglądarce.

Zawsze, gdy typ lub funkcja jest dostarczana przez bibliotekę standardową, a nie masz pewności, co robi lub jak jej używać, skorzystaj z dokumentacji interfejsu programowania aplikacji (API), aby się dowiedzieć!

Używanie edytorów tekstu i środowisk IDE

Ta książka nie czyni żadnych założeń co do narzędzi, których używasz do pisania kodu Rusta. Niemal każdy edytor tekstu spełni swoje zadanie! Jednakże wiele edytorów tekstu i zintegrowanych środowisk programistycznych (IDE) posiada wbudowane wsparcie dla Rusta. Zawsze możesz znaleźć dość aktualną listę wielu edytorów i środowisk IDE na stronie z narzędziami na stronie internetowej Rusta.

Praca offline z tą książką

W kilku przykładach będziemy używać pakietów Rusta poza biblioteką standardową. Aby przećwiczyć te przykłady, będziesz potrzebować połączenia z internetem lub wcześniejszego pobrania tych zależności. Aby pobrać zależności wcześniej, możesz uruchomić następujące polecenia. (Wyjaśnimy, czym jest cargo i co robi każde z tych poleceń szczegółowo później.)

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

Spowoduje to buforowanie pobrań tych pakietów, dzięki czemu nie będziesz musiał ich później pobierać. Po uruchomieniu tego polecenia nie musisz zatrzymywać folderu get-dependencies. Jeśli uruchomiłeś to polecenie, możesz użyć flagi --offline ze wszystkimi poleceniami cargo w pozostałej części książki, aby użyć tych buforowanych wersji zamiast próbować używać sieci.