FAQ Recuperar, actualizar GIT fuentes del proyecto: Difference between revisions

From Dolibarr ERP CRM Wiki
Jump to navigation Jump to search
No edit summary
Line 15: Line 15:


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).
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).
{{ToTranslate}}
 
First, enter value of the repository with reference sources into your GIT client tool.
En primer lugar, hay que introducir el repositorio de referencia que contiene los fuentes en su cliente GIT
With Eclipse, choose "Clone GIT repository". Enter GIT URL of project to get.
Con Eclipse, seleccione "Clone GIT repository". Introduzca la URL GIT del proyecto a obtener.
GIT Url for Dolibarr official source is:
La URL GIT de los fuentes oficiales Dolibarr es:
<source lang="ini">
<source lang="ini">
git://github.com/Dolibarr/dolibarr.git
git://github.com/Dolibarr/dolibarr.git
</source>
</source>


Your GIT client will ask you to choose the branches you are interesting in. Branches not selected now could be selected later by doing a "Fetch" from the "Remotes" view, so try to choose only the branch you need. This will save you time and problems later.
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.  
 
Once this step is validated, your GIT client will download all files from remote GIT server. This may last several seconds or minutes.


Once download is finished, go into GIT view - Branches - Local. In most cases, the branch you choosed should be already available.
Una vez realizado este paso, su cliente GIT descargará todos los archivos desde el servidor remoto GIT. Esto puede durar varios segundos o minutos.
If not, right click on "Branches - Remotes - The branch you want to duplicate locally".
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.
If you choose "Create Branch", this will duplicate content of branch to work on it locally.
De lo contrario, haga clic con el botón derecho en "Branches - Remotes - La rama que desea duplicar localmente".
If you Choose "Checkout", this will update the view "Working Directory".
Si elige "Create Branch", duplicará el contenido de la rama para trabajar en local.
Si elige "Checkout", actualizará la vista "Working Directory".


Once your branch is created locally, create a PHP project from your Eclipse assistant by choosing "'''Create from existing project'''" and select directory that is your GIT local repository (Do not choose to create a PHP project from scratch).
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).


Then right click on project from your Eclipse workspace and Choose "'''Team - Share'''". Select GIT and click on option "'''Use or create repository in parent folder of project'''".
Then right click on project from your Eclipse workspace and Choose "'''Team - Share'''". Select GIT and click on option "'''Use or create repository in parent folder of project'''".


=Get last version of sources using a full GIT access=
=Obtener la última versión de los fuentes usando un acceso GIT completo=
Process is same than getting sources with anonymous access.
El proceso es el mismo que el descrito para el acceso anónimo.
However, you must before create an account on GitHub (https://github.com/) and upload a public RSA or DSA certificate into your account profile.
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


URL to use for GIT clone is same:
La URL a usar para clonar GIT es la misma:
<source lang="ini">
<source lang="ini">
git@github.com:Dolibarr/dolibarr.git
git@github.com:Dolibarr/dolibarr.git
</source>
</source>


Note that a HTTP URL is also available but it's sometimes offline (so use first one instead):
Tenga en cuenta que hay disponible una URL HTTP, aunque a veces está fuera de línea:
<source lang="ini">
<source lang="ini">
https://yourgitlogin@github.com/Dolibarr/dolibarr.git
https://yourgitlogin@github.com/Dolibarr/dolibarr.git
</source>
</source>


=Update your repository=
=Actualizar su repositorio=
To update your local workspace, right click on Eclipse project and select "Pull".
Para actualizar su workspace local, haga clic con el botón derecho en el proyecto de Eclipse y seleccione "Pull".
If made some changes into your Eclipse workspace on files that were changed into the GIT remote reference, your GIT client will make a merge automatically and will mark all conflict files as "conflict" (See later to solve this state). If not, you will get all new version files including all your changes.
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.


=Commit and publish your changes=
=Comitear y publicar sus cambios=
To commit changes you made into your local repository, right click on file or directory to commit. This will validate changes into your local repository.
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.


To upload them on the remote GIT repository, right click on project and choose "'''Team - Push to Upstream'''".
Para subirlos al repositorio remoto GIT, haga clic con el botón derecho en el proyecto y escoja "'''Team - Push to Upstream'''".


=Solving a conflict=
=Solucionar conflictos=
If a file has been marked as "conflict" after a Pull request, open the file to edit it.
Si un archivo ha sido marcado como "conflict" después de un Pull, abra el archivo para editarlo.
Find string "<<<<<<<<<<", you will see part of code that is conflict between "<<<<<<<<<" and ">>>>>>>>". Edit manually code lines and remove "<<<<<<<<" and ">>>>>>>". Then, go right click on file and select "Add".
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".
If you prefer to forget completely all changes you made into all files (so to restore you workspace with content of remote repository), right click on project top line and select "'''Reset'''" then "'''Hard'''" then "'''Reference - HEAD'''".  
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'''".  






More information in GIT usage is available [http://wiki.eclipse.org/EGit/User_Guide here].
Disponible más información sobre el uso de GIT en [http://wiki.eclipse.org/EGit/User_Guide here].


=Get last version of sources by download=
=Obtener la última versión de los fuentes por descarga=


This method allows you to get sources of main development branch (called HEAD): This operation consist to get last version of Dolibarr files that are packaged each night into a tgz file.
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.
For this, go on page with [http://www.dolibarr.org/downloads/cat_view/64-development-version last source version of the day].
Vaya a la página [http://www.dolibarr.org/downloads/cat_view/64-development-version last source version of the day].


New file will overwrite old one.
Los archivos antiguos serán reemplazados por los nuevos.
The inconvenient of this method is that you must download and uncompress package each time you want to get updates.
El inconveniente de este método es que debe descargar y descomprimir los paquetes cada vez que desee obtener actualizaciones.

Revision as of 13:45, 27 September 2011

En verysmall.png Page waiting for translation. To translate, create an account, go back and clic on "Modify".
Fr verysmall.png Page en attente de traduction. Pour traduire, créez un compte, revenez et cliquez sur "Modifier".
Es verysmall.png Página a traducir. Para traducirla, cree una cuenta, vuelva a la página y haga clic en "editar".
It verysmall.png Pagina da tradurre. Per tradurla, crea un utente, torna indietro e clicca su "modifica".
Pt verysmall.png Página a aguardar por tradução. Para traduzir, crie uma conta, volte atrás e clique em "Modificar".
De verysmall.png Seite wartet auf Übersetzung. Um Übersetzung zu erstellen, richte einen Account ein, geh zurück und klicke auf "bearbeiten".
Zh verysmall.png 页面等待翻译。若要翻译本页,先创建一个帐户、登录并返回本页后单击“编辑”。

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).

Then right click on project from your Eclipse workspace and Choose "Team - Share". Select GIT and click on option "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 en here.

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.