Instalación de SikuliX

Pues vamos a instalarlo. Antes de ello, necesitamos aclarar los dos posibles escenarios de uso que tiene SikuliX :

a) Programación dentro de SikuliX IDE : Como lenguaje de scripting se puede utilizar Python o Ruby. 

b) Programación directamente con la API : Esta API se distribuye en forma de una librería de clases llamada “sikulixapi.jar”. Como lenguaje se ha de utilizar Java, o cualquier otro que se integre con la JVM como Jython, JRuby, Scala o Clojure.

A lo largo de los artículos de este blog utilizaremos principalmente el primer escenario.

En la web de SikuliX  se pueden encontrar enlaces a toda la documentación, descargas, etc. Como primera lectura, es recomendable leerse la guía rápida.

Ahora mismo existen 2 ramas de desarrollo : la 1.1.x y la 2.0. Esta última exige JRE 1.8 y solo funciona en sistemas operativos de 64 bits. Además, todavía está muy verde así que utilizaré la versión 1.1.x. 

La descarga de la última versión estable 1.1.1  se puede hacer desde esta página.

Las descargas de los builds diarios se pueden hacer desde aquí.

Vamos a instalar el último build disponible en este momento de la versión 1.1.2, que es el “2017-07-26_08:07 Travis Build 48”. Lo haremos sobre sistema operativo Windows.  

Prerrequisitos
A continuación detallo los prerrequisitos que exige la instalación:

1 – Instalación del JRE o JDK.

Si el escenario de uso es el mencionado arriba como a), se necesita instalar y configurar el JRE 7 u 8.
Si el escenario es el b), se necesita instalar y configurar el JDK 7 u 8.
Es recomendable la edición de 64 bits en ambos casos.

Nota: Parece ser que hay un bug no solucionado que obliga a instalar el JDK en todos los casos bajo Windows 10.

2 – En cuanto al sistema operativo, se soportan los siguientes :

• Windows XP y superior (incluyendo Windows 10), tanto las ediciones de 32 bits como de 64 bits.
• Mac OSX 10.6 y superior (solo 64 bits).
• Linux/Unix : tiene una serie prerrequisitos. Tanto en ediciones de 32 bits como de 64 bits.

Pasos de la instalación

 

 1 – Elección de la carpeta de instalación.  

1.1    La ruta completa a la misma no ha de contener espacios en blanco o “caracteres especiales” (p.e. C:\SikuliX). Nota : Supongo que cuando los autores de SikuliX hablan de “caracteres especiales” quieren decir que, al fin y al cabo, la ruta ha de contener exclusivamente caracteres permitidos por el propio sistema operativo para este propósito. 
1.2    El usuario ha de tener permisos de escritura.
1.3    Copiar en ella el instalador.
1.4    Para evitar errores inesperados, esta carpeta debería estar vacía (excepto el propio instalador, claro).
1.5    Durante el proceso de instalación, en esta carpeta se descargarán automáticamente todos los archivos que componen el SikuliX, en función de las opciones elegidas durante el mismo.

2 – Clickar dos veces sobre el instalador.
Unos segundos después aparece el siguiente diálogo que nos invita a realizar una copia manual de seguridad de la carpeta antes de instalar. Elegimos “Sí” para continuar.

Diálogo copia de seguridad

3 – Elección de las opciones de instalación.

Diálogo con opciones de instalación

Se muestra la ventana principal de instalación donde podemos elegir cualquiera de las tres opciones disponibles. En la parte derecha de cada una de ellas hay un botón de ayuda (etiquetado con una “H”). Las opciones no son excluyentes sino adicionales.

La opción 1 instala lo necesario para desarrollar en el escenario a) comentado unos párrafos más arriba. Además, nos permite elegir el lenguaje de scripting :  Python o Ruby.

La opción 2 instala lo necesario para desarrollar en el escenario b) mencionado unos párrafos antes.

La opción 3 instala lo necesario para incluir funcionalidades de OCR en nuestro script. Para ello se usa la librería Tesseract.

Finalmente, nos permite indicar la dirección IP y puerto de nuestro proxy, en el caso de que nuestro equipo lo necesite para acceder a Internet.

Como en este blog se utilizará el escenario a), marco únicamente la opción 1 y Python como lenguaje de scripting. Por último, pulso el botón “Setup Now”.

Unos segundos después se muestra una ventana informativa resumen con las opciones elegidas y los archivos que se copiarán en el equipo. Pulsar sobre el botón “Sí”.

Diálogo con resumen opciones elegidas

A continuación se muestra una ventana informando del progreso de la descarga.

Diálogo con progreso de la descarga

4 – Decidir la versión de Jython a instalar.
Una vez termina la descarga, se muestra un diálogo preguntando por la versión de Jython que deseamos instalar. Pulsar “Sí” para descargar la 2.7.0 y “No” para la 2.5.4 rc1.

Diálogo versión Jython

Poco después se muesta una ventana informativa indicando que se están realizando tareas de configuración del entorno.

Diálogo tareas de configuración

Por último, se muestra una ventana indicando que la instalación se ha realizado correctamente.

Diálogo instalación exitosa

Y con estos pasos ya tenemos SikuliX instalado en la carpeta elegida. En nuestro caso (opción 1), se ha instalado el IDE (archivo sikulix.jar), la API (archivo sikulixapi.jar), y el ejecutor de scripts (archivo runsikulix.cmd).

Archivos instalados

 En el próximo artículo comenzaremos a jugar con el IDE.