Idioma

Ver el código de 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. ((https://mads.atari8.info MADS)) (Ensamblador ATARI)
  2. ((https://atari800.github.io Atari800)) y ((http://www.virtualdub.org/altirra.html Altirra)) (Emuladores)
  1. ((https://code.visualstudio.com Visual Studio Code)) (Editor versátil y liviano)
  1. ((https://git-scm.com Git)) (si quieres trabajar con control de versiones)
 
===Instalación===

  * **Mads :** Se descomprime la carpeta en un directorio por ejemplo C:/MADS para ((https://github.com/tebe6502/Mad-Assembler/releases Windows)), en Linux deberás ((/Guías/Compilarmadsenlinux compilar)).
  * **VSCode :** Se baja el instalador ya sea para Windows, Mac o Linux.
  * **Git :** También se baja el instalador para Windows, Mac o Linux.

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

%%(hl javascript){
    "version": "2.0.0",
    "tasks": [
        {
            "label": "Ensamblar en Mads",
            "type": "shell",
            "command": "mads",
            "args": [ "${file}","-o:${fileBasenameNoExtension}${input:tipoSalida}","-l:${fileBasenameNoExtension}.lst","-ml:100","-v"],
            "problemMatcher": []
        },
		{
            "label": "Ejecutar en Altirra",
            "type": "shell",
			"windows": {
				"command": "C:/Program Files/Altirra-4.40/Altirra64.exe",
				"args": [ "${fileBasenameNoExtension}${input:tipoSalida}"]
			},
			"linux": {
				"command": "wine",
				"args": [ "/opt/Altirra/Altirra64.exe","${fileBasenameNoExtension}${input:tipoSalida}"]
			},	
            "problemMatcher": []            
        },
        {
            "label": "Ensamblar y Ejecutar",
            "dependsOrder": "sequence",
            "dependsOn": [
                "Ensamblar en Mads",
                "Ejecutar en Altirra"
            ],
            "group": {
                "kind": "build",
                "isDefault": true
            },
            "presentation": {
                "reveal": "always",
                "focus": false,
                "panel": "shared",
                "showReuseMessage": false,
                "clear": true
            }
        }
    ],
    "inputs": [
        {
            "id": "tipoSalida",
            "description": "Selecciona el tipo de archivo:",
            "type": "pickString",
            "options": [
                ".xex",
                ".rom"
            ],
            "default": ".xex"
        }
    ]
}%%
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.
%%(info type="note" title="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 
%%(hl javascript)[
    {
        "key": "ctrl+alt+3",
        "command": "workbench.action.tasks.runTask",
        "args": "Ejecutar en Altirra"
    },{
        "key": "ctrl+alt+2",
        "command": "workbench.action.tasks.runTask",
        "args": "Ensamblar en Mads"
    },{
        "key": "ctrl+alt+1",
        "command": "workbench.action.tasks.runTask",
        "args": "Ensamblar y Ejecutar"
    }
]%%

  * Ahora ya puede ensamblar y ejecutar con **CONTROL+ALT+1** para Linux y Windows
  * Ejecutar atari800 con **CONTROL+ALT+2** para ensamblar.
  * Ejecutar altirra con **CONTROL+ALT+3** para ejecutar con Altirra. 

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

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


----
{{navigation main="/Guías" title=1}}