FAQ Desarrolladores

From Dolibarr ERP CRM Wiki
Jump to navigation Jump to search

Cómo convertirse en desarrollador oficial

En la galaxia del proyecto Dolibarr, hay varias partes interesadas distribuidas en diferentes niveles o grados. El número de desarrolladores y las contribuciones son importantes y, cualquier proyecto que desee tener cierto nivel de calidad, debe de estar bajo una gestión controlada y de unas modificaciones validadas para su evolución, tanto en las necesidades funcionales como en su código. Por esta razón, el acceso en escritura a los fuentes (Servidor CVS) está limitado y regido por una organización que se describe en las líneas siguientes. Cada desarrollador tiene un grado que depende de su antigüedad y de sus contribuciones. El nivel de autorización de una persona en el proyecto aumenta con las etapas de promoción de grado.

El curso de un desarrollador Dolibarr pasa a través de estas etapas, que hemos clasificado como un título familiar para los adeptos a la ciencia ficción. Estas son las etapas. Es importante comprender que esta organización tiene el único propósito de mejorar la calidad de Dolibarr y que es necesario que se respete estrictamente a fin de lograrlo. Así que no se ofenda si, como desarrollador, no dispone de un acceso CVS en escritura, antes de un cierto plazo.


* Soldado

La primera cosa que una persona dispuesta a ayudar debe realizar es familiarizase con las reglas y normas de desarrollo.

Leyendo toda la Documentación Desarrolladores, demostrará tener voluntad suficiente para convertirse automáticamente en Soldado de la alianza Dolibarr (Su grado será un nivel de Soldado). Y acabar de leer no es lo más fácil ...

Este grado se obtiene sin validación superior.

* Cazador

El grado siguiente consiste en enviar parches, empezando por los simples, a la Lista de Correo de desarrollo (ver FAQ Desarrolladores para el procedimiento), preferiblemente al foro (Lista de Correo preferida).

Puede encontrar las tareas en espera de parche en el gestor de tareas a realizar: http://savannah.nongnu.org/task/?group=dolibarr

Las tareas disponibles son las tareas que tienen la propiedad "Task opened to external developers" a "oui". Si el valor es "non", olvídela, ya que será tratada por un desarrollador de grado Jedi.

En su primer envío aceptado (incluido en el CVS por un almirante, Jedi o Yoda), automáticamente entrará en la familia de Cazadores de la alizanda Dolibarr.

El número de cazadores no está limitado. Además, cuantos más tengamos, más fuertes seremos. Los cazadores son la principal fuerza de la alianza Dolibarr.

Una lista de los colaboradores de Dolibarr con este grado se encuentra disponible en la página Category:Chasseur

* Z-6PO

Si habla correctamente un idioma que no está presente o está mal traducido en Dolibarr, un Jedi o Yoda le dará acceso CVS para que pueda realizar commits en el CVS del proyecto, siempre que que se limite a objetivos de traducción (Ver Recuperar/actualizar una versión CVS de desarrollo para mas información). Este grado puede obtenerse con rapidez.

Una lista de los colaboradores de Dolibarr con este grado se encuentra disponible en la página Category:Z-6PO

* Almirante

Sólamente después de un tiempo variable (que puede ser muy largo) en la categoría de Cazador, y si la calidad de los parches envíados son satisfactorios, un Yoda le ofrecerá acceso directo a CVS. Se habrá convertido en un Almirante de la alianza Dolibarr.

Este título no se pide, se obtiene por decisión o proposición de un Jedi ó Yoda que ha estimado que ha enviado suficientes parches como para ser un Almirante serio. El acceso a CVS de un Almirante debe de ser utilizado para confirmar traducciones, correcciones de bugs declarados en Savannah o en el foro (tanto correcciones personales como parches enviados por un Cazador). Toda confirmación CVS debe incluir obligatoriamente en la descripción (el campo log de la confirmación), el número de bug de Savannah corregido o el título del mensaje del foro que indica el problema. Sólo una traducción escapa a esta limitación (no hay restricciones para las traducciones). El incumplimiento de esta limitación, puede dar lugar a la degradación a la categoría de Cazador. Para el envío de nuevas funcionalidades, debe seguir obligatoriamente los principios indicados acerca de los parches enviados a la Lista de Correo (Mailing List).

la obtención del grado de Almirante es rara porque está limitada. La calidad de Dolibarr sólamente puede ser mantenida con un número de Almirantes controlado, ello no implica el tener un número de desarrolladores (Cazadores) importante (gracias al sistema de parches)

Una lista de los colaboradores de Dolibarr con este grado se encuentra disponible en la página Category:Admiral

* Jedi

Después de un tiempo variable (probablemente el más largo de todos) como Almirante, y si la calidad de los parches enviados es satisfactoria, un Yoda le dirá que está autorizado para realizar confirmaciones de funcionalidades sin restricciones, a condición de la aprobación de un maestro Yoda al que explicará la funcionalidad a confirmar. Puede haber una restricción temporal definida por un Yoda debido a una próxima release cercana. Usted se convertirá en un Jedi.

Ese título no se pide, se obtiene de otro Jedi o de un Yoda.

Este privilegio, sin embargo, es excepcional. La calidad de Dolibarr sólamente puede ser mantenida con un número de Jedis controlado, ello no implica el tener un número de desarrolladores (Cazadores) importante (gracias al sistema de parches)

A list of Dolibarr contributors with this grade is available on page Category:Jedi

* Yoda

En un número de 1 a 5, los Yoda gestionan globalmente el desarrollo del proyecto. Este rango se obtiene por sucesión, a raíz de la salida de un Yoda que se retire por nominación directa o votación de los Yoda existentes

Una lista de los colaboradores de Dolibarr con este grado se encuentra disponible en la página Category:Yoda

* ¿ Y Darth Vader ?

Existe. Siempre habrán parásitos que contaminen el foro o lista de correo con mensajes o críticas no constructivas, que frenan el desarrollo de Dolibarr en lugar de ofrecer una crítica constructiva para ayudar a avanzar. Algunos son con bastante mala intención y mal tono. Son los que llamamos Darth Vader Afortunadamente, estadísticamente sólo hay constancia de la aparición y muerte de uno o dos Darth Vader por año...

El equipo actual

Ver la página Proyecto Dolibarr para obtener una lista actualizada de las personas que trabajan en cada categoría.

Iniciar el desarrollo

Consulte totalmente la Documentación Desarrolladores para asimilar todas las normas y principios exigidos a los desarrolladores. También puede consular los siguientes FAQ.

Recuperar/actualizar una versión CVS de desarrollo

Recuperación última versión de los fuentos por CVS

Para recuperar la última versión en fase de desarrollo, puede utilizar directamente el servidor CVS en modo anónimo, si dispone de un cliente CVS (comandos WinCVS ó TortoiseCVS en Windows, ó CVS en Linux, por ejemplo).

El comando que permite recuperar una instantánea integral (sin seguimiento cvs) en la carpeta actual es:

CVSROOT=:pserver:anonymous@cvs.savannah.nongnu.org:/cvsroot/dolibarr
export CVSROOT
cvs -q checkout -r HEAD dolibarr

HEAD significa que queremos la última versión en fase de desarrollo.

El comando que permite actualizar localmente una copia de trabajo CVS que ya ha sido recuperado:

En Linux:

cvs -q update -P -d

En windows con Tortoise cvs

"C:\Program Files\CVSNT\cvs.exe" -q update -P -d

Y para dejar su copia local anulando sus modificaciones con los ficheros integrados en cvs:

"C:\Program Files\CVSNT\cvs.exe" -q update -P -C -d

Si es necesario, modifique los derechos de propiead de los dosiers, para que el servidor tenga acceso.

Recuperación última versión de los fuentes por descarga

Este método permite recuperar la versión CVS de la rama principal de desarrollo (llamada HEAD). La operación consiste en recuperar la última versión de los ficheros de Dolibarr que són reagrupados cada noche en un zip. Para ello, vaya a versión CVS del día. Los nuevos archivos sobrescribirán a los antiguos.

Recuperación de otra rama en el CVS

Si desea una versión particular (con sus patchs), debe seguir el mismo procedimiento que el anterior pero sustituyendo HEAD con el nombre de la rama. Por ejemplo DOLIBARR_2_2_BRANCH para la rama 2.2 ó DOLIBARR_2_4_BRANCH para la rama 2.4.

Actualización de la base de datos

El segundo paso es migrar la base de datos. Para ello, simplemente vaya a http://midolibarr/install/ y escoja la opción "Actualizar".

Este procedimiento de migración/actualización está diseñado para funcionar independientemente del estado de inicio y puede ser realizado varias veces sin riesgo.

Cómo crear un nuevo Tema

Para ello consulte la página Temas

Cómo desarrollar mi própio sistema de menús

Para ello consulte la página Sistema de menús

Cómo desarrollar mi própio módulo

Para ello consulte la página Desarrollo de un módulo

Cómo añadir o completar una traducción

Para ello consulte la página Documentación traductores

Cambiar mi sistema de numeración de las facturas en curso

Si el nuevo sistema de numeración no entra en conflicto con el antiguo, será suficiente con ir al menú Configuración - Módulos - Configuración facturas y escojer un nuevo modelo de la lista. Si el nuevo sistema entra en conflicto, será necesario renumerar las referencias existentes. Esto se puede realizar mediante una consulta SQL. Por ejemplo, para pasar de Jupiter (FYYYYMM99) a Terre (FAYYMM-999), puede ejecutar la siguiente consulta:

update llx_facture set facnumber=concat('FA',substr(facnumber,4,4),'-',substr(facnumber,8))
where facnumber like 'F%' and facnumber not like 'FA%';

Por ejemplo, para pasar de un modelo FAYYMM999 a Terre (FAYYMM-999), puede ejecutar la siguiente consulta:

update llx_facture set facnumber=concat('FA',substr(facnumber,3,4),'-',substr(CONCAT('0000',substr(facnumber,7)),-4))
where facnumber like 'FA%' and facnumber not like '%-%';

Enviar un parche, mejora o participar en el desarrollo

Si busca como comenzar o ayudar en los desarrollos de Dolibarr, lea el capítulo FAQ Desarrolladores - Convertirse en desarrollador oficial. Si su parche ya está listo y desea distribuirlo, este capítulo es el indicado.

  • Con acceso CVS en modo escritura

A día de hoy, los accesos en escritura a CVS están restringidas (el número de confirmaciones és bastante dinámico). Si usted posee en la actualidad de un acceso en escritura CVS, utilícelo con la condición de que sus confirmaciones corresponden a su grado de desarrollador Dolibarr (Ver FAQ Desarrolladores - Convertirse en desarrollador oficial para los diferentes grados). Si no dispone de acceso a CVS (usted está en el grado de miembro o cazador de la alianza Dolibarr), deberá seguir el procedimento que sigue a continuación..

  • Sin acceso CVS en escritura

Sin acceso CVS en escritura (sin cuenta desarrollador savannah), será necesario que envíe su fichero parche a la Lista de Correo (Mailing List).

En todos los SO:

He aquí el método Pro de como trabajar para poder generar un fichero patch:

- Tener una carpeta con la versión de referencia Dolibarr (resultante de la actualización desde CVS o bien el resultante de la descompresión de un snapshot tgz de Dolibarr). Llamaremos a esta carpeta viejo_rep. Puede recuperar el snapshot de la versión de desarrollo en curso en web ofical de Dolibarr.

- Tener otra carpeta que contiene Dolibarr pero en la que realiza o ha realizado sus modificaciones. Llamará a esta carpeta nuevo_rep.

para generar el fichero patch, deberá ejecutar el comando diff (estándard de Linux, en windows cygwin) de la siguiente manera:

diff -Naur --exclude=CVS --exclude=".#*" --exclude="*~" --exclude='*.rej' --exclude='*.orig'
 --exclude="*.bak" --exclude=conf.php --exclude=documents  ancien_rep  nouveau_rep  > fichier.patch

Envíe su parche a la Lista de Correo. la integración de su parche no está garantizada, pero si el parche ha sido realizado siguiendo rigurosamente este procedimiento, tiene muchas posibilidades de que sea testeado (de otro modo las posibilidades estarán cercanas a 0).

Bajo Windows:

Si trabaja bajo Windows, un método menos Pro pero que dá el mismo resultado es el siguiente: Instale la excelente utilidad open source de comparación Winmerge, que puede realizar parches en formato diff -Naur. Para ello, compare con Winmerge el fichero de referencia y el modificado y escoja en el menú "Herramientas - Crear correción" (Générer des retouches en la versión francesa). Indicar un nombre de fichero como "resultat.patch", Marcar la casilla "Añadir" y escojer la opción de estilo "Unificado" (Style : unifié en la versión francesa). Haga clic en "Aceptar". Repetir el proceso para cada fichero modificado. Finalmente, obtendremos un bonito fichero que contiene todas las modificaciones en el formato correcto.

En lugar de buscar manualmente los archivos, si ha instalado conjuntamente TortoiseCVS y WinMerge, puede disponer de su versión modificada en el equipo, y la versión CVS en línea. En el explorador de Windows, haga clic derecho en el archivo que debe ser parchado, y seleccione "CVS comparar" (no WinMerge, que se encuentra unas pocas líneas más abajo). Tortoise pondrá en marcha WinMerge. Luego repita el procedimiento descrito anteriormente.

  • Aplicar un patch

Si su parche todavía no se ha aplicado, pero usted quiere que la aplicación en su servidor esté actualizada desde el CVS, podrá aplicarlo desde la utilidad patch.

Asumiendo que ha creado el parche desde la carpeta htdocs de su copia local modificada de la versión CVS original, y que ha enviado el parche (mifichero.patch) al servidor, a su carpeta patchs, situado al mismo nivel que su carpeta htdocs, el siguiente comando debería realizar el proceso (ejecutado desde la carpeta patchs):

patch -u -p0 -d ../htdocs < mifichero.patch

Información: -p0 permite utilizar la ruta completa tal como se indica dentro en el parche (-pn retirando los n primeros niveles del árbol de directorios) -d permite precisar la ruta relativa de la carpeta htdocs a parchear. < permite indicar la ruta hacia el fichero fuente a utilizar (el patch en modo unificado) -u permite precisar que el parche está en modo unificado

Cómo empaquetar/liberar un módulo

Para ello consulte la página Crear un paquete para liberar e instalar su módulo

¿ Cómo estar informado de lo que sucede en Dolibarr ?

Ver la página FAQ Cómo puedo estar informado de lo que sucede en Dolibarr ?