ruby2d
v0.12.1
Esta es la gema Ruby 2d. Consulte el sitio web de Ruby 2D para aprender cómo comenzar a construir aplicaciones 2D en Ruby.
Para trabajar en la gema localmente, primero clona este repositorio usando:
git clone --recursive https://github.com/ruby2d/ruby2d.git Para mantener el tamaño de este repositorio de código fuente pequeño, los submódulos GIT se utilizan para hacer referencia a los activos. La bandera --recursive asegura que los submódulos se inicializan y se actualicen cuando este repositorio se clona. Si le ocurrió clonar este repositorio sin el indicador --recursive , aún puede inicializar y actualizar submódulos con:
git submodule init
git submodule update --remote Actualice estos submódulos en cualquier momento utilizando git submodule update --remote o la tarea rake update .
A continuación, instale dependencias con Bundler ejecutando bundle install para obtener las gemas de desarrollo.
Finalmente, ejecute rake para construir e instalar la gema localmente. Use rake dev para construir bibliotecas de referencia de referencia de usuario (por ejemplo, SDL).
Ruby 2D utiliza una combinación de pruebas automatizadas a través de RSPEC y pruebas interactivas manuales y manuales para verificar la corrección de la funcionalidad visual, de audio y de entrada. Construya la gema y ejecute todas las pruebas automatizadas usando el comando rake . Construir y ejecutar una prueba interactiva en la test/ directorio usando rake test:<target> <name_of_test> , por ejemplo:
# 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 es un proyecto completamente abierto (incluidas sus dependencias) construido por personas dedicadas que creen que crear aplicaciones 2D debería ser simple, natural y alegre, en el espíritu del lenguaje Ruby en sí.
Si desea participar, hay varias formas de hacerlo:
Sugerir e implementar nuevas características. ? Ruby 2D ya hace mucho, pero hay muchas cosas nuevas que podría hacer. Si tiene una solicitud de función o una sugerencia sobre cómo mejorar el lenguaje específico del dominio, o algo más para agregar, eliminar o cambiar, abrir un nuevo problema y contarnos al respecto. Si solo desea hablar casualmente sobre una idea sin la presión de abrir un problema, envíe una nota a la lista de correo o chatee con nosotros en Gitter.
Agregue soporte para más plataformas. Ruby 2D tiene como objetivo ser una plataforma completamente cruzada. Ayúdenos a probar y mejorar la experiencia del desarrollador en las plataformas existentes y agregar nuevas.
Encontrar y solucionar problemas. ? Su ayuda para identificar y arreglar errores, y mejorar el rendimiento en el camino, será fundamental para garantizar que otros tengan una experiencia sólida utilizando la biblioteca. ¡Mira el rastreador de problemas y tengo en ello!
Escribir y revisar la documentación. Vitalmente importante para el éxito de cada proyecto de código abierto es la documentación. Hacemos un comienzo decente, pero siempre hay más para escribir y editar. Explore el sitio web de Ruby 2D y nos ayude a identificar áreas para agregar claridad o llenar los vacíos. En la parte superior de la mayoría de las páginas, verá un enlace a "Sugerir una edición" que va directamente al archivo fuente en el repositorio del sitio web.
Crear y mejorar ejemplos. ? Actualmente somos un poco de luz sobre aplicaciones de muestra para ayudar a la gente a comenzar. Nos encantaría obtener sus ideas para aplicaciones pequeñas de un solo archivo para guiar a los usuarios a través de características o técnicas específicas, que recopilamos en el repositorio de ejemplos. Echa un vistazo al escaparate para ver qué está construyendo la gente y obtener algo de inspiración.
Para lograr tanta simplicidad, mucho tiene que suceder debajo del capó. Ya sea que agregue una función o arregle un error, intente hacer lo siguiente para asegurarse de que su solicitud de extracción se fusione. Algunos de estos pueden parecer desalentadores, ¡pero estamos felices de ayudar en el camino!
Compruebe si hay un problema existente y, si no, abra uno nuevo para comenzar una discusión. Antes de dedicar tiempo y energía a una idea o arreglo, asegurémonos de que sea consistente con los principios y objetivos del proyecto, y que tengamos una estrategia sólida para implementar y probar.
Use un subconjunto de rubí que funcione en todas partes. Las aplicaciones Ruby 2D están, por supuesto, escritas en Ruby. Algunos usuarios pueden optar por aprovechar toda la potencia del lenguaje, la biblioteca estándar y el ecosistema de gemas escribiendo aplicaciones interpretadas dirigidas a la implementación estándar, MRI. Otros pueden querer dirigirse a la Web a través de WebAssembly, dispositivos móviles o crear aplicaciones de escritorio nativas, todo lo cual hace uso de una implementación de Ruby diferente llamada Mruby. Ruby 2D tiene como objetivo admitir todos estos casos de uso, incluso con la misma base de código de la aplicación. Su contribución debe soportar un subconjunto de rubí que sea compatible y se comporta de manera similar a través de MRI/Cruby y Mruby. Más allá de leer la documentación para cada implementación de Ruby, también puede probar fragmentos de código en la línea de comandos utilizando sus respectivas reples: irb para MRI y mirb para Mruby.
Prueba de manera integral su cambio. A diferencia de otras bibliotecas de Ruby, no todo aquí se puede cubrir fácilmente con pruebas unitarias solas. También debemos asegurarnos de que las cosas se vean bien, las entradas funcionan como se esperaba, y el comportamiento es consistente en todas las plataformas que Ruby 2D soporta.
rake update para actualizar los submódulos version.rb , Cambios de confirmaciónv#.#.# , Y escriba una pequeña nota de lanzamientorake release para construir la gema, luego empújala a rubygems.org con gem push ruby2d-#.#.#.gem
