Установка
Первым делом нужно установить Rust. Скачивать его мы будем через rustup —
утилиту командной строки, которая управляет версиями Rust и связанными с ним
инструментами. Для загрузки понадобится интернет.
Примечание: если по какой-то причине вы не хотите использовать rustup,
загляните на страницу других способов установки 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, и для их сборки он нужен.
В 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 (application programming interface, программный интерфейс приложения)!
Текстовые редакторы и 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 можно удалить. Дальше в книге ко всем
командам cargo можно добавлять флаг --offline — тогда Cargo возьмёт
закешированные версии и не будет лезть в сеть.