Instalar Haxe, HaxePunk y SublimeText 2 con el plugin de Haxe

Nota: Esta entrada fue publicada el 20 may de 2015 @ 18:27 en un blog que tenía anteriormente en Wordpress, y republicada aquí para el record.


Estoy impartiendo el Taller de Programación de Videojuegos en El Garage - ProjectHub, en el que utilizamos Haxe y el engine HaxePunk para crear videojuegos, y mis alumnos me pidieron que les escribiera las instrucciones para poder instalar y configurar todo lo que necesitan en sus computadoras, así que aquí están los pasos que se deben seguir.

Paso 1: Instalar Haxe

Entren a la página de descargas de Haxe y descarguen el instalador correspondiente a su sistema operativo (si usan Linux, les recomiendo utilizar el script que se encuentra en esta página), corran el programa y esperen a que termine.

Paso 2: Instalar HaxePunk

Al instalar Haxe, se agregó el comando haxelib , que es el que nos permite administrar las liberías de Haxe (como HaxePunk), así que abrimos el Command Prompt en Windows, o la Terminal en Linux/OSX, y escribimos

haxelib install HaxePunk

Una vez que HaxePunk termine de descargarse, debemos configurarlo con el comando

haxelib run HaxePunk setup

Paso 3: Instalar Sublime Text 2

Este paso no es necesario si piensas usar otro editor de texto, pero en el taller utilizamos este. Para instalarlo, simplemente descarga el instalador en la página web, córrelo y espera a que termine.

Paso 3.1: Instalar PackageControl

SublimeText 2 no viene por default con soporte para Haxe, así que necesitamos instalar el plugin que agrega este lenguage, pero para instalar plugins necesitamos PackageControl. Instalarlo es muy fácil: todo se explica muy bien en la página web. Una vez tengamos ST2 abierto, vamos a View > Show console , para abrir la consola de comandos de ST2, pegamos el código escrito en la página, y damos enter. Sublime te pedirá reiniciar para terminar la instalación.

Paso 3.2: Instalar el plugin de Haxe

Ya tenemos PackageControl, así que dentro de Sublime podemos presionar Ctrl + Shift + P para abrir la paleta de comandos, aquí escribimos install y seleccionamos la opción Package Control: Install Package (si casualmente te sale un mensaje de que se acaba de instalar una librería nueva y necesitas reiniciar, hazlo y vuelve a empezar este paso). Ahora debería haberse abierto un campo de texto para buscar, donde debemos poner haxe . Le damos click al primer resultado, el único que dice Haxe, y ya quedará instalado.

Paso 4: Crear un proyecto de HaxePunk

Este paso no es necesario obviamente, pero puede ser útil para corroborar que todo haya sido instalado correctamente (y también por si no sabes cómo crear un proyecto).

En la terminal escribimos

haxelib run HaxePunk new Proyecto

(Proyecto siendo el nombre que queremos darle a la carpeta de nuestro proyecto, puede ser lo que sea mientras no contenga espacios). Esto nos creará una carpeta con la siguiente estructura:

  • Proyecto/
    • assets/
      • audio/
      • font/
      • graphics/
      • HaxePunk.svg
    • src/
      • Main.hx
      • MainScene.hx
    • project.xml

El proyecto como tal ya tiene el código necesario para mostrar una ventana gris vacía, así que entramos desde la terminal a la carpeta

cd Proyecto

y corremos el programa

lime test neko

Si todo fue bien, debe de abrirse una pantalla gris. Si no pasa esto, algo fue mal durante la instalación, así que deberías verificar que seguiste todos los pasos. También es posible que algunas librerías estén en una versión incorrecta, por lo que es necesario hacerles downgrade. Al momento de escribir esto (actualizado el 11/10/2017), estas son las versiones que me funcionan en Windows y Linux:

  • Windows y Linux:
    • HaxePunk: 2.6.1
    • lime: 4.0.3
    • openfl: 4.9.2

Paso 5: ¡Estudiar Haxe y HaxePunk!

Estamos ofreciendo cursos en El Garage con este propósito, pero también hay muy buenos recursos online con los que podrías reforzar tu aprendizaje. Recomiendo especialmente haxe.org y haxepunk.com.