Установка

Первый шаг — установить Rust. Мы загрузим Rust с помощью rustup — инструмента командной строки для управления версиями Rust и связанными с ним инструментами. Для загрузки потребуется подключение к интернету.

Следующие шаги устанавливают последнюю стабильную версию компилятора Rust. Гарантии стабильности Rust обеспечивают, что все примеры из книги, которые компилируются сейчас, будут компилироваться и в более новых версиях Rust. Вывод может немного отличаться в разных версиях, поскольку Rust часто улучшает сообщения об ошибках и предупреждения. Иными словами, любая более новая стабильная версия Rust, установленная с помощью этих шагов, должна работать с содержимым этой книги так, как ожидается.

Установка rustup в Linux или macOS

Если вы используете Linux или macOS, откройте терминал и введите следующую команду:

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

Команда загружает скрипт и запускает установку инструмента rustup, который устанавливает последнюю стабильную версию Rust. Возможно, вам будет предложено ввести пароль. Если установка прошла успешно, появится следующая строка:

Rust is installed now. Great!

Вам также понадобится компоновщик — программа, которую Rust использует для объединения скомпилированных файлов в один файл. Скорее всего, он у вас уже есть. Если возникнут ошибки компоновщика, установите компилятор C, который обычно включает в себя компоновщик. Компилятор C также пригодится, поскольку некоторые распространённые пакеты Rust зависят от кода на C и требуют компилятора C.

В macOS компилятор C можно установить, выполнив следующую команду:

$ xcode-select --install

Пользователям Linux обычно следует установить GCC или Clang в соответствии с документацией своего дистрибутива. Например, если вы используете Ubuntu, можно установить пакет build-essential.

Установка rustup в Windows

В Windows перейдите на страницу https://www.rust-lang.org/tools/install и следуйте инструкциям по установке Rust. На каком-то этапе установки вам будет предложено установить Visual Studio. Она предоставляет компоновщик и необходимые для компиляции программ системные библиотеки. Если вам нужна дополнительная помощь с этим шагом, ознакомьтесь со страницей https://rust-lang.github.io/rustup/installation/windows-msvc.html.

В остальной части книги используются команды, работающие и в cmd.exe, и в PowerShell. Если между ними есть конкретные различия, мы объясним, какой вариант использовать.

Устранение неполадок

Чтобы проверить, правильно ли установлен Rust, откройте оболочку и введите эту строку:

$ rustc --version

Вы должны увидеть номер версии, хеш коммита и дату коммита для последней выпущенной стабильной версии в следующем формате:

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

Если вы видите эту информацию, значит, Rust успешно установлен! Если этой информации нет, проверьте, что Rust указан в системной переменной %PATH%, как показано ниже.

В Windows CMD используйте:

> echo %PATH%

В PowerShell используйте:

> echo $env:Path

В Linux и macOS используйте:

$ echo $PATH

Если всё указано правильно, но Rust по-прежнему не работает, вы можете обратиться за помощью в нескольких местах. Узнайте, как связаться с другими растасианами (так мы в шутку себя называем), на странице сообщества.

Обновление и удаление

После установки Rust с помощью rustup обновиться до новой выпущенной версии очень просто. В оболочке выполните следующий скрипт обновления:

$ rustup update

Чтобы удалить Rust и rustup, выполните в оболочке следующий скрипт удаления:

$ rustup self uninstall

Чтение локальной документации

При установке Rust также создаётся локальная копия документации, которую можно читать без подключения к интернету. Выполните команду rustup doc, чтобы открыть локальную документацию в браузере.

Если стандартная библиотека предоставляет тип или функцию, а вы не уверены, что они делают или как их использовать, обратитесь к документации по интерфейсу прикладного программирования (API), чтобы узнать больше!

Использование текстовых редакторов и IDE

В этой книге не предполагается, что вы используете какие-либо определённые инструменты для написания кода на Rust. С этой задачей справится практически любой текстовый редактор! Однако многие текстовые редакторы и интегрированные среды разработки (IDE) имеют встроенную поддержку Rust. Актуальный список многих редакторов и IDE всегда можно найти на странице инструментов на сайте Rust.

Работа с этой книгой без подключения к интернету

В нескольких примерах мы будем использовать пакеты Rust, не входящие в стандартную библиотеку. Чтобы выполнить эти примеры, вам понадобится подключение к интернету или предварительно загруженные зависимости. Чтобы загрузить зависимости заранее, можно выполнить следующие команды. (Позже мы подробно объясним, что такое cargo и что делает каждая из этих команд.)

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

Эти команды сохранят загруженные пакеты в кэше, поэтому позже загружать их не придётся. После выполнения этой команды папка get-dependencies больше не нужна. Если вы выполнили эту команду, то во всех командах cargo в остальной части книги можно использовать флаг --offline, чтобы брать версии из кэша, а не обращаться к сети.