FAQ Recuperar, actualizar GIT fuentes del proyecto

Volver al índice
Documentación desarrolladores

Esta es información sobre cómo puede obtener los fuentes del proyecto Dolibarr. Este tutorial explica los pasos a seguir utilizando el IDE Eclipse.

Prerrequisitos

En primer lugar debe tener funcionando una instalación de Eclipse. También debe tener instalado el plugin EGit. Para ello, use la opción Find And Install process en los menús de Eclipse, añada la url de actualización de GIT:

http://download.eclipse.org/egit/updates

A continuación, seleccione la instalación de EGit.

Obtener la última versión de los fuentes usando un acceso GIT anónimo

Para obtener los fuentes con el propósito de editarlos, necesita un acceso GitHub en escritura al repositorio remoto GIT y un cliente GIT (Comando GIT en linux o el Cliente GIT en Eclipse).

En primer lugar, hay que introducir el repositorio de referencia que contiene los fuentes en su cliente GIT Con Eclipse, seleccione "Clone GIT repository". Introduzca la URL GIT del proyecto a obtener. La URL GIT de los fuentes oficiales Dolibarr es:

git://github.com/Dolibarr/dolibarr.git

Su cliente GIT le preguntará por las ramas en las que esté interesado. Las ramas no seleccionadas podrán seleccionarse después con un "Fetch" desde la vista "Remotes", así que trate de elegir sólo la rama que necesita. Esto le ahorrará tiempo y problemas en el futuro.

Una vez realizado este paso, su cliente GIT descargará todos los archivos desde el servidor remoto GIT. Esto puede durar varios segundos o minutos. Una vez haya finalizado la descarga, vaya a la vista GIT - Branches - Local. En la mayoría de los casos, la rama seleccionada debe estar ya disponible. De lo contrario, haga clic con el botón derecho en "Branches - Remotes - La rama que desea duplicar localmente". Si elige "Create Branch", duplicará el contenido de la rama para trabajar en local. Si elige "Checkout", actualizará la vista "Working Directory".

Una vez que su rama haya sido creada localmente, cree un proyecto PHP con el asistente Eclipse, eligiendo "Create from existing project" y seleccionando el directorio donde se encuentra su repositorio local GIT (No escoja crear un proyecto PHP desde cero).

Seguidamente haga clic con el botón derecho del ratón sobre el proyecto del workspace de su Eclipse y escoja "Team - Share". Seleccione GIT y haga clic en la opción "Use or create repository in parent folder of project".

Obtener la última versión de los fuentes usando un acceso GIT completo

El proceso es el mismo que el descrito para el acceso anónimo. Sin embargo, antes debe crearse una cuenta en GitHub (https://github.com/) y subir un certificado RSA o DSA público RSA o DSA a su perfil de cuenta

La URL a usar para clonar GIT es la misma:

git@github.com:Dolibarr/dolibarr.git

Tenga en cuenta que hay disponible una URL HTTP, aunque a veces está fuera de línea:

https://yourgitlogin@github.com/Dolibarr/dolibarr.git

Actualizar su repositorio

Para actualizar su workspace local, haga clic con el botón derecho en el proyecto de Eclipse y seleccione "Pull". Si ha realizado cambios en su workspace local en archivos que han cambiado en el GIT remoto, su cliente GIT realizará automáticamente un merge y marcará todos los archivos con conflictos como "conflict" (Mire más abajo para solucionarlo). Si no, usted recibirá todos los archivos de la nueva versión con los cambios incluidos.

Comitear y publicar sus cambios

Para comitear los cambios realizados en su repositorio local, haga clic con el botón derecho del ratón en el archivo o directorio a comitear. Los cambios serán validados en su repositorio local.

Para subirlos al repositorio remoto GIT, haga clic con el botón derecho en el proyecto y escoja "Team - Push to Upstream".

Añadir commits externos en su repositorio

Algunos desarrolladores pueden trabajar y comitearr en su propio repositorio Git después del fork del proyecto. Si está interesado en obtener esos cambios, Puede seguir los siguientes pasos con Eclipse:

• En primer lugar, vaya a la vista de configuración de GIT y haga clic con el botón derecho en "Remotes" en su workspace de Eclipse y elija "Create a remote..."
• Indique el nombre o el fork remoto que el desarrollador ha creado (en la mayoría de casos es el login Git del desarrollador). Por ejemplo: "thedevlogin". Elija también "Configure Fetch".
• Indique la URL del repositorio Git del desarrollador. Por ejemplo: git://github.com/thedevlogin/dolibarr.git. También añada el valor refspec para indicar la rama que desea obtener. Por ejemplo: refs/heads/master:refs/remotes/thedevlogin/master. Haga clic en "Save and Fetch". Se añadirá una nueva entrada en "Remote Tracking" que hará posible la lectura y obtención de los commits realizados en esa rama.

Ahora, vaya a la línea de comandos en su repositorio git (en muchos casos en Linux, es /home/yourlogin/git/yourdolibarr) y teclee el comando cherry-pick git:

git cherry-pick -x commitid

donde el commitid es el valor del comit id que desea obtener.

Una vez hecho esto, vuelva a Eclipse y haga un refresh del proyecto. Verá que los archivos modificados aparecen con los decoradores (con los conflictos si hay).

Solucionar conflictos

Si un archivo ha sido marcado como "conflict" después de un Pull, abra el archivo para editarlo. Busque el string "<<<<<<<<<<", verá la parte de código que provoca el conflicto entre "<<<<<<<<<" y ">>>>>>>>". Edite las líneas de código manualmente y elimine "<<<<<<<<" y ">>>>>>>". Seguidamente, haga clic con en botón derecho del ratón en el fichero y seleccione "Add". Si usted descartar por completo todos los cambios realizados en todos los archivos (restaurar su workspace con el contenido del repositorio remoto), haga clic con el botón derecho del ratón en el proyecto y seleccione "Reset", seguidamente "Hard" y "Reference - HEAD".

Disponible más información sobre el uso de GIT aquí.

Obtener la última versión de los fuentes por descarga

Este método le permite obtener las fuentes de la rama principal de desarrollo (llamada HEAD): Consiste en obtener la última versión de los archivos de Dolibarr que se empaquetan cada noche en un archivo tgz. Vaya a la página last source version of the day.

Los archivos antiguos serán reemplazados por los nuevos. El inconveniente de este método es que debe descargar y descomprimir los paquetes cada vez que desee obtener actualizaciones.