Установка
Первым шагом является установка Rust. Мы загрузим Rust через rustup — инструмент командной строки для управления версиями Rust и связанными инструментами. Для загрузки потребуется подключение к интернету.
Примечание: если по какой-то причине вы предпочитаете не использовать rustup, обратитесь к странице других способов установки Rust для получения дополнительных вариантов.
Следующие шаги устанавливают последнюю стабильную версию компилятора Rust. Гарантии стабильности Rust обеспечивают, что все примеры в книге, которые компилируются, продолжат компилироваться с более новыми версиями Rust. Вывод может незначительно отличаться между версиями, поскольку Rust часто улучшает сообщения об ошибках и предупреждения. Иными словами, любая более новая стабильная версия Rust, установленная с помощью этих шагов, должна работать как ожидается с содержимым этой книги.
Обозначения командной строки
В этой главе и на протяжении всей книги мы будем показывать некоторые команды, используемые в терминале. Строки, которые следует вводить в терминале, все начинаются с $. Вам не нужно вводить символ $; это приглашение командной строки, показываемое для указания начала каждой команды. Строки, которые не начинаются с $, обычно показывают вывод предыдущей команды. Кроме того, примеры, специфичные для PowerShell, будут использовать > вместо $.
Установка rustup в Linux или macOS
Если вы используете Linux или macOS, откройте терминал и введите следующую команду:
$ curl --proto '=https' --tlsv1.2 https://sh.rustup.rs -sSf | sh
Команда загружает скрипт и запускает установку инструмента rustup, который устанавливает последнюю стабильную версию Rust. Возможно, будет запрошен ваш пароль. Если установка прошла успешно, появится следующая строка:
Rust is installed now. Great!
Вам также потребуется компоновщик (linker) — программа, которую 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 всё ещё не работает, есть ряд мест, где можно получить помощь. Узнайте, как связаться с другими Rustaceans (глупое прозвище, которое мы себе дали), на странице сообщества.
Обновление и удаление
После установки 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.10.1 trpl@0.2.0
Это закеширует загрузки для этих пакетов, так что вам не потребуется загружать их позже. После выполнения этой команды вам не нужно сохранять папку get-dependencies. Если вы выполнили эту команду, вы можете использовать флаг --offline со всеми командами cargo в остальной части книги, чтобы использовать эти закешированные версии вместо попытки использования сети.