{"id":26746951,"url":"https://github.com/zerasul/sgdk-instructions","last_synced_at":"2026-01-29T04:47:30.239Z","repository":{"id":75304568,"uuid":"485873165","full_name":"zerasul/sgdk-instructions","owner":"zerasul","description":"Instrucciones para taller de Mega Drive de la feriam STEM Open","archived":false,"fork":false,"pushed_at":"2024-03-22T16:40:34.000Z","size":20,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-06-04T22:29:33.099Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/zerasul.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2022-04-26T16:53:23.000Z","updated_at":"2024-12-15T14:53:33.000Z","dependencies_parsed_at":"2025-06-03T00:47:29.170Z","dependency_job_id":null,"html_url":"https://github.com/zerasul/sgdk-instructions","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/zerasul/sgdk-instructions","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zerasul%2Fsgdk-instructions","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zerasul%2Fsgdk-instructions/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zerasul%2Fsgdk-instructions/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zerasul%2Fsgdk-instructions/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/zerasul","download_url":"https://codeload.github.com/zerasul/sgdk-instructions/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zerasul%2Fsgdk-instructions/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28862757,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-28T22:56:21.783Z","status":"online","status_checked_at":"2026-01-29T02:00:06.714Z","response_time":59,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-03-28T09:16:10.859Z","updated_at":"2026-01-29T04:47:30.218Z","avatar_url":"https://github.com/zerasul.png","language":null,"funding_links":[],"categories":[],"sub_categories":[],"readme":"# sgdk-instructions\n\n## Introducción\n\nEn 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.\n\nPara 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).\n\n## Instalación y Configuración\n\n\nDurante 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.\n\n\u003cdetails\u003e\u003csummary\u003eVisual Studio Code(Opcional)\u003c/summary\u003e\n\n Si utiliza Visual Studio Code, puede descargarlo desde la siguiente dirección:\n  \n  [https://code.visualstudio.com/](https://code.visualstudio.com/)\n  \n  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_.\n  \n  ![imagen](https://user-images.githubusercontent.com/6067824/165355160-98bf5abe-8e7f-48b8-87d6-f2e5ef588de5.png)\n\n  Para instalarlo, simplemente pulse el botón install (o instalar).\n\u003c/details\u003e\n\nEn 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.\n\n\n\n\u003cdetails\u003e\u003csummary\u003eWindows\u003c/summary\u003e\n  \n  Para instalar en windows, primero necesitaremos instalar Java a través de su JRE, como prerequisito.\n\n  Podemos decargar el Zip en la dirección: [https://jdk.java.net/22/](https://jdk.java.net/22/)\n\n  Una vez descargado y descomprimido, actualizaremos la variable de entorno PATH para añadir la dirección donde hemos actualizado.\n  \n  Una vez instalados los prerequisitos, descargaremos la ultima version del SGDK:\n  \n  [https://github.com/Stephane-D/SGDK/releases/tag/v2.00](https://github.com/Stephane-D/SGDK/releases/tag/v2.00)\n  \n  Una vez hecho esto, descomprimiremos la descarga donde más nos guste, y estableceremos la variable de entorno _GDK_.\n  \n  **NOTA**: Si se utiliza la extensión _Genesis Code_, podeis configurar la variable GDK dentro de la configuración de Visual Studio Code.\n  \n\u003c/details\u003e\n\n\u003cdetails\u003e\u003csummary\u003eLinux\u003c/summary\u003e\n\n  Para poder utilizar SGDK con Linux, puede usarse el proyecto _GENDEV_; El cual puede descargar la siguiente versión:\n  \n  [https://github.com/kubilus1/gendev/releases/tag/0.5.1](https://github.com/kubilus1/gendev/releases/tag/0.5.1)\n  \n  Puede descargar el fichero .deb (para sistemas basados en debian) o el fichero comprimido.\n  \n  Antes de instalar el .deb o descomprimir, necesita instalar las siguientes dependencias:\n  \n  ```bash\n  apt update\n  apt install texinfo default-jre\n  ```\n  \n  Una vez instaladas, puede instalar el fichero .deb o descomprimir el fichero descargado.\n  \n  ```bash\n  dpkg -i \u003cfichero.deb\u003e\n  ```\n  \n  Por último, establecer la variable de entorno _GENDEV_ a donde tenga instalado gendev.\n  \n  ```bash\n  export GENDEV=/opt/gendev\n  ```\n  \n  **NOTA**: También puede establacer el valor de esta variable, usando la configuración de Genesis Code.\n  \u003c/details\u003e\n  \n \u003cdetails\u003e\u003csummary\u003eDocker\u003c/summary\u003e\n\n 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/).\n    \n Una vez instalado, descargaremos la última versión de SGDK, y la descomprimiremos donde queramos; este paso es el mismo que para Windows:\n    \n [https://github.com/Stephane-D/SGDK/releases/tag/v1.70](https://github.com/Stephane-D/SGDK/releases/tag/v1.70)\n\n Si queremos generar la imagen, puede usarse el siguiente comando; este paso es opcional:\n    \n  ```bash\n  docker build -t sgdk .\n  ```\n    \n  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.\n    \n  Se ha generado una imagen sgdk y se ha subido a Docker Hub:\n  \n  [https://hub.docker.com/r/zerasul/sgdk](https://hub.docker.com/r/zerasul/sgdk)\n  \u003c/details\u003e\n  \n## Ejemplos\n\nEn esta sección, podremos ver como descargar y compilar los ejemplos:\n  \n### Descargar ejemplos de Github\n  \n Los ejemplos del taller (además de algunos más), los puedes encontrar en la siguiente dirección:\n  \n  [https://github.com/LaJaqueria/tallermdrive](https://github.com/LaJaqueria/tallermdrive)\n  \n  Para descargar este repositorio puede usar git:\n  \n  ```bash\n  git clone https://github.com/LaJaqueria/tallermdrive.git\n  ```\n  \n  O descargar el zip desde la web de Github\n\n### Emulador\n  \n  Para este taller, recomendamos el emulador _Blastem_; puede descargarse de la siguiente dirección:\n  \n  [https://www.retrodev.com/blastem/](https://www.retrodev.com/blastem/)\n\n  Si utiliza _Genesis Code_, puede configurar donde se encuentra el emulador en la configuración de la extensión.\n  \n  ![imagen](https://user-images.githubusercontent.com/6067824/165358702-2b6c3b57-c7e6-4089-a5cc-2fd0981803c1.png)\n\n### Compilar y ejecutar\n\n  En esta sección, vamos a mostrar como compilar y ejecutar en un emulador los ejemplos descargados.\n  \n**Windows**\n  \n  Para compilar en windows, puede usarse el siguiente comando:\n  \n  ```bash\n  %GDK%\\bin\\make -f %GDK%\\makefile.gen\n  ```\n  \n  \u003cdetails\u003e\u003csummary\u003eGenesis Code \u003c/summary\u003e\n  Puede usar el comando _Genesis Code: Compile \u0026 Run_ (Para abrir la consola de comandos usad la combinación \u003ckbd\u003ectrl\u003c/kbd\u003e+\u003ckbd\u003eMayus\u003c/kbd\u003e+\u003ckbd\u003eP\u003c/kbd\u003e.\n  \n  Además, comprueba en la configuración de Genesis Code que tiene seleccionado el Toolchain SGDK/GENDEV.\n    \n   ![imagen](https://user-images.githubusercontent.com/6067824/165360000-9e7a75b7-1a73-459c-85d6-5d4d61eaca8a.png)\n\n \u003c/details\u003e\n\n  \n **Linux**\n  \n  Para compilar en Linux, puede usarse el siguiente comando:\n  \n  ```bash\n  make -f $GENDEV/sgdk/mkfiles/makefile.gen clean all\n  ```` \n  \n  \u003cdetails\u003e\u003csummary\u003eGenesis Code \u003c/summary\u003e\n   Puede usar el comando _Genesis Code: Compile \u0026 Run_ (Para abrir la consola de comandos usad la combinación \u003ckbd\u003ectrl\u003c/kbd\u003e+\u003ckbd\u003eMayus\u003c/kbd\u003e+\u003ckbd\u003eP\u003c/kbd\u003e.\n  \n   Además, comprueba en la configuración de Genesis Code que tiene seleccionado el Toolchain SGDK/GENDEV.\n    \n   ![imagen](https://user-images.githubusercontent.com/6067824/165360000-9e7a75b7-1a73-459c-85d6-5d4d61eaca8a.png)\n\n \u003c/details\u003e\n  \n  **Docker**\n  \n  Por último, si necesita usar docker, para compilar, puede hacerlo con el siguiente comando:\n  \n  ```bash\n  docker run --rm -v $PWD:/src sgdk # En Windows, usar %CD% en vez de $PWD.\n  ```\n \n **NOTA**: En caso de usar la imagen docker que hemos dejado en Docker hub usar el siguiente comando:\n \n ```bash\n docker run --rm -v $PWD:/src zerasul/sgdk\n ```\n  \n  \u003cdetails\u003e\u003csummary\u003eGenesis Code \u003c/summary\u003e\n  Puede usar el comando \u003cem\u003eGenesis Code: Compile \u0026 Run\u003c/em\u003e (Para abrir la consola de comandos usad la combinación \u003ckbd\u003ectrl\u003c/kbd\u003e+\u003ckbd\u003eMayus\u003c/kbd\u003e+\u003ckbd\u003eP\u003c/kbd\u003e).\n  \n  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.\n    \n  ![imagen](https://user-images.githubusercontent.com/6067824/165360605-098fdac3-403f-4b88-8303-f8ad5ff99165.png)\n\n \u003c/details\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzerasul%2Fsgdk-instructions","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fzerasul%2Fsgdk-instructions","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzerasul%2Fsgdk-instructions/lists"}