Instalación

SIMAE está desarrollado en Java y es compatible con Windows, macOS y Linux, entre otras plataformas.

Contenidos

Plugin para Visual Studio Code

A partir de la versión 1.0 de SIMAE, el uso recomendado de la herramienta es mediante el plugin para el editor de código Visual Studio Code. Este plugin contiene características adicionales como:

  • Utilizar atajos de teclados para moverse entre marcas y leer la marca actual.
  • Utilizar hints en lugar de comentarios quitando la necesidad de editar el código para utilizar SIMAE.
  • Modificar desde vs-code el lenguaje de las marcas que se utilizará.

Este plugin demostró ser muy práctico a la hora de utilizar SIMAE, y está en contínuo desarrollo para lograr una versión estable y convertirse en el modo de uso recomendado para los usuarios de Visual Studio Code.

La extensión se encuentra disponible para su descarga directa desde el marketplace de vscode y puede instalarse mediante dos simples pasos:

  1. Presionar control + p en Visual Studio Code.
  2. Ejecutar el mandato “ext install tiflo-sf.simae”.

En caso de preferir utilizar otro IDE, SIMAE cuenta con una versión llamada “SIMAE standalone” que permite su integración en forma de macro con otros IDE, o la utilización manual de la aplicación mediante una Interfaz Gráfica de Usuario, o una Interfaz de Línea de Comandos. A continuación se muestran las diferentes alternativas de instalación manual para usuarios que no deseen utilizar el plugin de Visual Studio Code.

Alternativa 1. Instalación directa (Windows)

Para instalar SIMAE standalone en un paso descargue y ejecute el instalador para Windows siguiente:

Release Enlace directo Fecha de publicación
1.0.0 simae-instalador.exe 2024-10-07

Este instalador configura un runtime personalizado de Java y la aplicación SIMAE como archivo simae.exe con acceso directo desde el escritorio (opcional).

Alternativa 2. Instalación estándar (Windows, Linux, macOS)

Paso 1. Instalación de Runtime Java

SIMAE standalone es una aplicación Java, y requiere instalar previamente el Java Development Kit (JDK) versión 11 o posterior.

Para instalar Java, las principales versiones disponibles son:

Verifique que Java está funcionando en su sistema, para ello abra una consola que le permita escribir comandos y escriba:

java --version

Si le muestra un número de versión 11 o superior, su instalación está lista para el siguiente paso.

Paso 2. Descarga de SIMAE

Descargar la última versión de la herramienta desde el apartado Releases del repositorio.

Release Enlace directo Fecha de publicación
1.0.0 simae-0.1.0.zip 2024-10-07

Crear una carpeta para la instalación de SIMAE. La carpeta se denominará C:\simae\

Nota: Estas instrucciones utilizan la convención MS Windows para rutas de archivos. Si tiene macOS o GNU/Linux utilice la que corresponde a su sistema operativo.

Descomprimir el archivo .zip en la carpeta C:\simae\

Renombrar el archivo .jar que se encuentra en C:\simae\ a C:\simae\simae.jar.

Integración en ZinjaI (opcional)

El entorno integrado de desarrollo ZinjaI está orientado a estudiantes de programación que están tomando un curso inicial en la temática. A continuación se incluyen instrucciones para integrar la herramienta SIMAE en el IDE ZinjaI.

Básicamente, se configura una macro de manera que el código fuente en el archivo activo se marque automáticamente con una combinación de teclas o hotkey.

En ZinjaI:

1) Agregar hotkey

Dentro de las opciones desplegables en la parte superior:

Archivo->Preferencias...
  • En las opciones de la izquierda presionar General
  • Presionar Personalizar atajos de teclado
  • En el buscador escribir “herramienta”
  • Hacer click en el botón “…” a la derecha de “Herramientas -> Herramientas Personalizables -> 0
  • Presionar las teclas que se quieran usar como hotkey (se recomienda la combinación Control + Shift + A)
  • Presionar aceptar y no salir del menú preferencias

2) Agregar al menú las herramientas

  • En las opciones de la izquierda presionar Barras de herramientas.
  • Activar la opción “Herramientas”.
  • Presionar modificar, buscar la opción “0:” y activarla si no está activada.
  • Aceptar, Aceptar

3) Agregar una “Herramienta personalizable”

Dentro de las opciones desplegables en la parte superior:

Herramientas->Herramientas Personalizables->Configurar (generales)...

Y para agregar la macro usamos esta configuración:

Nombre: simae
Comando: java -jar c:\simae\simae.jar "${CURRENT_SOURCE}" -sl=es
Directorio de trabajo: vacio (no escribir nada)
Acción antes de ejecutar: Guardar el fuente actual
Ejecución asíncrona: NO
Salida (std y err): Ocultas
Acción luego de ejecutar: Recargar fuente actual
Mostrar en la barra de herramientas: SI

Finalmente, la macro se encuentra agregada al IDE.

Pestaña de ZinjaI con macros añadidas

Integración en Notepad++ (opcional)

Una vez finalizada la instalación de la herramienta, se puede agregar las macros para ejecutar SIMAE desde Notepad++.

Marcado

  1. Abrir Notepad++
  2. Presionar F5 3.Pegar en el campo de texto “Programa a ejecutar” la siguiente instrucción:
C:\simae\1.0.0\simae.exe $(FULL_CURRENT_PATH) -s
  1. Presionar el botón Guardar…
  2. En el campo de texto ‘Nombre’ colocar SIMAE MARCADO
  3. Seleccionar las opciones CTRL y ALT
  4. En la lista desplegable elegir la opción M
  5. Presionar el botón OK

Desmarcado

  1. Abrir Notepad++
  2. Presionar F5
  3. Pegar en el campo de texto ‘Programa a ejecutar’ la siguiente instrucción:
C:\simae\1.0.0\simae.exe $(FULL_CURRENT_PATH) -u
  1. Presionar el botón Guardar…
  2. En el campo de texto ‘Nombre’ colocar SIMAE DESMARCADO
  3. Seleccionar las opciones SHIFT y ALT
  4. En la lista desplegable elegir la opción B
  5. Presionar el botón OK