shoes4
1.0.0
Zapatos 4: la próxima versión de los zapatos
Shoes es un pequeño DSL para programación de GUI multiplataforma (Mac, Windows y Linux). Se siente como Ruby real, en lugar de solo otro envoltorio de biblioteca C ++. Para algunas muestras, el manual y un libro gratuito, visite el sitio web de Shoes.
¿Quieres ver cómo se ven los zapatos? Bueno, ¡aquí vas! Dado el guión:
Shoes . app width : 300 , height : 200 do
background lime .. blue
stack do
para "Welcome to the world of Shoes!"
button "Click me" do alert "Nice click!" end
image "http://shoesrb.com/img/shoes-icon.png" ,
margin_top : 20 , margin_left : 10
end
endEsto da como resultado la siguiente aplicación:
El aspecto y la sensación diferirán para su sistema operativo, ya que Shoes 4 usa widgets nativos.
Muy atrás en el pasado, había un tipo llamado _ por qué. Creó un proyecto conocido como Hackety Hack para enseñar programación a todos. Para llegar a todas las esquinas de la Tierra, por qué decidió hacer que Hackety Hack funcione en Windows, Mac OS X y Linux. Este fue mucho trabajo, y por lo que decidió compartir su kit de herramientas con el mundo. Así nació Shoes.
Hola, gracias por visitar! Los zapatos 4 están en la etapa de vista previa. Actualmente es compatible con casi todos los zapatos DSL, pero todavía hay algunos lugares no compatibles y problemas conocidos. Ahora estamos lanzando regularmente versiones de vista previa actualizada a Rubygems, para una fácil instalación. ¡Si no eres demasiado aventurero, todavía puedes usar los zapatos viejos!
Hay dos formas de obtener los zapatos 4: la vista previa de la gema de lanzamiento e instalarlo directamente desde Github. Para ambos necesita una instalación actual de JRUBY.
Recomendamos usar Jruby 9.x+, con la mayoría de nuestras pruebas actualmente contra 9.1. Jruby 1.7.x puede funcionar, pero no ha sido probado desde 4.0.0.pre6.
Entonces, su primer paso es instalar un JDK (los zapatos también funcionan con OpenJDK) y Jruby. Asegúrese de obtener la versión JRUBY apropiada para su sistema operativo. En Linux/Mac también puede usar herramientas de instalación de Ruby para instalar JRuby. Por ejemplo RVM:
$ rvm install jruby
Nota de versión JDK: JRUBY Versión 9 requiere una versión JDK de 7 u 8 - JDK 9 aún no funciona con JRUBY y, por lo tanto, no con zapatos. También dentro de la versión principal de JDK, asegúrese de instalar las últimas actualizaciones, tuvimos casos en los que las versiones más nuevas resolvieron errores.
Requisito de SWT: Tenga en cuenta que los zapatos 4 se basan en SWT para su backend predeterminado. Eso generalmente no es preocupación (aparte de la necesidad de JRUBY/JDK, descrito anteriormente) ya que no tiene que instalar SWT usted mismo. Sin embargo, eso significa que tenemos los mismos requisitos básicos del sistema SWT. Para Linux eso significa que necesita GTK+> = 2.10 o> = 3.0 si lo desea. Además, a partir de ahora no hay soporte para el brazo (como necesitaría Raspberry Pi).
$ gem install shoes --pre
C:tmp> jruby -S gem install shoes --pre
Si desea estar en el borde de sangrado o desea contribuir con código, debe instalarlo directamente desde el repositorio de GitHub.
Bifurca el repositorio y clona su horquilla, o
$ git clone git://github.com/shoes/shoes4.git
Configure su entorno local
$ cd shoes4
$ gem install bundler && bundle install
Nota: Si tiene RVM, RBENV o algo así instalado, podría quejarse de que debe usar JRUBY Versión XX. Eso es porque mantenemos actualizados nuestros archivos .ruby-Versión. Sin embargo, debería poder ejecutarlo con una versión JRUBY> = 9.0.0.0, recomendamos versiones actualizadas.
Bifurca el repositorio y clona su horquilla, o
C:tmp> git clone git://github.com/shoes/shoes4.git
Configure su entorno local
C:tmp>cd shoes4
C:tmpshoes4>jruby -S gem install bundler
C:tmpshoes4>jruby -S bundle install
¡Estás listo para ir!
Los zapatos 4 vienen con un corredor de aplicaciones de línea de comandos. Simplemente pase el nombre de archivo de su aplicación Shoes.
$ bin/shoes samples/simple_sound.rb
Nota: para Windows, C:tmpshoes4>binshoes samplessimple_sound.rb Si instaló los zapatos 4 como gema, solo haga C:tmp> shoes pathtofile.rb
También hay un script de inicio de rubí simple cuando se usa el backend SWT que puede usar de la siguiente manera:
$ bin/shoes-swt samples/simple_sound.rb
Esto aún no funciona en Mac ya que JRUBY (JVM) necesita algunos parámetros adicionales. Aquí puedes hacer lo siguiente (lo que básicamente es lo que hace Bin/Shoes):
$ jruby -J-XstartOnFirstThread bin/shoes-swt samples/simple_sound.rb
Otra alternativa aún es poner require 'shoes' en la parte superior de sus aplicaciones, entonces simplemente puede hacerlo
$ jruby path/to/file.rb
En OS X aún necesita suministrar los parámetros adicionales a JRUBY
$ jruby -J-XstartOnFirstThread path/to/file.rb
Puede ejecutar rake samples y muestras aleatorias que creemos que están funcionando se ejecutará hasta que renuncie con Ctr + C. ¡Algunos de ellos son realmente simples, mientras que otras son más complejos o incluso juegos! Si nota algún problema con esas muestras, ¡háganoslo saber!
Al establecer la variable de entorno SHOES_USE_INSTALLED en True, también puede usar su versión instalada de Shoes (Comando shoes ) para ejecutar las muestras en lugar del bin/shoes locales.
El embalaje es solo un bebé, así que sé suave.
Para empaquetar una aplicación, debe instalarse la gema de los zapatos en su entorno. Si no realizó la instalación de GEM, siempre puede generar una gema e instalarla desde la fuente actual:
$ rake install:all
Ahora, puede empaquetar una aplicación. Pero primero, mira aquí:
.gemspec o un Gemfile . Utiliza Warbler, que siempre busca esos archivos. Si ejecuta las especificaciones, puede notar algunas advertencias como esta:ADVERTENCIA: los componentes de 'ruta' de Bundler no son compatibles actualmente. El componente `shoes-4.0.0.pre1 'no estaba agrupado. ¡Su aplicación puede dejar de arrancar!
Eso es una curruca hablando. En realidad, de todos modos nos escabullimos los zapatos, pero no lo digas.
Bien, ahora de verdad. Lo más simple es poner su script en un directorio por sí mismo y luego:
$ bin/shoes package --mac path/to/directory-of/your-shoes-app.rb
Esto producirá una aplicación Mac, que luego puede encontrar en path/to/directory-of/pkg/your-shoes-app.app .
También puede empaquetar una aplicación de zapatos como un frasco a través de:
$ bin/shoes package --jar path/to/directory-of/your-shoes-app.rb
Puede encontrar el frasco en el mismo directorio que el anterior, es decir, la ruta/a/directorio de/pkg/your-shoes-app.jar
Si desea más control (como si quiera nombrar su aplicación, algo además de la "aplicación Shoes", o no desea incluir todos los archivos de los que hablamos antes), haga un archivo app.yaml . Vea el ejemplo para más detalles.
Nota: Si usa una app.yaml , deberá personalizar o comentar cada opción. El ejemplo es solo un ejemplo;)
Cuando tiene un archivo app.yaml justo al lado de su script, tiene tres opciones:
$ bin/shoes package --mac path/to/directory-of/your-shoes-app.rb
$ bin/shoes package --mac path/to/directory-of/app.yaml
$ bin/shoes package --mac path/to/directory-of
El paquete encontrará sus instrucciones utilizando cualquiera de esos comandos. Nuevamente, encontrará su aplicación en el directorio pkg dentro del directorio de su proyecto. Obtenga más información en bin/shoes --help .
Ah, y también puedes ejecutar las aplicaciones de tus zapatos con bin/shoes .
¡Eso es increíble, gracias!
Puede seguir adelante y tratar de solucionar uno de nuestros problemas. Hemos introducido una nueva etiqueta 'amigable para los recién llegados' para los problemas que creemos que son adecuados para comenzar con los zapatos que contribuyen. Estos problemas son relativamente fáciles de lograr o no dependen de muchos otros códigos de zapatos (por ejemplo, características completamente nuevas) para que sea más fácil comenzar. No dude en abordar cualquier problema; lo ayudaremos si es necesario. ¡La etiqueta es solo una sugerencia! =)
También hay una lista de muestras que ya funcionan en muestras/lectura, junto con todas las otras muestras. Puede intentar obtener una nueva muestra para ejecutar. Para hacerlo, puede ejecutar rake non_samples para ejecutar una muestra aleatoria que creemos que no funciona. Si solo desea enumerar las muestras que no funcionan, también puede ejecutar rake list_non_samples .
Con todo lo que hace, asegúrese de escribir especificaciones ya que los zapatos 4 están desarrollados al estilo TDD (consulte la sección de especificaciones de ejecución a continuación). Así que asegúrese de no romper ninguna prueba :-)
Si se siente inseguro de las pruebas o su implementación, simplemente abra un problema o una solicitud de extracción. Las solicitudes de extracción no necesitan hacerse, ¡son excelentes entrantes de discusión! ¡Estamos felices de ayudarlo a preparar su contribución para fusionarse para ayudar a construir zapatos 4!
De hecho, apreciamos enormemente las solicitudes tempranas para revisar el código y ayudarlo a encontrar el camino alrededor de los zapatos 4. =)
Si tiene preguntas, también siéntase libre de pasar en el canal #Shoes en FreeNode IRC. Es posible que la gente no responda al instante, pero después de algún tiempo alguien responderá :-)
A veces también es una buena manera de refactorizar algún código o escribir algunas especificaciones para familiarizarse con un proyecto. Si desea probar este enfoque, puede echar un vistazo a nuestro clima de código para encontrar candidatos para refactorizar o después de ejecutar las especificaciones localmente, tome un pico en el directorio de cobertura y abra index.html: le muestra nuestros datos de cobertura actuales. ¿Ves algo que no está cubierto y tal vez puedas escribir una especificación para ello?
Consulte la siguiente sección para obtener información sobre cómo ejecutar las especificaciones, que se mencionaron anteriormente :-)
Los zapatos 4 se desarrollan en un estilo TDD con RSPEC. Deberías estar escribiendo y ejecutando las especificaciones :)
La forma más sencilla de hacerlo es con tareas de rastrillo.
$ bundle exec rake
(Intente rake --tasks para una lista completa)
Si desea más detalles sobre otros modos para ejecutar especificaciones, filosofía sobre cómo y qué pruebas, consulte la entrada de zapatos de prueba en el wiki.
Muy atrás en el pasado, había un tipo llamado _ por qué. Creó un proyecto conocido como Hackety Hack para enseñar programación a todos. Para llegar a todas las esquinas de la Tierra, por qué decidió hacer que Hackety Hack funcione en Windows, Mac OS X y Linux. Este fue mucho trabajo, y por lo que decidió compartir su kit de herramientas con el mundo. Así nació Shoes.
Shoes nació para enseñar programación a todos, en todos los rincones de la tierra. No es genial hacer que los nuevos programadores o programadores con mal inglés se sientan mal porque no escriben muy bien rubí / inglés. ¡Y claramente cualquier otro comentario antisocial dirigido a la religión, el origen étnico, la raza, la identidad de género de alguien o cualquiera de esas cosas personales no se tolerará aquí en la tierra de Chunky-Bacon! Si los miembros de la comunidad sienten que sus comentarios están fuera de línea en cualquier espacio de proyecto (código, problemas, salas de chat, listas de correo), le permitirán saber cómo mejorar por nuestro código de conducta.
La conclusión es: ¡Diviértete con zapatos!
Si desea mantenerse al día con lo que está sucediendo con los zapatos, puede encontrarnos en varios lugares:
¿Quieres ponerse en contacto con la comunidad de zapatos? ¡Genial! Puedes ponerte en contacto aquí:
Sin embargo, tratamos de mantener la mayoría de las discusiones sobre el desarrollo en este repositorio/sus problemas para que todos puedan verlos y buscarlas.
