Instalación

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

Contenidos

Alternativa 1. Instalación directa (Windows)

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

Release Enlace directo Fecha de publicación
0.3.0 simae-instalador.exe 2023-11-28

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 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
0.3.0 simae-0.3.0.zip 2023-11-28

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

Plugin para Visual Studio Code

Desde SIMAE 0.3.0, se incluye un nuevo plugin experimental que permite:

  • 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.

Las instrucciones de instalación están actualmente en construcción. No obstante, el plugin se encuentra disponible para usuarios experimentados que deseen probarlo.

Release de plugin Versión del motor Enlace directo Fecha de publicación
0.0.1 0.3.0 simae-0.0.1.vsix 2023-11-28

La extensión se encuentra también disponible en marketplace y puede instalarse presionando control + p en vscode e ingresando el siguiente mandato:

ext install tiflo-sf.simae