Atariware Wiki: Configuración de mads con vscode

https://www.atariware.cl/wiki     Versión: 30 (13.12.2022 00:25)

Configuración de mads con vscode

Este pequeño apunte te guiara en instalar el editor visual studio code con el ensamblador más famoso de atari MADS

Software necesario


  1. MADS (Ensamblador ATARI)
  2. Atari800 y Altirra (Emuladores)
  3. Visual Studio Code (Editor versátil y liviano)
  4. Git (si quieres trabajar con control de versiones)

Instalación


Configuraciones


Una vez instalado el vscode, vamos a agregar una extensión para colorear la sintaxis del código

https://www.atariware.cl/archivos/mads/vsc01.png

Para ello hacemos clic en el icono de extensiones (1) después escribimos MADS en la caja de texto de búsqueda de extensiones (2) y por ultimo clic en instalar (3). Cuando se instala se cambiara la palabra instalar por un icono de engranaje.

Ahora veremos cómo configurar el ensamblador y emulador con tareas centro de nuestro proyecto en vscode, dentro de un nuevo proyecto

https://www.atariware.cl/archivos/mads/vsc02.png

Para crear la tarea "no olvide estar en un directorio de trabajo" nos vamos al menú principal en Terminal > Configure Tasks o presionamos CONTROL+SHIFT+B

https://www.atariware.cl/archivos/mads/vsc03.png

Como se ve nos dará una opción en la caja de texto a escoger que no existe tarea creada la pinchamos, después nos tirara otra pregunta si queremos usar la plantilla base la marcamos y por ultimo nos preguntara el tipo y seleccionamos la última que es otras para ejecutar comandos externos al vscode.

https://www.atariware.cl/archivos/mads/vsc04.png

La tarea creada quedara dentro de nuestro proyecto en el directorio .vscode y el archivo tasks.json que es donde se configura los comandos externos a ejecutar. El ejemplo que hace automático es un mensaje hola, en consola lo puede ejecutar la tarea con CONTROL+SHIFT+B

Ahora viene lo importante que es agregar el mads y los emuladores a la tarea, que sería copiar y pegar este código. Importante si usa otras rutas tiene que agregarlas.

 {
    "version": "2.0.0",
    "tasks": [
        {
            "label": "Compiler Mads",
            "type": "shell",
            "command": "mads",
            "args": [ "${file}","-o:${fileBasenameNoExtension}.xex","-l:${fileBasenameNoExtension}.lst","-ml:100","-v"],
            "problemMatcher": []
        },{
            "label": "Run Atari800",
            "type": "shell",
            "command": "atari800",
            "args": [ "${fileBasenameNoExtension}.xex"],
            "problemMatcher": []
        },{
            "label": "Run Altirra",
            "type": "shell",
            "command": "wine",
            "args": [ "/opt/Altirra/Altirra64.exe","${fileBasenameNoExtension}.xex"],
            "problemMatcher": []
        },{
            "label": "Run Altirra Win",
            "type": "shell",
            "command": "C:/Program Files/Altirra/Altirra64.exe",
            "args": [ "${fileBasenameNoExtension}.xex"],
            "problemMatcher": []            
        }
    ]
}

Explicación rápida etiqueta label : nombre de la tarea para vscode, type : tipo de comando consola, command : ejecutable a ejecutar, args : argumentos de entrada del ejecutable. Recordar si tiene configurado los path bien en el sistema operativo que usa no tiene necesitabas de poner la ubicación a mano del programa a ejecutar.

Muy importante

  • Para Windows agrege el mads.exe en el directorio en C:\Windows
  • Para Linux agregar el mads en el directorio /usr/bin/

Teclas rápidas


Ahora vamos asignar las tareas al presionar una combinación de teclas para ello presionamos CONTROL+K+S para que aparezca la configuración de teclas del vscode

https://www.atariware.cl/archivos/mads/vsc05.png

Hacemos clic en el icono de la hoja

https://www.atariware.cl/archivos/mads/vsc06.png

Nos aparecerá una página en blanco para agregar en json nuestra configuración personalizada, copiamos y pegamos
[
    {
        "key": "ctrl+alt+4",
        "command": "workbench.action.tasks.runTask",
        "args": "Run Altirra Win"
    },{
        "key": "ctrl+alt+3",
        "command": "workbench.action.tasks.runTask",
        "args": "Run Altirra"
    },{
        "key": "ctrl+alt+2",
        "command": "workbench.action.tasks.runTask",
        "args": "Run Atari800"
    },{
        "key": "ctrl+alt+1",
        "command": "workbench.action.tasks.runTask",
        "args": "Compiler Mads"
    }
]



Si compilamos y ejecutamos con altirra deberías ver lo siguiente en el emulador

https://www.atariware.cl/archivos/mads/vsc07.png