Встановлення (Installation)
Перший крок — встановити Rust. Ми завантажимо Rust через rustup, інструмент командного рядка для керування версіями Rust і пов’язаними інструментами. Для завантаження вам знадобиться підключення до інтернету.
Примітка: якщо з якоїсь причини ви не хочете використовувати
rustup, дивіться сторінку Other Rust Installation Methods для інших варіантів.
Наступні кроки встановлюють останню стабільну версію компілятора 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. Це надає лінкер (linker) і рідні бібліотеки, потрібні для компіляції програм. Якщо вам потрібна додаткова допомога з цим кроком, дивіться https://rust-lang.github.io/rustup/installation/windows-msvc.html.
У решті цієї книги використовуються команди, які працюють і в cmd.exe, і в PowerShell. Якщо існують специфічні відмінності, ми пояснимо, що саме використовувати.
Усунення неполадок
Щоб перевірити, чи правильно встановлено Rust, відкрийте shell і введіть цей рядок:
$ rustc --version
Ви маєте побачити номер версії, hash коміту та дату коміту для останньої стабільної версії, яка була випущена, у такому форматі:
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, оновити його до нової випущеної версії
легко. У вашому shell виконайте такий скрипт оновлення:
$ rustup update
Щоб видалити Rust і rustup, виконайте такий скрипт видалення у вашому shell:
$ rustup self uninstall
Читання локальної документації
Встановлення Rust також включає локальну копію документації, щоб
ви могли читати її офлайн. Запустіть rustup doc, щоб відкрити локальну документацію
у вашому браузері.
У будь-який момент, коли тип або функція надаються стандартною бібліотекою, і ви не впевнені, що вони роблять або як їх використовувати, скористайтеся документацією інтерфейсу прикладного програмування (API), щоб з’ясувати це!
Використання текстових редакторів та IDE
Ця книга не робить жодних припущень щодо того, які інструменти ви використовуєте для написання коду Rust. Підійде майже будь-який текстовий редактор! Однак багато текстових редакторів і інтегрованих середовищ розробки (IDE (скорочено від англ. integrated development environment)) мають вбудовану підтримку Rust. Ви завжди можете знайти доволі актуальний список багатьох редакторів та IDE на сторінці інструментів на вебсайті Rust.
Робота з цією книгою офлайн
У кількох прикладах ми будемо використовувати пакети Rust поза стандартною бібліотекою. Щоб
пройти ці приклади, вам або потрібно мати підключення до інтернету,
або заздалегідь завантажити ці залежності. Щоб завантажити
залежності заздалегідь, ви можете виконати такі команди. (Ми детально пояснимо,
що таке cargo і що робить кожна з цих команд, пізніше.)
$ cargo new get-dependencies
$ cd get-dependencies
$ cargo add rand@0.8.5 trpl@0.2.0
Це закешує завантаження для цих пакетів, тож вам не потрібно буде
завантажувати їх пізніше. Після того як ви виконаєте цю команду, вам не потрібно зберігати
папку get-dependencies. Якщо ви виконали цю команду, ви можете використовувати
прапорець --offline з усіма командами cargo в решті книги, щоб використовувати
ці кешовані версії замість спроби звернення до мережі.