FAQ Recuperar, actualizar GIT fuentes del proyecto
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".
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.