Игровой движок Amethyst | 2. Начало работы
Rust Lang Сообщество - Николай КалугинНастройка Rust
Мы рекомендуем использовать rustup для простой установки последней стабильной версии Rust. Инструкции должны быть на экране, как только rustup загрузится.
Если у вас уже установлен Rust, убедитесь, что вы используете последнюю версию, запустив команду:
> rustup update
Мы рекомендуем использовать стабильную версию Rust, так как Rust Nightly обычно ломаются довольно часто.
Rustup можно настроить по умолчанию на стабильную версию, запустив команду:
> rustup default stable
Требуемые зависимости
Пожалуйста, проверьте раздел зависимостей README.md для получения подробной информации о том, какие зависимости необходимы для компиляции Amethyst.
Обратите внимание, что вам необходимо установить функциональный графический драйвер. Если вы получаете ошибку из-за того, что средство рендеринга не может создать контекст рендеринга при попытке запустить пример, возможно проблема в неправильной установке драйвера.
Настройка Amethyst
Вы можете использовать Amethyst CLI или cargo для настройки вашего проекта.
От автора перевода: для меня, единственным способом заставить работать Amethyst был стартовый проект, о котором написано ниже. Возможно в вашем случае всё будет в порядке. При использовании стартового проекта, можно заменить версию пакета Amethyst в файле Cargo.toml на самую свежую.Amethyst CLI
Если вы хотите использовать инструмент Amethyst CLI, вы можете установить его командой:
> cargo install amethyst_tools
а затем запустить командой:
> amethyst new name
Вы должны получить Cargo.toml, src/main.rs и config/display.ron.
Стартовый проект
Если вы хотите начать играть с Amethyst как можно быстрее, вы также можете использовать стартовые проекты. Они специально созданы для определенных типов игр и предоставят вам основу, необходимую для немедленного начала.
Файл README.md содержит все, что вам нужно знать для запуска начального проекта.
Примечание: прямо сейчас единственный доступный стартовый проект для 2D-игр. Со временем появиться больше вариантов для разных типов игр.
Ручная настройка
Если вы делаете это с помощью cargo, вот что вам нужно сделать:
- Добавьте Amethyst в качестве зависимости в вашем
Cargo.toml. - Создайте папку
configи поместите в нееdisplay.ron. - (Необязательно) Скопируйте код из одного из примеров аметиста.
Важное замечание о версии
Amethyst делится на две основные версии:
- Выпущенная версия crates.io, которая является последней версией, доступной на crates.io.
- Git (master) версия, которая является текущим неизданным снимком разработки Amethyst, доступным на Github.
Примечание. Вы можете узнать, какую версию книги вы просматриваете в настоящий момент, проверив URL в своем браузере. Книга/документация для мастер версии содержит «master» в адресе, версия crates.io называется «стабильной».
В зависимости от версии книги, которую вы выбрали для чтения, убедитесь, что версия Amethyst в вашем Cargo.toml соответствует этому.
Для выпущенной версии crates.io у вас должно быть что-то вроде этого:
[dependencies] amethyst = "LATEST_CRATES.IO_VERSION"
Последнюю версию crates.io можно найти здесь.
Если вы хотите использовать последние неизданные изменения, ваш файл Cargo.toml должен выглядеть следующим образом:
[dependencies]
amethyst = { git = "https://github.com/amethyst/amethyst", rev = "COMMIT_HASH" }
Часть COMMIT_HASH является необязательной. Он указывает, какой конкретный COMMIT использует ваш проект, чтобы предотвратить непредвиденный сбой при внесении изменений в версию git.
Статья была переведена для "Rust Lang Сообщества". (Ссылка на оригинал)
Если вас интересуют подобные переводы, рекомендую обратить внимание на Telegram канал - @rust_lang_ru. На котором вы можете найти статьи, переводы, новости и другие интересные материалы по языку Rust, там же вы можете обсудить всё это с единомышленниками.
Также имеется YouTube канал.
Подписывайтесь!