https://github.com/zerasul/sgdk-instructions
Instrucciones para taller de Mega Drive de la feriam STEM Open
https://github.com/zerasul/sgdk-instructions
Last synced: 5 months ago
JSON representation
Instrucciones para taller de Mega Drive de la feriam STEM Open
- Host: GitHub
- URL: https://github.com/zerasul/sgdk-instructions
- Owner: zerasul
- Created: 2022-04-26T16:53:23.000Z (about 4 years ago)
- Default Branch: main
- Last Pushed: 2024-03-22T16:40:34.000Z (about 2 years ago)
- Last Synced: 2025-06-04T22:29:33.099Z (about 1 year ago)
- Size: 19.5 KB
- Stars: 0
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# sgdk-instructions
## Introducción
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](https://docs.google.com/presentation/d/1EiIG_s2G1itPPTynk2w162dxMUYrKRXF8kGXLYqNhtc/edit?usp=sharing).
## Instalación y Configuración
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/](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](https://github.com/Stephane-D/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/](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](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](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:
```bash
apt update
apt install texinfo default-jre
```
Una vez instaladas, puede instalar el fichero .deb o descomprimir el fichero descargado.
```bash
dpkg -i
```
Por último, establecer la variable de entorno _GENDEV_ a donde tenga instalado gendev.
```bash
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í](https://docs.docker.com/engine/install/).
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](https://github.com/Stephane-D/SGDK/releases/tag/v1.70)
Si queremos generar la imagen, puede usarse el siguiente comando; este paso es opcional:
```bash
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:
[https://hub.docker.com/r/zerasul/sgdk](https://hub.docker.com/r/zerasul/sgdk)
## Ejemplos
En esta sección, podremos ver como descargar y compilar los ejemplos:
### Descargar ejemplos de Github
Los ejemplos del taller (además de algunos más), los puedes encontrar en la siguiente dirección:
[https://github.com/LaJaqueria/tallermdrive](https://github.com/LaJaqueria/tallermdrive)
Para descargar este repositorio puede usar git:
```bash
git clone https://github.com/LaJaqueria/tallermdrive.git
```
O descargar el zip desde la web de Github
### Emulador
Para este taller, recomendamos el emulador _Blastem_; puede descargarse de la siguiente dirección:
[https://www.retrodev.com/blastem/](https://www.retrodev.com/blastem/)
Si utiliza _Genesis Code_, puede configurar donde se encuentra el emulador en la configuración de la extensión.
### Compilar y ejecutar
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:
```bash
%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:
```bash
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:
```bash
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:
```bash
docker run --rm -v $PWD:/src zerasul/sgdk
```
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 Docker. Además, de comprobar que el nombre de la imagen es correcta.
