Как читать уроки

Прежде чем перейти к первому уроку про Rust и игры — пара практических слов о самих уроках.

Что такое консоль

В уроках часто встречается слово “консоль” или “терминал” — это программа, в которую вводят команды текстом вместо того, чтобы кликать мышкой, и компьютер их выполняет. Она понадобится уже в следующем уроке, так что полезно заранее знать, как её открыть:

• Windows — нажми Win + R, введи cmd и нажми Enter.
• macOS — нажми Cmd + Пробел, введи Terminal и нажми Enter.
• Linux — обычно это сочетание Ctrl + Alt + T, либо найди приложение «Терминал» в меню программ.

Дальше в уроках “консоль” и “терминал” — это одно и то же.

В какой папке открывается консоль

Когда открываешь консоль, она сразу “стоит” в какой-то папке — обычно это твоя домашняя папка:

• Windows — примерно C:\Users\ИмяПользователя
• macOS — примерно /Users/ИмяПользователя
• Linux — примерно /home/ИмяПользователя

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

Это важно, потому что команды вроде cargo new hello_world создают папку с проектом именно там, где сейчас “стоит” консоль. Поэтому дальше в уроках команда cd hello_world (перейти в папку проекта) работает относительно того места, где консоль была открыта.

Основные уроки и дополнительные

Уроки в разделе “Уроки” идут по порядку: каждый следующий опирается на предыдущие, и этого достаточно, чтобы дойти до конца и всё понимать. А в разделе “Дополнительно” лежат уроки в сторону — они объясняют что-то глубже, чем требуется на данный момент, но без них спокойно можно обойтись и двигаться по основному списку дальше. Если по ходу основных уроков встретилась мысль “а почему это вообще так работает” — стоит заглянуть, нет ли такого урока в дополнительных.

Если что-то не объяснено

Не в каждом уроке объясняется абсолютно всё, что есть в коде. Если какая-то конструкция встретилась, а про неё ничего не сказано — это осознанное решение, а не недосмотр: либо ей посвящён один из следующих уроков, либо на этом этапе про неё вообще не нужно знать. Спокойно продолжай — если что-то важно, к этому обязательно вернутся отдельно.

Как пользоваться примерами

Почти на каждой странице есть чёрный прямоугольник — это не картинка, а настоящая работающая игра прямо в браузере, без установки. С ней можно взаимодействовать:

• Если пример реагирует на клавиши, сначала кликни по чёрной области — так она получает фокус клавиатуры, иначе нажатия будут уходить мимо, в саму страницу.
• Значок в правом верхнем углу примера разворачивает его на весь экран — удобно, чтобы рассмотреть детали покрупнее.
• Размер экрана в примерах на сайте задан заранее: 2560 на 1920 точек. Когда ты запустишь свою программу, окно будет меньше, поэтому всё может выглядеть иначе, чем в примере: круги крупнее, а движение быстрее. Это нормально. Окно можно растянуть мышью или развернуть на весь экран, и картинка станет ближе к примеру. А как сразу открывать окно нужного размера, мы разберём в уроке «Размер окна».

В курсе много примеров, которые реагируют на нажатия клавиш — а у телефона и планшета нет физической клавиатуры, так что такие примеры на них не заработают. Лучше проходить уроки за компьютером.

Про сам код

• Фраза “замени содержимое src/main.rs на это” означает именно замену: старое содержимое файла нужно стереть полностью, а не дописывать новое поверх старого.
• Строки, начинающиеся с //, — это комментарии. Rust их полностью игнорирует, они существуют только для того, кто читает код.
• Код стоит не просто скопировать и запустить, а ещё и покрутить: поменять числа, убрать строку, попробовать что-то своё. Так быстрее всего проверить, правильно ли понял, как что работает, — сразу видно в игре, а не только в голове.
• У блоков кода есть кнопка “скопировать” в правом верхнем углу — можно не перепечатывать код руками.