martes, 22 de agosto de 2017

Configuración del IDE de SikuliX

Antes de programar scripts vamos a ver los posibles parámetros que nos ofrece el IDE de SikuliX.
Primero hay que lanzar el IDE. Se puede hacer de varias formas : doble click sobre el archivo “runsikulix.cmd” o sobre el archivo “sikulix.jar”.
Para acceder a la configuración se puede usar el atajo “CTRL-P” o a través de la opción “File” --> “Preferences...”.


Opción para acceder a las preferencias
Opción para acceder a las preferencias



En la ventana de preferencias hay 3 pestañas y un botón con las opciones avanzadas (abajo, “more options...”). Vamos a ver una a una en detalle.

  • Pestaña  “Screen Capturing”
 
Pestaña "Screen Capturing"
Pestaña "Screen Capturing"

Quick capture hotkey: Atajo de teclas para hacer una captura de una sección de la pantalla con el objeto de insertarla en un script. Es lo mismo que hace el botón “Take screenshot”.
Delay before capture: Tiempo de espera desde que se pulsa el botón “Take screenshot” hasta que permite realizar la captura.
Automatic Naming: El nombre por defecto que se le da a la imagen capturada. Ofrece 3 opciones :
  • time stamp : el número de milisegundos desde 1970 (Unix timestamp).
  • text in the image : si la captura contiene un texto, intenta reconocerlo mediante el OCR y lo establece como nombre de imagen. Esto solo es posible si durante la instalación se eligió la opción 3 (instalación de Tesseract).
  • off (manual input) : no propone ninguno y te lo pregunta mediante un diálogo modal.

Independientemente de la opción elegida, siempre es recomendable darle a todas las capturas un nombre coherente y relacionado con el contenido de la imagen. Facilitará la comprensión de los scripts y la reutilización de esas imágenes.



  • Pestaña  “Text Editing”    
 
Pestaña "Text Editing"
Pestaña "Text Editing"

Tab key inserts spaces instead of tab : Permite elegir si se desea que la tecla “tab” inserte espacios en blanco o una tabulación. En el primer caso, permite elegir el número de espacios en blanco.
Font name / Size : Tipo de fuente y tamaño utilizada dentro del IDE.



  •  Pestaña  “General Settings"   
 
Pestaña "General Settings"
Pestaña "General Settings"
 
Updates : Permite habilitar las actualizaciones automáticas.
Language
: El idioma en el que se muestra la interfaz del IDE.



  • More options...
Si se pulsa el botón “more options...” se nos muestra esta ventana con opciones avanzadas.

Preferencias: more Options
Preferencias: more Options

- Options on Save

Create HTML: Al grabar el script crea un archivo HTML que lo contiene. Puede ser útil si se desea publicar el script en una página web.
Delete not used images: Si se activa, al grabar el script borra aquellas imágenes que se encuentren en la carpeta donde está almacenado pero que no se referencien a lo largo del código del script. Esto es útil para evitar que el disco se llene con imágenes que no se usan. Pero es peligroso si temporalmente quitamos una imagen de un script y elegimos la opción de grabar (“CTRL-S” o “File” --> “Save”).


- Options on Run

Autosave all : Permite que justo antes de ejecutarse un script todo el código se grabe a disco. Esto es útil en los casos que el IDE se cierre debido a una excepción no controlada durante la ejecución  del script, con lo que perdemos los últimos cambios no grabados.
Always hightlight : Si se activa esta opción, las imágenes aparecen resaltadas con un marco según van apareciendo a lo largo de la ejecución del script.


- IDE Layout

Message area at bottom: Permite elegir dónde se situa el panel de mensajes : o bien abajo o bien a la derecha. Esta opción no se puede elegir de forma individualizada sino que depende de si la opción “Activate the new layout” está activa o no.
CommandBar (old style): Permite elegir si se desea mostrar el panel de comandos de la izquierda. Esta opción no se puede elegir de forma individualizada sino que depende de si la opción “Activate the new layout” está activa o no.


- Messages to show

Permite elegir los tipos de mensajes que se muestran en el panel de mensajes según se va ejecutando el script.
Actions: Mensajes que contienen las acciones ejecutadas (click de ratón, pulsación de una tecla, etc.).
Info: Mensajes con trazas de nivel “Info”. Ya hablaremos del nivel de logs en futuros artículos.
Debug: Mensajes con trazas de nivel “Debug”. Ya hablaremos del nivel de logs en futuros artículos.


- TextSearch and OCR

Allow searching for text: Habilita la búsqueda de texto en imágenes. Requiere la instalación del OCR Tesseract. En el artículo anterior se explicaban las opciones de instalación.
Allow OCR: Habilita la extracción de texto contenido en imágenes. Requiere la instalación del OCR Tesseract. En el artículo anterior se explicaban las opciones de instalación.


- Activate the new layout

Habilita un layout diferente del IDE en el que el panel de mensajes aparece a la derecha y desaparece el panel con los comandos de la izquierda.


- ImageThumbs (on) / ImageLabels (off)

Permite elegir cómo se muestran las imágenes en los scripts. Si se habilita, se mostrará una miniatura de la imagen. Sino, se mostrará una miniatura que contiene el nombre de la imagen.


- Show script as plain text

Si se habilita esta opción, en lugar de las miniaturas de las imágenes aparece su nombre como texto plano.


Y con esto termino este artículo sobre las preferencias del IDE de SikuliX.