La consola de Play 2.0 es una consola de desarrollo basada en sbt que le permitirá manejar todo el ciclo de desarrollo de una aplicación de Play.

Para iniciar la consola, simplemente diríjase a cualquier carpeta con una aplicación de Play y ejecute el comando play:

$ cd /path/to/any/application
$ play 

Utilice el comando help play para obtener una ayuda básica de los comandos disponibles:

[My first application] $ help play

Para ejecutar la aplicación en modo desarrollo, utilice el comando 'run' :

[My first application] $ run

En modo desarrollo, el servidor recargará automáticamente la aplicación con cada cambio, lo cual significa que con cada pedido http Play verficiará su proyecto y recompilará los recursos requeridos. De ser necesario, la aplicación se reiniciará de manera automática.

En caso de existir algún error de compilación verá los resultados de la compilación directamente en la ventana de su explorador web:

Para frenar el servidor, presione Ctrl+D y será devuelto a la consola de Play.

En Play 2.0 también puede compilar su aplicación sin iniciar el servidor. Simplemente utilice el comando compile:

[My first application] $ compile

Tipee console para iniciar la consola interactiva de Scala, la cual le permitirá probar su aplicación de manera interactiva:

[My first application] $ console

Puede pedirle a Play que abra un puerto de depuración JPDA al iniciar la consola. Luego podrá conectarse al mismo utilizando algún debugger de Java. Para ello, utilice el comando play debug:

$ play debug

Cuando un puerto JPDA está disponible, la JVM desplegará el siguiente mensaje durante el booteo:

Listening for transport dt_socket at address: 9999

Nota: Al usar play debug el socket de JPDA se abrirá en el puerto 9999. También puede configurar la variable de entorno JPDA_PORT usted mismo ejecutando set JPDA_PORT=1234.

La consola de Play no es más que una consola de sbt, de manera que puede aprovechar todas las prestaciones de sbt, como pueden ser triggered execution.

Por ejemplo., utilizando ~ compile

[My first application] $ ~ compile

La compilación se disparará automáticamente cada vez que cambie algún archivo fuente.

Si utiliza ~ run

[My first application] $ ~ run

La aplicación se recompilará y recargará automáticamente cada vez que modifque un archivo fuente, sin tener que esperar a recibir un pedido http.

Puede hacer lo mismo con el comando ~ test, para ejecutar los tests de manera continua cada vez que modifica un archivo fuente:

[My first application] $ ~ test

También puede ejecutar los comandos directamente sin ingresar a la consola de Play. Por ejemplo, ingrese: play run:

$ play run
[info] Loading project definition from myFirstApp/project
[info] Set current project to My first application

--- (Running the application from SBT, auto-reloading is enabled) ---

[info] play - Listening for HTTP on port 9000...

(Server started, use Ctrl+D to stop and go back to the console...)

La aplicación se iniciará directamente. Cuando detenga el servidor apretando Ctrl-D, volverá a la línea de comandos del sistema operativo.

Si algo funciona mal y piensa que la causa del problema sea que el cache de sbt está corrupto, utilice el comando clean-all desde la línea de comandos de su sistema operativo para eliminar todas las carpetas generadas por sbt.

$ play clean-all

Próximos pasos: Configurando su IDE favorito