kounch
09/01/2008, 10:39
Hola
aunque todavía no están todas las cosas que quería poner, el anuncio de la nueva compo para GP32 (http://compo.chemicalkungfu.de/) me ha hecho decidirme a publicar ya este tutorial y las herramientas asociadas, por si esto hace que más gente se anime a presentar algo.
El resumen rápido es el siguiente; he preparado unas plantillas de XCode (http://developer.apple.com/tools/download/) (el IDE de Apple para programar en Mac OS X) y una imagen de disco, que permiten comenzar un proyecto de programación en C (con SDL) o en Fenix para GP32. Además, he preparado también una plantilla de lenguaje para que XCode reconozca la sintaxis del código de Fenix y lo coloree adecuadamente.
Los archivos se pueden bajar de aquí:
http://homepage.mac.com/kounch/.Public/GP32%20XCode%20templates.zip (4,8MB)- Plantillas de XCode. Necesario para Fenix y SDL
http://homepage.mac.com/kounch/.Public/gp32SDKbuild_Leopard.sparsebundle.7z (16,2MB)- Imagen con compilador y librerías de C y SDL. No es necesario para Fenix
Instalación
Bajar e instalar XCode 3, que viene con los discos de instalación de Leopard, o bien se puede bajar de http://developer.apple.com/tools/download/ (el registro es gratuito).
Bajar y descomprimir las plantillas (http://homepage.mac.com/kounch/.Public/GP32%20XCode%20templates.zip).
Copiar el contenido de "Project Templates" en el directorio "/Developer/Library/Xcode/Project Templates/" y el contenido de "Specifications" en el directorio "/Developer/Library/Xcode/Specifications/" (se necesita un usuario administrador).
Sólo si se va a trabajar con C (y SDL), crear un entorno de desarrollo como se indica aquí (http://wiki.gp32spain.com/index.php/Instalaci%F3n%20de%20DevkitARM%20nativo%20para%20M ac%20OS%20X%20junto%20con%20SDL%20de%20GP32) o bien bajar la imagen que he preparado (http://homepage.mac.com/kounch/.Public/gp32SDKbuild_Leopard.sparsebundle.7z).
Uso de la plantilla de Fenix
Una vez instalado todo, cerrar si estuviera abierto XCode y volver a abrirlo. Elegir la opción "New Project" del menú "File", y elegir en la ventana que aparece GP32 y luego Fenix:
http://homepage.mac.com/kounch/GP32/Images/Imagen01.png
Elegir un nombre para el proyecto y el directorio donde se va a crear.
Una vez creado, os aparecerá la ventana del mismo:
http://homepage.mac.com/kounch/GP32/Images/Imagen02.png
Para compilar el programa y probarlo, basta con pulsar en el icono "Build"
De aquí los tres ficheros que se deben ajustar a vuestro gusto (antes de cada compilación, claro) son los siguientes:
<<nombre del projecto>>.prg Código fuente en Fenix.
<<nombre del projecto>>.bmp Icono que se mostrará en la GP32
Makefile Archivo con las reglas para compilar el proyecto poner nombre, etc. Interesante para usuarios avanzados que quieran personalizar más su programa.
Notar, si se hace doble clic sobre el archivo .prg, que XCode reconoce el tipo de archivo y colorea adecuadamente el código:
http://homepage.mac.com/kounch/GP32/Images/Imagen03.png
Después de haber compilado, se creará todo lo necesario en el directorio build de la carpeta del proyecto:
http://homepage.mac.com/kounch/GP32/Images/Imagen04.png
Para probarlo en la GP32, basta con copiar el contenido de GPMM al directorio GPMM de una tarjeta SMC y el contenido de GPSYS al directorio GPSYS de una tarjeta. Se puede usar un lector de tarjetas o, por ejemplo, mi programa iGP32 (http://igp32.sourceforge.net) para copiarlo directamente a la consola usando el cable USB.
Observar también que se crea un directorio "Mac", con un archivo test.sh:
http://homepage.mac.com/kounch/GP32/Images/Imagen05.png
Este sirve para probar (parcialmente) nuestro programa en el Mac sin necesidad de copiarlo a la GP32, hacer doble clic sobre dicho archivo test.sh para verlo.
Uso de la plantilla de SDL
Una vez instalado todo, cerrar si estuviera abierto XCode y volver a abrirlo. Elegir la opción "New Project" del menú "File", y elegir en la ventana que aparece GP32 y luego SDL.
Elegir un nombre para el proyecto y el directorio donde se va a crear.
Una vez creado, os aparecerá la ventana del mismo, similar a la que hemos visto antes, pero esta vez con un programa en C, usando las SDL de Chui.
Para compilar el programa y probarlo, basta con pulsar en el icono "Build"
De aquí los tres ficheros que se deben ajustar a vuestro gusto (antes de cada compilación, claro) son los siguientes:
<<nombre del projecto>>.c Código fuente en C.
<<nombre del projecto>>.bmp Icono que se mostrará en la GP32
Makefile Archivo con las reglas para compilar el proyecto poner nombre, etc. Interesante para usuarios avanzados que quieran personalizar más su programa.
Después de haber compilado, se creará todo lo necesario en el directorio build de la carpeta del proyecto:
Para probarlo en la GP32, basta con copiar el contenido de GPMM al directorio GPMM de una tarjeta SMC. Como he dicho antes, se puede usar un lector de tarjetas o, por ejemplo, mi programa iGP32 (http://igp32.sourceforge.net) para copiarlo directamente a la consola usando el cable USB.
Observar también que, cuando se compila para Mac OS X, se crea un directorio "Mac", con un archivo <<nombre del projecto>>. Este sirve para probar (parcialmente) nuestro programa en el Mac sin necesidad de copiarlo a la GP32, hacer doble clic sobre dicho archivo para verlo.
Notas:
El entorno sólo se ha probado en un equipo Mac con procesador Intel. No hay ninguna garantía de que funcione en PowerPC.
Cuidado al editar el .bmp del icono. No hay que alterar la paleta de color, que es la que usa la GP32. Yo he utilizado Gimp (http://gimp.org/macintosh/) para hacer modificaciones sin problemas.
El archivo Leeme.rtf adjunto a las plantillas tiene más información sobre la asignación de teclas en Fenix, la distribución exacta y significado de todos los archivos de cada plantilla, copyrights, etc.
En el directorio /bin de los proyectos de Fenix también tenéis disponibles las utilidades fpg y map para crear paquetes de archivos de Fenix y mapas. Los archivos que así se hayan creado, tendréis que copiarlos en build/GPMM/<<nombre del proyecto/ tanto para poder probarlos en el Mac, como para usarlos luego en la GP32.
La detección de sintaxis de Fenix es aún muy básica (palabras clave, paréntesis y poco más), pero estoy trabajando a ver si consigo más cosas (detección de "funciones", plegado -folding- de código, etc)
Un saludo
kounch
aunque todavía no están todas las cosas que quería poner, el anuncio de la nueva compo para GP32 (http://compo.chemicalkungfu.de/) me ha hecho decidirme a publicar ya este tutorial y las herramientas asociadas, por si esto hace que más gente se anime a presentar algo.
El resumen rápido es el siguiente; he preparado unas plantillas de XCode (http://developer.apple.com/tools/download/) (el IDE de Apple para programar en Mac OS X) y una imagen de disco, que permiten comenzar un proyecto de programación en C (con SDL) o en Fenix para GP32. Además, he preparado también una plantilla de lenguaje para que XCode reconozca la sintaxis del código de Fenix y lo coloree adecuadamente.
Los archivos se pueden bajar de aquí:
http://homepage.mac.com/kounch/.Public/GP32%20XCode%20templates.zip (4,8MB)- Plantillas de XCode. Necesario para Fenix y SDL
http://homepage.mac.com/kounch/.Public/gp32SDKbuild_Leopard.sparsebundle.7z (16,2MB)- Imagen con compilador y librerías de C y SDL. No es necesario para Fenix
Instalación
Bajar e instalar XCode 3, que viene con los discos de instalación de Leopard, o bien se puede bajar de http://developer.apple.com/tools/download/ (el registro es gratuito).
Bajar y descomprimir las plantillas (http://homepage.mac.com/kounch/.Public/GP32%20XCode%20templates.zip).
Copiar el contenido de "Project Templates" en el directorio "/Developer/Library/Xcode/Project Templates/" y el contenido de "Specifications" en el directorio "/Developer/Library/Xcode/Specifications/" (se necesita un usuario administrador).
Sólo si se va a trabajar con C (y SDL), crear un entorno de desarrollo como se indica aquí (http://wiki.gp32spain.com/index.php/Instalaci%F3n%20de%20DevkitARM%20nativo%20para%20M ac%20OS%20X%20junto%20con%20SDL%20de%20GP32) o bien bajar la imagen que he preparado (http://homepage.mac.com/kounch/.Public/gp32SDKbuild_Leopard.sparsebundle.7z).
Uso de la plantilla de Fenix
Una vez instalado todo, cerrar si estuviera abierto XCode y volver a abrirlo. Elegir la opción "New Project" del menú "File", y elegir en la ventana que aparece GP32 y luego Fenix:
http://homepage.mac.com/kounch/GP32/Images/Imagen01.png
Elegir un nombre para el proyecto y el directorio donde se va a crear.
Una vez creado, os aparecerá la ventana del mismo:
http://homepage.mac.com/kounch/GP32/Images/Imagen02.png
Para compilar el programa y probarlo, basta con pulsar en el icono "Build"
De aquí los tres ficheros que se deben ajustar a vuestro gusto (antes de cada compilación, claro) son los siguientes:
<<nombre del projecto>>.prg Código fuente en Fenix.
<<nombre del projecto>>.bmp Icono que se mostrará en la GP32
Makefile Archivo con las reglas para compilar el proyecto poner nombre, etc. Interesante para usuarios avanzados que quieran personalizar más su programa.
Notar, si se hace doble clic sobre el archivo .prg, que XCode reconoce el tipo de archivo y colorea adecuadamente el código:
http://homepage.mac.com/kounch/GP32/Images/Imagen03.png
Después de haber compilado, se creará todo lo necesario en el directorio build de la carpeta del proyecto:
http://homepage.mac.com/kounch/GP32/Images/Imagen04.png
Para probarlo en la GP32, basta con copiar el contenido de GPMM al directorio GPMM de una tarjeta SMC y el contenido de GPSYS al directorio GPSYS de una tarjeta. Se puede usar un lector de tarjetas o, por ejemplo, mi programa iGP32 (http://igp32.sourceforge.net) para copiarlo directamente a la consola usando el cable USB.
Observar también que se crea un directorio "Mac", con un archivo test.sh:
http://homepage.mac.com/kounch/GP32/Images/Imagen05.png
Este sirve para probar (parcialmente) nuestro programa en el Mac sin necesidad de copiarlo a la GP32, hacer doble clic sobre dicho archivo test.sh para verlo.
Uso de la plantilla de SDL
Una vez instalado todo, cerrar si estuviera abierto XCode y volver a abrirlo. Elegir la opción "New Project" del menú "File", y elegir en la ventana que aparece GP32 y luego SDL.
Elegir un nombre para el proyecto y el directorio donde se va a crear.
Una vez creado, os aparecerá la ventana del mismo, similar a la que hemos visto antes, pero esta vez con un programa en C, usando las SDL de Chui.
Para compilar el programa y probarlo, basta con pulsar en el icono "Build"
De aquí los tres ficheros que se deben ajustar a vuestro gusto (antes de cada compilación, claro) son los siguientes:
<<nombre del projecto>>.c Código fuente en C.
<<nombre del projecto>>.bmp Icono que se mostrará en la GP32
Makefile Archivo con las reglas para compilar el proyecto poner nombre, etc. Interesante para usuarios avanzados que quieran personalizar más su programa.
Después de haber compilado, se creará todo lo necesario en el directorio build de la carpeta del proyecto:
Para probarlo en la GP32, basta con copiar el contenido de GPMM al directorio GPMM de una tarjeta SMC. Como he dicho antes, se puede usar un lector de tarjetas o, por ejemplo, mi programa iGP32 (http://igp32.sourceforge.net) para copiarlo directamente a la consola usando el cable USB.
Observar también que, cuando se compila para Mac OS X, se crea un directorio "Mac", con un archivo <<nombre del projecto>>. Este sirve para probar (parcialmente) nuestro programa en el Mac sin necesidad de copiarlo a la GP32, hacer doble clic sobre dicho archivo para verlo.
Notas:
El entorno sólo se ha probado en un equipo Mac con procesador Intel. No hay ninguna garantía de que funcione en PowerPC.
Cuidado al editar el .bmp del icono. No hay que alterar la paleta de color, que es la que usa la GP32. Yo he utilizado Gimp (http://gimp.org/macintosh/) para hacer modificaciones sin problemas.
El archivo Leeme.rtf adjunto a las plantillas tiene más información sobre la asignación de teclas en Fenix, la distribución exacta y significado de todos los archivos de cada plantilla, copyrights, etc.
En el directorio /bin de los proyectos de Fenix también tenéis disponibles las utilidades fpg y map para crear paquetes de archivos de Fenix y mapas. Los archivos que así se hayan creado, tendréis que copiarlos en build/GPMM/<<nombre del proyecto/ tanto para poder probarlos en el Mac, como para usarlos luego en la GP32.
La detección de sintaxis de Fenix es aún muy básica (palabras clave, paréntesis y poco más), pero estoy trabajando a ver si consigo más cosas (detección de "funciones", plegado -folding- de código, etc)
Un saludo
kounch