Aquí se expondrán una serie de pasos para ayudar en la labor de programar para el proyecto Raydium.
En general podemos encontrarnos 2 situaciones:
1- Quieres modificar/arreglar/extender código actual de Raydium(editar archivos ya creados).
2- Quieres añadir una nueva característica a Raydium (creando nuevos ficheros).
TODO la primera situación.
Creando nuevos ficheros
El código específico de Raydium está principalmente localizado en dos carpetas:
/raydium/raydium y
/raydium/raydium/headers.
raydium/raydium contiene los ficheros .c, mientras que
raydium/raydium/headers contiene los ficheros .h.
Si queres añadir, por ejemplo, una nuevacaracteristica:
tienes que crear
/raydium/raydium/nuevacaracteristica.c. Al principio del archivo puede poner:
/*
Raydium - CQFD Corp.
http://raydium.org/
License: GPL - GNU General Public License, see "gpl.txt" file.
*/
#ifndef DONT_INCLUDE_HEADERS
#include "index.h"
#else
#include "headers/nuevacaracteristica.h"
#endif
y tienes que crear
/raydium/raydium/headers/nuevacaracteristica.h. Aquí puedes poner al principio:
#ifndef _NUEVACARACTERISTICA_H
#define _NUEVACARACTERISTICA_H
#endif
Después, podras poner el código específico de la nueva funcionalidad en esos ficheros, siguiendo siempre las
ConvencionesProgramandoRaydium?.
Mas tarde, tendrás que añadir esos ficheros a la compilación.Esto se consigue editando el
Makefile de Raydium. En ese fichero tenemos que localizar la línea
HEADERS= y añadir
raydium/headers/nuevacaracteristica.h.
También tendremos que editar
raydium/index.c para añadir
#include "nuevacaracteristica.c" Y por último tendremos que editar
raydium/index.h para añadir
#include "headers/nuevacaracteristica.h". Esas dos modificaciones deberían hacerse antes de la sección que empieza con la línea
#ifdef PHP_SUPPORT line (al menos en la mayoría de los casos.)
Ya por fin, con un
make clean y un
make, ya estará todo listo y compilado.
Eso debería ser suficiente.
IndiceES