Guía de Mercurial

Junio de 2012 FQS

Creación de repositorio

1. En el directorio que desea crear un repositorio usar el botón derecho y en el menú desplegable seleccionar Tortoise HG.

2. Seleccionar la opción de Create Repository Here.

• Se crearán un sistema de directorios y archivos que Mercurial usa para registrar los cambios y generar las copias por cada versión confirmada (commited).

❶

❷

Nuevos archivos

1. Se pueden crear nuevos archivos copiando o creando con cualquier editor. Al encontrar un nuevo archivo, Mercurial no hace nada hasta que el archivo se añade al control de versiones. Para añadir un archivo al control de versiones use el menú desplegado con el botón derecho y elija TortoiseHg > Add Files.

2. Confirme con el botón Add en la pantalla que muestra el o los archivos y el contenido.

• El archivo se mostrará con el signo + de añadido. Todavía no tiene una versión en el registro de cambios porque no se hizo la confirmación (Commit).

❶

❷

Confirmación de cambios en un archivo

1. La confirmación se puede hacer sobre un archivo o sobre el repositorio (directorio). En el menú emergente de botón derecho elija Hg Commit…

2. Esta acción creará un registro histórico y se congelará una copia en el repositorio que siendo la última versión se conoce como Tip. En el campo de mensaje llenar un comentario describiendo el cambio.

3. Aceptar la confirmación con el Botón Commit en la pantalla Mercurial.

4. El ícono del archivo cambiará al símbolo que muestra a los archivos que no han tenido modificaciones desde la última confirmación.

❷

❸

❶

❹

Creación de copia personal de repositorio

• Desde cualquier computadora que tenga acceso al repositorio y se haya instalado los programas de mercurial se puede crear una copia controlada que permite trabajar a varias personas independientemente sin hacer modificaciones al repositorio central hasta que sean confirmadas.

• El control de versiones de Mercurial permite saber qué modificaciones se han hecho por cada usuario y permite la sincronización de las versiones distribuidas.

1. Usando el Explorer, en la PC cliente busque el directorio de repositorio Mercurial del que desea generar una copia controlada. Elija la opción Tortoise > Clone del menú emergente del botón derecho.

2. Se presenta la ventana de Mercurial que permite elegir el repositorio origen y el directorio que se desea convertir en su copia controlada.. Elija Clonar. Esta acción generará una copia de todos los archivos actuales en su última versión y el historial de los cambios. No es recomendable hacer una copia por los métodos del S.O. o el explorer.

• Sobre estas copias clonadas los usuarios podrán hacer sus modificaciones y crear nuevos archivos controlados. Luego revisaremos la forma de sincronizar la copia principal y las derivadas.

❶

❷

Revisión del historial

1. Desde el menú emergente dell botón derecho del repositorio seleccionado, elija la opción Hg Workbench.

2. Aparece la pantalla de historial de repositorio. El historial se compone de una serie de cambios o Changesets.

3. Cada Changeset tiene un secuencia o número que va del 0 al número de cambios que se encuentre en este repositorio. El Changeset se asocia a un identificador o toquen que son 12 dígitos exadecimales que aparecen entre paréntesis después de número de Chageset. Este toquen permite identificar el mismo Chageset entre varias copias distribuidas del mismo repositorio maestro.

4. El último Chageset es conocido como tip.

5. Al seleccionar un Changeset en la parte inferior se detallan los cambios de ese Commit.

❶

❷

❸

❹

❺

Actualizaciones locales

• Cuando se trabaja en un repositorio copia de un maestro, se modifican los archivos que están en el directorio de trabajo, es decir los que aparecen en los directorios de sistema de archivos normal. El historial Mercurial se guarda en los directorios .hg.

• Sólo la última modificación en el directorio de trabajo se muestran. Es decir, acumula los cambios desde el último Commit (no se genera historial con los comandos save).

1. Para confirmar los cambios seleccione HG Commit… en el menú de botón derecho.

2. Emerge el formulario de Commit del Mercurial. A la izquierda aparecen los archivos describiendo es estado en comparación al tip. Los archivos que no se añadido pueden seleccionarse (Check) para incluirlos en el Changeset.

3. En la parte superior derecha debe ingresarse la descripción de los cambios que se asociará al nuevo Chageset.

4. En la parte derecha inferior se ven las modificaciones al archivo seleccionado.

5. Seleccione el botón confirmar para guardar el nuevo Chageset. Esta acción generará el historial en el repositorio local. Tener en cuenta que el maestro no ha cambiado con este procedimiento.

❶

❷ ❸

❹

❺

Comparar repositorio local y maestro

1. El local (arriba) tiene un Chageset adicional que no aparece en el maestro (abajo).

2. Los tokens en la columna de nodo coinciden porque son los mismos Changeset .

❶

❷

Actualizar el repositorio maestro

1. Para actualizar los cambios en el repositorio local, identifique los cambios con el botón de Detec ougoing changes….

2. Cuando se han encontrado los cambio haga el envío usando el botón de Push o Enviar.

3. Esta acción actualizará el repositorio maestro, sin embargo el directorio de trabajo no se actualizará. Y se creará una cabecera diferente donde está el nuevo tip importado.

4. Para actualizar el directorio de trabajo, en el menú de botón derecho del directorio elija la opción Update.

5. Sólo después de esta acción se alinean las versiones y el directorio de trabajo se actualiza con los nuevos cambios.

❶

❷

❸

❹

❺

Actualizar el repositorio local

1. Para asegurarnos que estamos trabajando sobre las última versión del repositorio maestro , entramos a la pantalla de Workbench y seleccione el botón de Check incoming changes…

2. Cuando se han encontrado los cambio jale las actualizaciones usando el botón de Pull incomin changes.. o Aceptar.

3. Esta acción actualizará el repositorio local, sin embargo el directorio de trabajo no se actualizará. Y se creará una cabecera diferente donde está el nuevo tip importado.

4. Para actualizar el directorio de trabajo, en la línea de Changeset del tip elija la opción Actualizar… del menú de botón derecho.

5. Sólo después de esta acción se alinean las versiones y el directorio de trabajo se actualiza con los nuevos cambios.

❶

❸ ❷

❹

❺