As\u00ed que partiendo de esta base, la carpeta donde se encuentra el compilador \u201cBoriel ZX Basic\u201d asumiremos que es \u201cC:\\ZXNext\\NextBuildv7\\zxbasic<\/strong>\u201d, y el emulador \u201cCSpect\u201d se encuentra en la carpeta \u201cC:\\ZXNext\\NextBuildv7\\emu\\CSpect<\/strong>\u201d<\/p>\n <\/p>\n En este art\u00edculo pretendo ayudar al lector a personalizar sus proyectos de Visual Studio. No es una biblia de la personalizaci\u00f3n de VSC, ya que es una herramienta con muchas opciones de configuraci\u00f3n y personalizaci\u00f3n.<\/p>\n Si encontr\u00e1is alguna inexactitud u omisi\u00f3n, dejadlo en los comentarios, o acudid a los canales habituales:<\/p>\n <\/p>\n VSC trabaja con \u00e1reas de trabajo, que se equiparan a directorios de nuestro disco duro. El detalle es que VSC, al abrir un \u00e1rea de trabajo o una carpeta, busca un subdirectorio que se llama \u201c.vscode\u201d, y si existe, lo utiliza como ubicaci\u00f3n de los archivos de configuraci\u00f3n del proyecto.<\/p>\n Vamos a ver las carpetas que necesitamos, y las que os sugiero yo, para gestionar vuestros proyectos:<\/p>\n El resto de contenido y carpetas lo dejo a vuestro gusto, aunque a mi personalmente me gusta utilizar una carpeta \u201c_Recursos\u201d donde tengo mis archivos de trabajo, como pueden ser las im\u00e1genes .png a partir de las que genero los sprites o los fondos de pantalla, archivos de sonido, mapeado, etc\u2026<\/p>\n Y en la ra\u00edz ponemos nuestro fichero .bas principal, es decir, el que compilaremos. En este caso, y con un gran alarde de originalidad, le he llamado \u201cEjemplo.bas\u201d.<\/p>\n <\/p>\n En esta carpeta se colocan una serie de archivos de configuraci\u00f3n, en formato .json, que Visual Studio Code utiliza para personalizar nuestro proyecto. En los ejemplos que se adjuntan a este art\u00edculo podemos ver los siguiente:<\/p>\n Contiene las extensiones que nos recomienda VSCode al abrir el proyecto. Aunque nosotros ya tenemos esas extensiones instaladas, cuando otro usuario abra nuestro c\u00f3digo fuente, su VSCode le sugerir\u00e1 las extensiones que debe instalar para poder trabajar de forma correcta.<\/p>\n En este caso, es una copia del archivo extensions.json de NextBuild en el que se nos recomienta la extensi\u00f3n NextBuild y algunas otras que nos ayudan en la edici\u00f3n.<\/p>\n Este archivo contiene opciones de configuraci\u00f3n relacionadas con los colores, el tipo de cursor, el lenguaje por defecto y el formateador (lo que da color al c\u00f3digo) a utilizar. Tambi\u00e9n lo hemos copiado de NextBuild.<\/p>\n Este es el archivo de configuraci\u00f3n m\u00e1s importante, ya que permite personalizar las tareas de compilaci\u00f3n y ejecuci\u00f3n. Y en este caso\u2026 tambi\u00e9n lo hemos tomado prestado de NextBuild, pero le hemos hecho una peque\u00f1a modificaci\u00f3n.<\/p>\n B\u00e1sicamente hemos modificado la tareas \u201cCompile ZXbasic\u201d para que ejecute el archivo \u201cScripts\/Compile.bat\u00bb.<\/p>\n Tambien hemos modificado la tarea \u201cRun in CSpect\u201d para que ejecute el archivo \u201cScripts\/Run.bat\u201d, dejando el resto como estaba, aunque se puede personalizar sin problema.<\/p>\n <\/p>\n En esta carpeta vamos a colocar los archivos que hemos referenciado en el tasks.json, aparte de los que necesitemos para poder realizar las tareas de compilaci\u00f3n y ejecuci\u00f3n.<\/p>\n Este archivo se va a ejecutar cuando se compile el proyecto, y dependiendo del tipo de proyecto, lo personalizaremos a nuestro gusto.<\/p>\n Por ejemplo, para compilar nuestro programa para Spectrum cl\u00e1sico, el fichero \u201cCompile.bat\u201d ser\u00eda algo as\u00ed:<\/p>\n El fichero est\u00e1 dividido en cuatro secciones:<\/p>\n En la primera eliminamos los archivos resultantes de compilaciones anteriores. Esto es \u00fatil para evitar confusiones. M\u00e1s de una vez os habr\u00e1 pasado que el compilador da un error y est\u00e1is ejecutando un archivo antiguo en el emulador.<\/p>\n La segunda secci\u00f3n es la que compila el programa Ejemplo.bas y genera un archivo .tap con cargador y autorun, si todo ha ido bien.<\/p>\n Si la compilaci\u00f3n no ha ido bien la variable \u201cERRORLEVEL\u201d coge el valor 1, y en este caso abortamos la operaci\u00f3n saltando a la tercera secci\u00f3n, donde se informa al usuario con un mensaje y sale con un \u201cexit 1\u201d que lo que hace es que esa misma variable \u201cERRORLEVEL\u201d valga 1, lo que hace que VSCode no ejecute el archivo \u201cScripts\\Run.bat\u201d<\/p>\n Si la compilaci\u00f3n ha ido bien, se salta a \u201cendNow\u201d, que sencillamente regresa a VSCode, y este ejecuta el archivo \u201cScripts\\Run.bat\u201d.<\/p>\n En este ejemplo estamos generando un archivo .tap para Spectrum cl\u00e1sico, con el fin de no complicar demasiado el tema en el primer ejemplo, por lo que lo lanzaremos con el emulador ZXSpin, solo a modo de prueba, ya que al ser un .tap, CSpect no lo admite sin una imagen del NextOS, y no quiero complicarlo demasiado. As\u00ed que, en este primer ejemplo, el fichero \u201cRun.bat\u201d quedar\u00eda as\u00ed:<\/p>\n Una vez visto como funciona en cl\u00e1sico, vamos a complicarlo un poco m\u00e1s, y generaremos un archivo .nex con un recurso adicional que podemos cargar desde disco, y todo esto lo lanzaremos en CSpect.<\/p>\n <\/p>\n Compilar para Next es un pel\u00edn m\u00e1s complicado, ya que despu\u00e9s de compilar, hay que convertir el resultado al formato .nex:<\/p>\n Lo primero que a\u00f1adimos en el .bat es una variable llamada \u201cPROGRAMA\u201d, a la que asignaremos el nombre del fichero principal que compilamos. En nuestro ejemplo, el fichero principal se llama \u201cEjemplo.bas\u201d, as\u00ed que asignaremos el valor a la variable con la siguiente l\u00ednea:<\/p>\n Esto nos permite utilizar la variable dentro del .bat de forma repetida sin tener que cambiar demasiadas cosas en cada proyecto.<\/p>\n En esta versi\u00f3n, le pedimos al compilador que genere un archivo .bin (–output %PROGRAMA%.bin) para Next (–zxnext –arch=zxnext). Este archivo contiene la configuraci\u00f3n para que la utilidad \u201cnextcreator\u201d componga el fichero .nex que ejecutaremos en CSpect:<\/p>\n El primer detalle es que, tal como se define en la tercera l\u00ednea, el .nex va a incluir el archivo \u201csysvars.inc\u201d en el banco 10, direcci\u00f3n $1c00. Este archivo contiene las variables de configuraci\u00f3n del Spectrum, las t\u00edticas que empiezan en la direcci\u00f3n de memoria 23552. Sin estas variables, es posible que nuestro programa no funcione de forma correcta.<\/p>\n En la siguiente l\u00ednea le indicamos que el programa se ejecutar\u00e1 en la direcci\u00f3n $6000, y que el stack se coloca en la direcci\u00f3n par inmediatamente inferior: $5ffe<\/p>\n Y por \u00faltimo, le indicamos que queremos que nuestro programa se coloque en el banco de memoria 5, a partir de la direcci\u00f3n relativa $2000, que se corresponde con la direcci\u00f3n absoluta $6000.<\/p>\n Ser\u00e1 necesario reconfigurar este archivo en base a las necesidades de nuestro proyecto, pero para empezar con algo b\u00e1sico nos vale.<\/p>\n Una vez se haya compilado y generado el archivo .nex, que se coloca en la carpeta \u201cdata\u201d, podemos lanzar CSpect.<\/p>\n CSpect puede funcionar de dos maneras b\u00e1sicas: Con unidades mapeadas en nuestro disco duro, o con una tarjeta SD virtual que contiene el sistema operativo NextZXOS.<\/p>\n El caso m\u00e1s sencillo, que se basa en el mapeado de la carpeta data, en el que el archivo run.bat quedar\u00eda as\u00ed:<\/p>\n Atenci\u00f3n al par\u00e1metro \u201cmmc\u201d, tiene dos valores asignados: la carpeta \u201cdata\u201d, y el archivo \u201c.nex\u201d. Esto hace que ejecute el archivo .nex, y que el contenido de la carpeta data est\u00e9 disponible en el emulador, por ejemplo para cargar sprites, im\u00e1genes, datos, c\u00f3digo adicional, etc\u2026<\/p>\n Para copiar hacia una SD virtual, podemos utilizar la utilidad \u201chdfmonkey\u201d, que pod\u00e9is encontrar en https:\/\/github.com\/gasman\/hdfmonkey<\/a>, a\u00f1adiendo al .bat de compilaci\u00f3n o al de ejecuci\u00f3n, algunas l\u00edneas del tipo:<\/p>\n Estas dos l\u00edneas crear\u00e1n una carpeta \u201cEjemplo\u201d en la ra\u00edz del disco, copiar\u00e1 todo el contenido de la carpeta \u201cdata\u201d dentro de ese directorio y ejecutar\u00e1 el emulador cargando la imagen del sistema operativo.<\/p>\n En este caso, asumimos que el programa \u201chdfmonkey\u201d se encuentra en la carpeta \u201cC:\\ZXNext\\NextBuildv7\\emu\\CSpect\\\u201d, y que la imagen del NextZXOS se llama \u201cSDCard.img\u201d<\/p>\n <\/p>\n El c\u00f3digo de ejemplo se puede descargar desde aqu\u00ed<\/a>.<\/p>\n <\/p>\n En ese caso, recordad que pod\u00e9is conseguir soporte en:<\/p>\n <\/p>\n Especial agradecimiento a David Saphier (@em00k) por su excelente NextBuild, que me ha servido como inspiraci\u00f3n y punto de partida. Sin su ayuda no habr\u00eda sabido por d\u00f3nde empezar.<\/p>\n A Boriel por su excelente compilador y su trabajo diario.<\/p>\n Y a toda la comunidad de aficionados por alentarme a seguir con mi trabajo de difusi\u00f3n.<\/p>\n <\/p>\n","protected":false},"excerpt":{"rendered":" En art\u00edculos anteriores hemos visto c\u00f3mo preparar el ambiente de trabajo a partir de NextBuild con Visual Studio Code (VSC), pero en algunos casos queremos, o necesitamos, un poco m\u00e1s de \u201clibertad\u201d, y acabamos creando un archivo .bat para compilar y ejecutar nuestro c\u00f3digo. En este art\u00edculo veremos algunos truquillos para personalizar Visual Studio Code […]<\/p>\n","protected":false},"author":16,"featured_media":262,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_jetpack_memberships_contains_paid_content":false,"footnotes":""},"categories":[13,3,14],"tags":[7,10,19],"class_list":["post-261","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-boriel-zx-basic","category-desarrollo","category-herramientas","tag-boriel-zx-basic","tag-compiladores","tag-visual-studio-code"],"jetpack_featured_media_url":"https:\/\/specnext.dev\/es\/wp-content\/uploads\/sites\/2\/2022\/09\/12-Carpetas.png","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/specnext.dev\/es\/wp-json\/wp\/v2\/posts\/261","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/specnext.dev\/es\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/specnext.dev\/es\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/specnext.dev\/es\/wp-json\/wp\/v2\/users\/16"}],"replies":[{"embeddable":true,"href":"https:\/\/specnext.dev\/es\/wp-json\/wp\/v2\/comments?post=261"}],"version-history":[{"count":3,"href":"https:\/\/specnext.dev\/es\/wp-json\/wp\/v2\/posts\/261\/revisions"}],"predecessor-version":[{"id":267,"href":"https:\/\/specnext.dev\/es\/wp-json\/wp\/v2\/posts\/261\/revisions\/267"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/specnext.dev\/es\/wp-json\/wp\/v2\/media\/262"}],"wp:attachment":[{"href":"https:\/\/specnext.dev\/es\/wp-json\/wp\/v2\/media?parent=261"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/specnext.dev\/es\/wp-json\/wp\/v2\/categories?post=261"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/specnext.dev\/es\/wp-json\/wp\/v2\/tags?post=261"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}Objetivos<\/h1>\n
\n
\u00c1reas de trabajo en Visual Studio Code<\/h1>\n
![\"\"](\"https:\/\/specnext.dev\/es\/wp-content\/uploads\/sites\/2\/2022\/09\/12-Carpetas.png\")
<\/p>\n\n
La carpeta .vscode<\/h1>\n
extensions.json<\/h2>\n
{<\/code>
\n\u00a0\u00a0\u00a0 \"recommendations\": [<\/code>
\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 \"em00k.nextbuild\",<\/code>
\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 \"eliverlara.andromeda\",<\/code>
\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 \"maziac.nex-fileviewer\",<\/code>
\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 \"maziac.asm-code-lens\",<\/code>
\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 \"alefragnani.bookmarks\"<\/code>
\n\u00a0\u00a0\u00a0 ]<\/code>
\n}<\/code><\/p>\nsettings.json<\/h2>\n
{<\/code>
\n\u00a0 \"editor.cursorSmoothCaretAnimation\": true,<\/code>
\n\u00a0 \"editor.cursorStyle\": \"block\",<\/code>
\n\u00a0 \"files.defaultLanguage\": \".bas\",<\/code>
\n\u00a0 \"telemetry.enableCrashReporter\": false,<\/code>
\n\u00a0 \"telemetry.enableTelemetry\": false,<\/code>
\n\u00a0 \"[bas]\": {<\/code>
\n\u00a0\u00a0\u00a0 \"editor.defaultFormatter\": \"em00k.nextbuild\",<\/code>
\n\u00a0\u00a0\u00a0 \"editor.formatOnSave\": true<\/code>
\n\u00a0 },<\/code>
\n\u00a0 \"editor.tokenColorCustomizations\": {<\/code>
\n\u00a0\u00a0\u00a0 \"comments\": \"#2ccf2c\",<\/code>
\n\u00a0\u00a0\u00a0 \"numbers\": \"#e06565\",<\/code>
\n\u00a0\u00a0\u00a0 \"keywords\": \"#f1db14\",<\/code>
\n\u00a0\u00a0\u00a0 \"functions\": \"#13ad34\"<\/code>
\n\u00a0 }<\/code>
\n}<\/code><\/p>\ntasks.json<\/h2>\n
![\"\"](\"https:\/\/specnext.dev\/es\/wp-content\/uploads\/sites\/2\/2022\/09\/12-tasks.1.png\")
<\/p>\n![\"\"](\"https:\/\/specnext.dev\/es\/wp-content\/uploads\/sites\/2\/2022\/09\/12-tasks.2.png\")
<\/p>\nLa carpeta Scripts<\/h1>\n
El archivo Compile.bat<\/h2>\n
@echo off<\/code><\/p>\necho Limpiando ficheros antiguos...<\/code>
\ndel *.tap \/Q >nul<\/code>
\ndel data\\*.* \/Q >nul<\/code><\/p>\n:COMPILAR<\/code>
\necho Compilando...<\/code>
\nC:\\ZXNext\\NextBuildv7\\zxbasic\\zxbc.exe Ejemplo.bas --org $6000 --heap-size 2048 --tap -B -a<\/code>
\nif ERRORLEVEL 1 goto compilerError<\/code>
\necho Copiando el resultado a la carpeta data...<\/code>
\ncopy Ejemplo.tap data\\Ejemplo.tap<\/code>
\ngoto endNow<\/code><\/p>\n:compilerError<\/code>
\necho -----------------------------------------------------------------------<\/code>
\necho - ERROR AL COMPILAR ---------------------------------------------------<\/code>
\necho -----------------------------------------------------------------------<\/code>
\nexit 1<\/code><\/p>\n:endNow<\/code>
\necho Compilado correctamente!<\/code><\/p>\nstart C:\\ZXSpectrum\\ZXSpin\\zxspin.exe .\\data\\Ejemplo.tap<\/code><\/p>\nArchivo compile.bat para Next<\/h2>\n
@echo on<\/code><\/p>\nset PROGRAMA=Ejemplo<\/code><\/p>\necho Limpiando ficheros antiguos...<\/code>
\ndel *.nex \/Q >nul<\/code>
\ndel *.bin \/Q >nul<\/code>
\ndel data\\*.nex \/Q >nul<\/code><\/p>\n:COMPILAR<\/code>
\necho Compilando...<\/code>
\nC:\\ZXNext\\NextBuildv7\\zxbasic\\zxbc.exe %PROGRAMA%.bas --org $6000 --heap-size 2048 \u2013mmap %PROGRAMA%.map --output %PROGRAMA%.bin --zxnext --arch=zxnext<\/code>
\nif ERRORLEVEL 1 goto compilerError<\/code><\/p>\n:BUILDNEX<\/code>
\necho Generando el archivo .nex...<\/code>
\npython C:\/ZXNext\/NextBuildv7\/zxbasic\/tools\/nextcreator.py .\/Scripts\/nex.cfg %PROGRAMA%.nex<\/code>
\nif ERRORLEVEL 1 goto compilerError<\/code>
\necho Copiando el resultado a la carpeta data...<\/code>
\ncopy %PROGRAMA%.nex data\\%PROGRAMA%.nex<\/code>
\ngoto endNow<\/code><\/p>\n:compilerError<\/code>
\necho -----------------------------------------------------------------------<\/code>
\necho - ERROR AL COMPILAR ---------------------------------------------------<\/code>
\necho -----------------------------------------------------------------------<\/code>
\nexit 1<\/code><\/p>\n:endNow<\/code>
\necho Compilado correctamente!<\/code><\/p>\nset PROGRAMA=Ejemplo<\/code><\/p>\n
\nEste archivo .bin lo convertimos a .nex con la utilidad \u201cnextcreator.py\u201d incluida en Boriel ZX Basic. Esta utilidad utiliza un archivo \u201cnex.cfg\u201d donde definimos como queremos \u201cmontar\u201d el archivo .nex<\/p>\nEl archivo nex.cfg<\/h2>\n
; Minimum core versi\u00f3n<\/code>
\n!COR3,0,0<\/code>
\n!MMU.\/Scripts\/sysvars.inc,10,$1C00<\/code>
\n!PCSP$6000,$5ffe<\/code>
\n.\\programa.bin,5,$2000<\/code><\/p>\nEl archivo run.bat<\/h2>\n
start C:\\ZXNext\\NextBuildv7\\emu\\CSpect\\CSpect.exe -w3 -16bit -brk -tv -zxnext -r -mmc=.\\data\\ .\\data\\Ejemplo.nex<\/code><\/p>\nC:\\ZXNext\\NextBuildv7\\emu\\CSpect\\hdfmonkey.exe mkdir C:\\ZXNext\\NextBuildv7 \\emu\\CSpect\\SDCard.img \\Ejemplo<\/code>
\nC:\\ZXNext\\NextBuildv7\\emu\\CSpect\\hdfmonkey.exe put C:\\ZXNext\\NextBuildv7 \\emu\\CSpect\\SDCard.img data\\*.* \\Ejemplo\\<\/code>
\nstart C:\\ZXNext\\NextBuildv7\\emu\\CSpect\\CSpect.exe -r -w3 -16bit -brk -tv -zxnext -nextrom -mmc=\" C:\\ZXNext\\NextBuildv7\\emu\\CSpect\\SDCard.img\"<\/code><\/p>\nRecursos<\/h1>\n
Todo puede salir mal<\/h1>\n
\n
Menciones y agradecimientos<\/h1>\n