Установка
Первым делом установим 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, а потому требуют его компилятор.
На macOS, вы можете установить компилятор C, выполнив эту команду:
$ xcode-select --install
Пользователям Linux, в общем случае, понадобится установить GCC или Clang — в соответствии с документацией конкретного дистрибутива. Например, если вы используете Ubuntu, то можете установить пакет build-essential.
Установка rustup на Windows
On Windows, go to https://www.rust-lang.org/tools/install and follow the instructions for installing Rust. At some point in the installation, you’ll be prompted to install Visual Studio. This provides a linker and the native libraries needed to compile programs. If you need more help with this step, see 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 на странице Сообщества.
Обновление и деинсталляция
Однажды установив Rust через rustup, вы можете легко его обновить. Откройте консоль и выполните следующую команду:
$ rustup update
Для удаления Rust и rustup запустите скрипт деинсталляции:
$ rustup self uninstall
Reading the Local Documentation
Установка Rust включает в себя установку локальной копии всей документации, так что вы можете читать её без доступа к сети. Запустите rustup doc, чтобы открыть локально установленную документацию в своём браузере.
Если вы встречаете тип или функцию, предоставляемые стандартной библиотекой, и не знаете, как их использовать, изучите их API в документации!
Using Text Editors and IDEs
Эта книга не подразумевает использование какого-либо конкретного инструмента для разбработки на Rust. Вам будет достаточно даже лишь любого текстового редактора! Тем не менее, многие текстовые редакторы и IDE (integrated development environment) имеют встроенную поддержку Rust. Вы можете список различных редакторов и IDE на странице инструментов разработки.
Working Offline with This Book
In several examples, we will use Rust packages beyond the standard library. To work through those examples, you will either need to have an internet connection or to have downloaded those dependencies ahead of time. To download the dependencies ahead of time, you can run the following commands. (We’ll explain what cargo is and what each of these commands does in detail later.)
$ cargo new get-dependencies
$ cd get-dependencies
$ cargo add rand@0.8.5 trpl@0.2.0
This will cache the downloads for these packages so you will not need to download them later. Once you have run this command, you do not need to keep the get-dependencies folder. If you have run this command, you can use the --offline flag with all cargo commands in the rest of the book to use these cached versions instead of attempting to use the network.