En este documento puedes encontrar un Resumen de las instrucciones para instalar, compilar y ejecutar todo lo necesario para el taller de Desarrollo para Sega Mega Drive celebrado en la feria "STEM Open" celebrado el 28 de Abril en Granada.
Para más información acerca del taller o ver las diapositivas, consulta el siguiente enlace.
Durante el taller, vamos a utilizar el editor Visual Studio Code; este paso es opcional, pero dejamos las instrucciones para su instalación, junto a la extensión Genesis Code.
Visual Studio Code(Opcional)
Si utiliza Visual Studio Code, puede descargarlo desde la siguiente dirección:
https://code.visualstudio.com/
Una vez descargado e instalado, puede instalar la extensión Genesis Code que utilizaremos en este taller. Para instalar una extensión, puede utilizar el gestor de extensiones del propio editor e instalar la extensión Genesis Code.
Para instalarlo, simplemente pulse el botón install (o instalar).
En primer lugar, para seguir el taller, necesitarás instalar y configurar el kit de desarrollo SGDK; seguidamente dejamos las instrucciones para instalarlo en Windows, Linux o usando contenedores Docker.
Windows
Para instalar en windows, primero necesitaremos instalar Java a través de su JRE, como prerequisito.
Podemos decargar el Zip en la dirección: https://jdk.java.net/22/
Una vez descargado y descomprimido, actualizaremos la variable de entorno PATH para añadir la dirección donde hemos actualizado.
Una vez instalados los prerequisitos, descargaremos la ultima version del SGDK:
https://github.com/Stephane-D/SGDK/releases/tag/v2.00
Una vez hecho esto, descomprimiremos la descarga donde más nos guste, y estableceremos la variable de entorno GDK.
NOTA: Si se utiliza la extensión Genesis Code, podeis configurar la variable GDK dentro de la configuración de Visual Studio Code.
Linux
Para poder utilizar SGDK con Linux, puede usarse el proyecto GENDEV; El cual puede descargar la siguiente versión:
https://github.com/kubilus1/gendev/releases/tag/0.5.1
Puede descargar el fichero .deb (para sistemas basados en debian) o el fichero comprimido.
Antes de instalar el .deb o descomprimir, necesita instalar las siguientes dependencias:
apt update
apt install texinfo default-jre
Una vez instaladas, puede instalar el fichero .deb o descomprimir el fichero descargado.
dpkg -i <fichero.deb>
Por último, establecer la variable de entorno GENDEV a donde tenga instalado gendev.
export GENDEV=/opt/gendev
NOTA: También puede establacer el valor de esta variable, usando la configuración de Genesis Code.
Docker
Podemos generar y utilizar una imagen docker con SGDK y tener toda la librería a través de un contenedor Docker. En primer lugar, necesitará instalar Docker en su Sistema. Puede encontrar las instrucciones aquí.
Una vez instalado, descargaremos la última versión de SGDK, y la descomprimiremos donde queramos; este paso es el mismo que para Windows:
https://github.com/Stephane-D/SGDK/releases/tag/v1.70
Si queremos generar la imagen, puede usarse el siguiente comando; este paso es opcional:
docker build -t sgdk .
Esto tardara un rato; ya que tendrá que instalar y configurar todas las dependencias. Una vez hecho esto, ya podemos utilizar SGDK a través de Docker.
Se ha generado una imagen sgdk y se ha subido a Docker Hub:
En esta sección, podremos ver como descargar y compilar los ejemplos:
Los ejemplos del taller (además de algunos más), los puedes encontrar en la siguiente dirección:
https://github.com/LaJaqueria/tallermdrive
Para descargar este repositorio puede usar git:
git clone https://github.com/LaJaqueria/tallermdrive.git
O descargar el zip desde la web de Github
Para este taller, recomendamos el emulador Blastem; puede descargarse de la siguiente dirección:
https://www.retrodev.com/blastem/
Si utiliza Genesis Code, puede configurar donde se encuentra el emulador en la configuración de la extensión.
En esta sección, vamos a mostrar como compilar y ejecutar en un emulador los ejemplos descargados.
Windows
Para compilar en windows, puede usarse el siguiente comando:
%GDK%\bin\make -f %GDK%\makefile.gen
Genesis Code
Puede usar el comando _Genesis Code: Compile & Run_ (Para abrir la consola de comandos usad la combinación ctrl+Mayus+P.Además, comprueba en la configuración de Genesis Code que tiene seleccionado el Toolchain SGDK/GENDEV.
Linux
Para compilar en Linux, puede usarse el siguiente comando:
make -f $GENDEV/sgdk/mkfiles/makefile.gen clean all
Genesis Code
Puede usar el comando _Genesis Code: Compile & Run_ (Para abrir la consola de comandos usad la combinación ctrl+Mayus+P.Además, comprueba en la configuración de Genesis Code que tiene seleccionado el Toolchain SGDK/GENDEV.
Docker
Por último, si necesita usar docker, para compilar, puede hacerlo con el siguiente comando:
docker run --rm -v $PWD:/src sgdk # En Windows, usar %CD% en vez de $PWD.
NOTA: En caso de usar la imagen docker que hemos dejado en Docker hub usar el siguiente comando:
docker run --rm -v $PWD:/src zerasul/sgdk