ruby2d
v0.12.1
Это рубиновый 2D драгоценный камень. Проверьте сайт Ruby 2D, чтобы узнать, как начать создавать 2D -приложения в Ruby.
Чтобы поработать над драгоценным камнем на местном уровне, сначала клонируйте это репо, используя:
git clone --recursive https://github.com/ruby2d/ruby2d.git Чтобы сохранить размер этого хранилища этого исходного кода небольшим, GIT -подмодулы используются для ссылки на активы. Флаг --recursive флага гарантирует, что подмодулы инициализированы и обновляются при клонировании этого репо. Если вам случилось клонировать этот репо без флага --recursive флага, вы все равно можете инициализировать и обновить подмодули с помощью:
git submodule init
git submodule update --remote Обновите эти подмодули в любое время, используя git submodule update --remote или задача rake update .
Затем установите зависимости с Bundler, выполняя bundle install , чтобы получить драгоценные камни разработки.
Наконец, запустите rake , чтобы построить и установить драгоценный камень локально. Используйте rake dev для создания ссылок на пользовательские библиотеки (например, SDL).
Ruby 2D использует комбинацию автоматических тестов с помощью RSPEC и ручных интерактивных тестов, чтобы проверить правильность визуальной, аудио и входной функции. Создайте драгоценный камень и запустите все автоматизированные тесты, используя команду rake . Создайте и запустите интерактивный тест в test/ каталоге, используя rake test:<target> <name_of_test> , например:
# Run `test/testcard.rb` using the standard Ruby interpreter, MRI (CRuby)
rake test:cruby testcard # `test:mri` or just `test` work also
# Build `test/audio.rb` using mruby and run
rake test:mruby audio
# Build `test/mouse.rb` for the web using WebAssembly and run in the default browser
rake test:wasm mouseRuby 2D-это полностью проект с открытым исходным кодом (включая его зависимости), созданный преданными людьми, которые считают, что создание двухмерных приложений должно быть простым, естественным и радостным в духе самого рубинового языка.
Если вы хотите принять участие, есть несколько способов сделать это:
Предложите и реализуйте новые функции. ? Ruby 2d уже много делает, но есть много новых вещей, которые он мог бы сделать. Если у вас есть запрос на функцию или предложение о том, как улучшить язык, специфичный для домена, или что-то еще, чтобы добавить, удалить или изменить, откройте новую проблему и рассказать нам об этом. Если вы просто хотите небрежно рассказать о идее без давления от открытия проблемы, отправьте записку в список рассылки или пообщаться с нами на Gitter.
Добавьте поддержку для большего количества платформ. Ruby 2d стремится быть полностью кросс -платформой. Помогите нам проверить и улучшить опыт разработчика на существующих платформах и добавить новые.
Найти и исправить проблемы. ? Ваша помощь в определении и исправлении ошибок, а также повышение производительности на этом пути будет иметь решающее значение для обеспечения солидного опыта с использованием библиотеки. Проверьте трекер выпуска и сделайте это!
Напишите и просмотрите документацию. Жизненно важно для успеха каждого проекта с открытым исходным кодом-документация. Мы не достойно начали, но всегда есть больше, чтобы написать и редактировать. Просмотрите веб -сайт Ruby 2D и помогите нам определить области, чтобы добавить ясность или заполнить пробелы. В верхней части большинства страниц вы увидите ссылку на «Предложение редактирования», которая идет непосредственно к исходному файлу на веб -сайте.
Создать и улучшить примеры. ? В настоящее время мы немного освещаем образцы приложений, чтобы помочь людям начать работу. Мы хотели бы получить ваши идеи для небольших, однолетных приложений, чтобы направлять пользователей через конкретные функции или методы, которые мы собираем в репозитории примеров. Проверьте витрину, чтобы увидеть, что люди строят, и получить вдохновение.
Чтобы достичь такой простоты, многое должно произойти под капюшоном. Будь то добавление функции или исправление ошибки, попробуйте сделать следующее, чтобы убедиться, что ваш запрос на тягу объединяется. Некоторые из них могут показаться пугающими, но мы рады помочь на этом пути!
Проверьте, есть ли существующая проблема, и если нет, откройте новый, чтобы начать обсуждение. Прежде чем посвятить время и энергию идее или исправлению, давайте убедимся, что это соответствует принципам и целям проекта, и что у нас есть надежная стратегия для реализации и тестирования.
Используйте подмножество рубин, которая работает везде. Рубин 2D -приложения, конечно, написаны в Ruby. Некоторые пользователи могут выбрать использовать полную мощность языка, стандартной библиотеки и экосистемы драгоценных камней, написав интерпретируемые приложения, направленные на стандартную реализацию, MRI. Другие могут захотеть нацелиться на Интернет с помощью Webassembly, мобильных устройств или создания собственных настольных приложений, которые используют другую реализацию Ruby под названием Mruby. Ruby 2D стремится поддержать все эти варианты использования, даже с той же кодовой базой приложений. Ваш вклад должен поддерживать подмножество Ruby, которая совместима с и ведет себя аналогично через МРТ/КРУБИ и МРУБИ. Помимо чтения документации для каждой реализации Ruby, вы также можете попробовать фрагменты кода в командной строке, используя их соответствующие заполнения: irb для МРТ и mirb для Mruby.
Полное проверяйте свои изменения. В отличие от других библиотек Ruby, не все здесь может быть легко покрыто только модульными тестами. Нам также необходимо убедиться, что все выглядит правильно, входные данные работают так же, как и ожидалось, а поведение является последовательным на всех платформах Ruby 2D.
rake update , чтобы обновить подмодули version.rb , измененияv#.#.# , И напишите небольшую заметку о выпускеrake release , чтобы построить драгоценность, затем подтолкните его на Rubygems.org с gem push ruby2d-#.#.#.gem
