TortoiseSVN. Manual de usuario
Contents
1. Eusko Jaurlaritzaren Informatika Elkartea Sociedad Inform tica del Gobierno Vasco Fecha Referencia EJIE S A Mediterr neo 3 Tel 945 01 73 00 Fax 945 01 73 01 01010 Vitoria Gasteiz Posta kutxatila Apartado 809 01080 Vitoria Gasteiz Este documento es propiedad de EJIE S A y su contenido es confidencial Este documento no puede ser reproducido en su totalidad o parcialmente ni mostrado a otros ni utilizado para otros prop sitos que los que han originado su entrega sin el previo permiso escrito de EJIE S A En el caso de ser entregado en virtud de un contrato su utilizaci n estar limitada a lo expresamente autorizado en dicho contrato EJIE S A no podr ser considerada responsable de eventuales errores u omisiones en la edici n del documento Eusko Jaurlaritzaren Informatika Elkartea e Sociedad Inform tica del Gobierno Vasco Control de documentaci n C digo Versi n 1 0 Fecha Resumen de cambios Primera versi n Responsable Aprobado por Firma Fecha Distribuci n Referenciasdearchvo Autor Consultor a de reas de conocimiento Nombre archivo TortoiseSVN Manual de usuario doc Localizaci n Ais Web Accessibility Manual de usuario 2 20 Eusko Jaurlaritzaren Informatika Elkartea Sociedad Inform tica del Gobierno Vasco Cap tulo secci n hb O N 4 2 4 3 4 4 4 5 4 6 4 7 4 8 4 8 1 4 9 4 10 4 11 4 12 4 13 Introducci n2. 2 SVN Confirmar Terminado Acci n Ruta Tipo Mime A adiendo C TortoisesYMNidoclimages esiContextMenuDirControl pna applicationfoctet stream A adiendo C TortoiseSYMNidoclimagesjesiContextMenuDirWoControl png applicationfoctet stream A adiendo C TortoisesYNidoclimages esiContextMenuFileControl pna applicationfoctet stream A adiendo C TortoisesYNidoclimagesjesiContextMenuFileMNoControl png applicationfoctet stream Enviando Contenido C TortoiseSYMidoclimages esiContextMenuDirWNoControl pna Enviando Contenido C TortoiseSYMidoclimages esiContextMenuFileWoControl pna Enviando Contenido C TortoiseSYNidoctimages esiContextMenuDirControl png Enviando Contenido C TortoiseSYMNidoclimages esiContextMenuFileControl pna Completado En revisi n 4286 A adido 4 4 4 Actualizar la copia de trabajo con los cambios de otros Es necesario asegurarse de que los cambios que hacen los dem s se incorporen a la copia de trabajo local El proceso de incorporar los cambios desde el servidor a la copia de trabajo local se conoce como actualizaci n La actualizaci n puede hacerse en ficheros sueltos en un conjunto de ficheros o recursivamente en jerarqu as completas de directorios Para actualizar 1 2 Seleccionar los ficheros y o directorios que se deseen Hacer clic con el bot n derecho y seleccionar TortoiseSVN gt Actualizar en el men contextual del explorador Aparecer una ventana con el progreso de la actual
3. Conceptos b sicos Por qu un sistema de trabajo en grupo Funciones elementales Importar datos en un repositorio Obtener una copia de trabajo Enviar cambios al repositorio Actualizar la copia de trabajo con los cambios de otros Resolver conflictos Obtener informaci n de estado Di logo de registro de revisiones Ver diferencias Diferencias de ficheros A adir nuevos ficheros y directorios Deshacer cambios Limpiar Crear ramas o etiquetas Fusionar P g oa n A A 11 12 13 14 14 16 17 17 19 ina 3 20 Eusko Jaurlaritzaren Informatika Elkartea Sociedad Inform tica del Gobierno Vasco 1 Introducci n El presente documento describe cu les son las tareas b sicas que se pueden ejecutar en la explotaci n de la herramienta TortoiseSVN 2 Conceptos b sicos TortoiseSVN es un cliente gratuito de c digo abierto para el sistema de control de versiones Subversion Est desarrollado bajo la Licencia P blica General GNU GPL y se puede acceder al c digo fuente de este programa en este enlace http tortoisesvn tigris org svn tortoisesvn TortoiseSVN maneja ficheros y directorios a lo largo del tiempo Los ficheros se almacenan en un repositorio central El repositorio es pr cticamente lo mismo que un servidor de ficheros ordinario salvo que recuerda todos los cambios que se hayan hecho a sus ficheros y directorios Esto permite que pueda recuperar versiones antiguas de sus ficheros
4. de su proyecto delega la resoluci n de los conflictos en los desarrolladores Cuando se informa de un conficto se deber a abrir el fichero en cuesti n y buscar l neas que empiecen con el texto lt lt lt lt lt lt lt El rea conflictiva se marca as lt lt lt lt lt lt lt nombre del fichero sus cambios c digo fusionado del repositorio 11 20 r Eusko Jaurlaritzaren Informatika Elkartea Sociedad Inform tica del Gobierno Vasco gt gt gt gt gt gt gt revisi n Adem s para cada fichero en conflicto Subversion deja tres ficheros adicionales en su directorio nombre del fichero ext mine Este es el fichero tal y como estaba en la copia de trabajo antes de que se actualizara la copia de trabajo esto es sin marcadores de conflicto Este fichero tiene sus ltimos cambios en l y nada m s nombre del fichero ext rREV ANTIGUA Este es el fichero que era la revisi n BASE antes de que se actualizara la copia de trabajo Esto es el fichero que se obtuvo antes de empezar a hacer los ltimos cambios nombre del fichero ext rREV NUEVA Este es el fichero que el cliente de Subversion acaba de recibir desde el servidor del que se actualiz la copia de trabajo Este fichero corresponde a la revisi n HEAD del repositorio Entonces Se puede o bien lanzar una herramienta externa de fusiones editor de conflictos con el men contextual TortoiseSVN gt Editar Conflictos o bien utilizar otro editor manualmente p
5. del rbol de directorios Si se especifica la ruta padre del rbol de directorios en la URL al final se acabar con un disco duro lleno porque se obtendr una copia del rbol completo del repositorio incluyendo cada rama y etiqueta del proyecto 8 20 L Eusko Jaurlaritzaren Informatika Elkartea Sociedad Inform tica del Gobierno Vasco 4 3 Enviar cambios al repositorio Enviar los cambios que se han hecho al repositorio se conoce como confirmar los cambios Pero antes de confirmar hay que estar seguro de que la copia de trabajo est actualizada Se puede o bien ejecutar TortoiseSVN gt Actualizar directamente o bien ejecutar TortoiseSVN gt Comprobar Modificaciones primero para ver qu se ha cambiado localmente o en el servidor Si la copia de trabajo est actualizada y no hay conflictos ya se est preparado para confirmar los cambios Para ello 1 Seleccionar los ficheros y o carpetas que desee confirmar 2 Seleccionar TortoiseSVN gt Confirmar Introducir Mensaje de Registro D ITortoiseSVNWTortoiseSVN Ea Confirmar en http tortoisesvn tigris org svn tortoisesvn trunk Mensaje Mensajes recientes Cambios hechos doble dick para m s detalles Archivo Extensi n Estado d Estad Bloquear ee Y doc pd i r o normal p Mostrar diferencias como diff unificado O E doc sc Caoc e E O Sext ja Mostrar registro gt Abrir Abrir con Explorar a x Eliminar gt Most
6. ini variable steveking 23 37 11 vienes 02 de diciembre de 2005 Avoid a possible buff steveking 20 06 42 martes 29 de noviembre de 2005 Allow ignoring of muli steveking 20 05 46 martes 29 de noviembre de 2005 Don t run the progres steveking 18 47 22 martes 29 de noviembre de 2005 Refresh the views in steveking 18 44 51 martes 29 de noviembre de 2005 Fix broken sort funct steveking 18 43 21 mertes 29 de noviembre de 2005 Fix a string in the res steveking 17 08 44 domingo 27 de noviembre de 2005 Automatically add un steveking 16 54 56 doningo 27 de noviembre de 2005 Make export Yeme Y gt DODVONVADE Allow ignoring of multiple selected items in the CSVNStatusListCtrl This implements issue 1938 Acci n Ruta Copiar desde la ruta Revisi n Modificado ftrunk src Changelog txt Modificado ftrunk src SVW SVNStatusListCtrl cpp Modificado ftrunk src SVN SVNStatusListCtrl h E Ocultar rutas cambiadas no relacionadas Ayuda Mostrar Rango Siguientes 100 Para en copia cambio de nombre Aceptar Como se puede apreciar en la imagen los comentarios pueden enlazar con bug trackers como Mantis y de hecho se pueden definir hooks para cerrar incidencias en Mantis seg n se actualicen versiones en el repositorio 4 8 Ver diferencias Uno de los requisitos m s comunes en el desarrollo de proyectos es ver qu ha cambiado Se puede querer ver las diferencias entre dos revisiones del mismo f
7. los sistemas de control de versiones es la posibilidad de marcar revisiones particulares por ejemplo una versi n lanzada a producci n para que pueda en cualquier momento recrear un cierto entorno o compilaci n Este proceso se conoce como etiquetar tags o releases Importante respecto a CVS Dejan de existir los conceptos de m dulo ramas y etiquetas como entidades separadas Ramas y etiquetas branches y tags Internamente no existen tales conceptos si quieres una rama la creas a partir de un enlace a un n mero de revisi n del c digo se comparte el historial no es necesario copiar el proyecto entero Una etiqueta es una rama a la que no se le a aden m s cambios M dulos En Subversion solo existen directorios no hay concepto de m dulo Antes de que se importen datos al repositorio primero se deber pensar c mo se quiere organizar los datos Si se utiliza uno de los patrones recomendados ser m s f cil Hay algunas formas est ndar y recomendadas de organizar un repositorio La mayor a de la gente crea un directorio trunk tronco para alojar la l nea principal del desarrollo un directorio branches ramas para que contenga las copias ramas y un directorio tags etiquetas para contener las copias etiquetas Si un repositorio s lo aloja un proyecto entonces la gente a menudo crea estos directorios en el primer nivel htrunk branches ltags Si un repositorio contiene m ltiples proyectos la gente
8. y examinar la historia de cu ndo y c mo cambiaron sus datos y qui n hizo el cambio Entre las caracter sticas de TortoiseSVN cabe destacar Integraci n con el shell de Windows TortoiseSVN se integra perfectamente en el shell de Windows por ejemplo el explorador Esto significa que puede seguir trabajando con las herramientas que ya conoce Y que no tiene que cambiar a una aplicaci n diferente cada vez que necesite las funciones del control de versiones Los men s contextuales de TortoiseSVN tambi n funcionan en otros administradores de archivos y en el di logo Archivo Abrir que es com n a la mayor a de aplicaciones est ndar de Windows Sin embargo debe tenerse en cuenta que TortoiseSVN est desarrollado con la mirada puesta en hacerle extensi n del Explorador de Windows Por este motivo puede que en otras aplicaciones la integraci n no sea tan completa y que por ejemplo los iconos sobreimpresionados en las carpetas no se muestren Iconos sobreimpresionados El estado de cada carpeta y fichero versionado se indica por peque os iconos sobreimpresionados De esta forma puede ver f cilmente el estado en el que se encuentra su copia de trabajo con a pruebaSvn F cil acceso a los comandos de Subversion Todos los comandos de Subversion est n disponibles desde el men contextual del explorador TortoiseSVN a ade su propio submen all TortoiseSVN proporciona una serie de herramientas internas e TortoiseMerg
9. a menudo indexa por ramas Itrunk paint Itrunk calc oranches paint branches calc Itags paint Itags calc o por proyecto paint trunk paint branches 6 20 4 1 Eusko Jaurlaritzaren Informatika Elkartea Sociedad Inform tica del Gobierno Vasco paint tags calc trunk calc branches calc tags Importar datos en un repositorio 1 Seleccionar la carpeta superior de la estructura de directorios del proyecto en el explorador de Windows 2 Hacer clic con el bot n derecho del rat n para abrir el men contextual 3 Seleccionar el comando TortoiseSVN gt Importar 4 Aparecer el siguiente cuadro de di logo 22 Importar Repositorio URL de repositorio https 4fip_servidor_svn svn GypsyLE trunk Importar Mensaje Importaci n Inicial Historial de Mensajes de 5 Introducir la URL del repositorio en el que quiere importar su proyecto El mensaje de importaci n se utiliza como un mensaje de registro 6 Tan pronto como se presione Aceptar TortoiseSVN importa el rbol completo de directorios incluyendo todos los ficheros en el repositorio El nombre de la carpeta que se est importando no aparece en el repositorio s lo los contenidos de los ficheros El proyecto ahora est almacenado en el repositorio bajo el control de versiones NOTA Hay que tener en cuenta que la carpeta que se ha importado no est bajo el control de versiones Para obtener una copia de trabajo bajo el cont
10. ara resolver el conflicto Se debe decidir c mo tiene que quedar el c digo hacer los cambios necesarios y grabar el fichero Despu s se debe ejecutar el comando TortoiseSVN gt Resolver y confirmar las modificaciones al repositorio El comando Resolver realmente no resuelve el conflicto Simplemente elimina los ficheros nombre del fichero ext mine y nombre del fichero ext r dejando confirmar los cambios Si se tienen conflictos con ficheros binarios Subversion no intentar mezclar dichos ficheros por si mismo Se puede utilizar el comando Resuelto para m ltiples ficheros si se pulsa con el bot n derecho en la carpeta padre y se selecciona TortoiseSVN gt Resuelto Esto mostrar un di logo con todos los ficheros en conflicto dentro de esa carpeta y permitir seleccionar cu les marcar como resueltos 4 6 Obtener informaci n de estado Mientras se est trabajando en la copia de trabajo a menudo ser necesario saber qu ficheros se han cambiado a adido borrado o renombrado o incluso qu ficheros han sido cambiados y confirmados por los dem s Para ello son tiles los iconos sobreimpresionados Q Una copia de trabajo reci n obtenida tiene una marca verde como sobreimpresi n Esto significa que el estado de Subversion es normal En cuanto se empiece a editar un fichero el estado cambia a modificado y el icono sobreimpresionado cambia entonces a una marca de exclamaci n roja De esta forma se puede ver f cil
11. copia se crea dentro del repositorio e Crear una Etiqueta o una Rama no afecta a la copia de trabajo 4 13 Fusionar Mientras que las ramas se utilizan para mantener l neas de desarrollo separadas en alguna etapa se tendr n que fusionar los cambios hechos en una rama de vuelta en el tronco o viceversa Un punto importante a recordar es que Fusionar est muy relacionado con Diferenciar El proceso de fusi n trabaja generando una lista de diferencias entre dos puntos del repositorio y aplicando esas diferencias a la copia de trabajo Por ejemplo si se desea fusionar los cambios hechos en la revisi n N entonces se tendr que comparar la revisi n N con la revisi n N 1 Para hacerlo m s sencillo cuando se utilice Mostrar Registro para seleccionar un rango de revisiones a fusionar TortoiseSVN har el ajuste autom ticamente En general es una buena idea realizar fusiones en una copia de trabajo sin modificar Si se han hecho otros cambios en la copia de trabajo habr que confirmarlos primero Si la fusi n no funciona como se espera se puede querer revertir los cambios y el comando Revertir descartar todos los cambios incluidos cualquiera que se haya hecho antes de la fusi n 19 20
12. ctualizados a adidos eliminados en conflicto etc bajo la lista de ficheros 3 Elcomando Actualizar est ndar no tiene opciones y simplemente actualiza la copia de trabajo a la revisi n HEAD del repositorio lo que es el caso de uso m s com n Si se desea m s control sobre el proceso de actualizaci n se deber a utilizar TortoiseSVN gt Actualizar a la revisi n Esto permite actualizar la copia de trabajo a una revisi n espec fica no s lo a la m s reciente NOTA Actualizar a la revisi n puede ser til a veces para ver c mo estaba el proyecto en un momento anterior en su historia Pero en general actualizar ficheros individuales a una revisi n anterior no es una buena idea ya que deja la copia de trabajo en un estado inconsistente La revisi n HEAD del repositorio es la ltima revisi n de un fichero o una carpeta en el repositorio En contraposici n a ella existe la revisi n BASE La revisi n base actual de un fichero o una carpeta en su copia de trabajo Esta es la revisi n en la que estaba el fichero o la carpeta cuando se hizo la ltima operaci n de obtener actualizar o confirmar La revisi n BASE normalmente no equivale a la revisi n HEAD 4 5 Resolver conflictos De vez en cuando se obtendr un conflicto cuando se actualizan los ficheros desde el repositorio Un conflicto ocurre cuando dos o m s desarrolladores han hecho cambios en las mismas l neas de un fichero Dado que Subversion no sabe nada
13. e Permite ver las diferencias entre ficheros de texto fusionar esos cambios e incluso revisar y aplicar ficheros de diff unificados a menudo llamados parches e TortoiseBlame Hace m s f cil la lectura de los ficheros de autor a 4 20 L Eusko Jaurlaritzaren Informatika Elkartea Sociedad Inform tica del Gobierno Vasco e SubWCRev Es un programa de consola para Windows que puede utilizarse para leer el estado de una copia de trabajo local y opcionalmente realizar sustituciones de palabras clave en un fichero plantilla 3 Por qu un sistema de trabajo en grupo En muchas ocasiones un programador habr modificado un programa en el cual han aparecido inconsistencias y ha tenido que volver atr s teniendo que recordar c mo estaba antes d nde etc Con un sistema de control de versiones restaurar a un estado anterior es tan f cil que cuando se usa por primera vez ser algo indispensable en proyectos futuros Usando las herramientas de cliente de sistemas como Subversion los desarrolladores pueden realizar cambios al contenido del repositorio El repositorio ser algo as como una biblioteca central donde se guarda todo el c digo de un proyecto Se puede cambiar cada archivo creando una historia completa de la evoluci n del proyecto en desarrollo los desarrolladores pueden recuperar versiones m s antiguas de un archivo ver un registro de cambios y realizar otras tareas tiles seg n lo necesitado Subversion est dirig
14. en de la copia Existen tres opciones e Revisi n HEAD en el repositorio La nueva rama se copia directamente en el repositorio desde la revisi n HEAD No se necesita transferir datos desde la copia de trabajo y la rama se crea muy r pidamente e Revisi n espec fica en el repositorio La nueva rama se copia directamente en el repositorio pero se puede elegir una versi n anterior De nuevo no se transfieren datos desde la copia de trabajo y la rama se crea muy r pidamente e Copia de trabajo La nueva rama es una copia id ntica de la copia de trabajo local Si se han cambiado algunos ficheros a una revisi n anterior en la copia de trabajo o si se han hecho cambios locales esto es exactamente lo que ir a la copia Naturalmente esta clase de etiquetado complejo conlleva transferir datos desde la copia de trabajo al repositorio si no existe ya all Si se desea que su copia de trabajo se cambie autom ticamente a la rama reci n creada se utiliza la casilla Cambiar la copia de trabajo a la nueva rama etiqueta asegur ndose primero de que la copia de trabajo no contenga modificaciones Si las tiene esos cambios se mezclar n en la copia de trabajo de la rama cuando se haga el cambio Se pulsar Aceptar para confirmar la nueva copia al repositorio proporcionando un mensaje de registro Hay que tener en cuenta que TENE CORE 18 20 L Eusko Jaurlaritzaren Informatika Elkartea Sociedad Inform tica del Gobierno Vasco e La
15. erior de la copia de trabajo 4 12 Crear ramas o etiquetas Si se ha importado un proyecto con la estructura de directorios recomendados crear una rama o una etiqueta es muy simple Se selecciona la carpeta en la copia de trabajo de la que se desea hacer una rama o una etiqueta y Ejie Eusko Jaurlaritzaren Informatika Elkartea Sociedad Inform tica del Gobierno Vasco luego se selecciona el comando TortoiseSVN gt Rama Etiqueta La URL de destino por defecto para la nueva rama ser la URL de origen en la que se basa la copia de trabajo Se necesitar editar esa URL con la nueva ruta para la rama etiqueta As que en vez de http svn collab net repos NombreDelProyecto trunk se usar algo como http svn collab net repos NombreDelProyecto tags Version_1 10 17 20 L Eusko Jaurlaritzaren Informatika Elkartea Sociedad Inform tica del Gobierno Vasco Copiar Rama Etiqueta Repositorio Desde la Copia de Irabajo en la URL http ftortoisesvn tigris org swn tortoisesvn trunkfdoc A la URL http ftortoiseswn tigris org senftortoisesvnfbranches_1 2 xIdoc Crear una copia en el repositorio desde La revisi n HEAD en el repositorio O Revisi n espec fica en el repositorio O Copia de trabajo Mensaje de Registro Se crea la rama 1 2 x para la document aci n Historial de Mensajes de Registro O Cambia la copia de trabajo a una rama etiqueta nueva N Ahora se debe elegir el orig
16. ichero o las diferencias entre dos ficheros separados TortoiseSVN provee una herramienta integrada llamada TortoiseMerge para ver las diferencias entre ficheros de texto 4 8 1 Diferencias de ficheros idea 14 20 AIS Web AC L Eusko Jaurlaritzaren Informatika Elkartea Sociedad Inform tica del Gobierno Vasco Cambios locales Si se desea ver qu cambios se han hecho en la copia de trabajo simplemente se utiliza el men contextual del explorador y se selecciona TortoiseSVN gt Diferenciar Diferenciar con otra rama etiqueta Si se desea ver qu ha cambiado en el tronco si se est trabajando en una rama o en una rama espec fica si se est trabajando en el tronco se puede utilizar el men contextual del explorador Simplemente manteniendo la tecla May sculas mientras se hace clic con el bot n derecho en el fichero Luego seleccionando TortoiseSVN gt Diferenciar con URL En el siguiente di logo se especifica la URL del repositorio con la que se quiere comparar el fichero local Tambi n se puede utilizar el navegador de repositorios y seleccionar dos rboles para diferenciar quiz s dos ramas o una rama etiqueta y el tronco Ah el men contextual permite compararlos utilizando Comparar revisiones Diferenciar desde una revisi n anterior Si se desea ver las diferencias entre una revisi n en concreto y la copia de trabajo se utiliza el di logo Registro de Revisiones se seleccionar la revisi n de in
17. icheros y o directorios y se utiliza TortoiseSVN gt A adir Despu s de que se a adan los ficheros o directorios al control de c digo el fichero aparece con una sobreimpresi n de icono a adido que significa que primero se debe confirmar la copia de trabajo para que esos ficheros y directorios est n disponibles para otros desarrolladores 4 10 Deshacer cambios Si se desea deshacer todos los cambios que se han hecho en un fichero desde la ltima actualizaci n se necesita seleccionar el fichero hacer clic con el bot n derecho para sacar el men contextual y luego seleccionar el comando TortoiseSVN gt Revertir Aparecer un di logo que muestra los ficheros que se han cambiado y que se puede revertir Se seleccionar n los que se desee revertir y se pulsar Aceptar 16 20 2 Revertir Estado del Texto El dug_add xml modificado E dug_checkout xml modificado f dug_general xml modificado E dug_import xml modificado E dug_rename xml modificado E dug_showlog xml modificado b P a EN E fs Estado de las Propiedades normal normal normal normal normal normal Seleccionar Deseleccionar Todo p Ce C uo 4 11 Limpiar Si un comando de Subversion no puede completarse de forma correcta quiz s por problemas en el servidor la copia de trabajo puede quedarse en un estado inconsistente En ese caso se deber utilizar TortoiseSVN gt Limpiar en la carpeta Es una buena idea hacerlo en la rama sup
18. ido al trabajo en grupo aunque tambi n es muy til para un programador individual por la posibilidad de recuperar viejas copias y ver los cambios hechos Subversion es un sistema centralizado para compartir informaci n En su interior es un repositorio es decir un almac n de informaci n El repositorio almancena informaci n en forma de rbol Utiliza una jerarqu a t pica de ficheros y directorios Cuando un desarrollador a ade archivos con c digo sta pasa a ser disponible para otros De hecho se pueden conectar varios clientes a ese repositorio y entonces leer y escribir archivos en el mismo En principio parece un sistema muy similar a un t pico servidor de ficheros Pero en realidad m s que un servidor en s lo que le hace interesante a Subversion es que es capaz de recordar cualquier cambio realizado sobre un archivo de c digo e Cualquier cambio a un archivo e Cambios en un directorio e Archivos que se a aden se borran se modifican etc e Cu ndo se realizan los cambios e Qui n los realiza Cuando un cliente lee datos de un repositorio normalmente ve s lo la ltima versi n del sistema de rbol Pero el cliente tendr la posibilidad de buscar estados previos de dicho sistema Por ejemplo un cliente puede hacer preguntas del tipo Qu conten a este directorio hace 4 d as o Qui n ha sido la ltima persona que ha modificado este fichero y qu cambios hizo Estas son las t pica
19. istro detallado para el proceso de desarrollo El di logo de Registro de revisiones recopila todos esos mensajes de registro y se los ense a La pantalla se divide en tres paneles e El panel superior muestra una lista de revisiones donde se confirmaron cambios a los ficheros carpetas Este sumario incluye la fecha y la hora la persona que confirm la revisi n y el inicio del mensaje de registro Las l neas azules indican que algo se ha copiado a esta l nea de desarrollo quiz s desde una rama e El panel medio muestra el mensaje de registro completo para la revisi n seleccionada e El panel inferior muestra una lista de todos los ficheros y carpetas que se cambiaron como parte de la revisi n seleccionada Se puede invocar el di logo de Registro de revisiones desde e El submen contextual de TortoiseSVN e La p gina de propiedades e El di logo de Progreso despu s de que se termine una actualizaci n En ese caso el di logo de Registro s lo mostrar aquellas revisiones que cambiaron desde la ltima actualizaci n La imagen siguiente muestra el aspecto del di logo de registro de revisiones 13 20 PP Eusko Jaurlaritzaren Informatika Elkartea Sociedad Inform tica del Gobierno Vasco Mensajes de Registro D 1TortoiseSYNiTortoiseSVNisrc Desde 22 11 2005 Y A 22 11 2005 v P X Revisi n Acciones Autor Fecha Mensaje f 5057 steveking 23 37 54 viernes 02 de diciembre de 2005 Pass the
20. izaci n seg n se ejecuta Los cambios que los dem s hayan hecho se fusionar n con los ficheros de la copia local guardando cualquier cambio que se hubiese hecho en los mismos ficheros de la copia local El repositorio no se ve afectado por una actualizaci n lanual de usuario 10 20 L Eusko Jaurlaritzaren Informatika Elkartea Sociedad Inform tica del Gobierno Vasco 21 ENSubversioniTortoiseSVNidocisourceten SVN Actualizar Termina BAR Acci n Ruta Tipo Mime Actualizado E Subversion TortoiseSYMidoc sourcelenitsvn_app_faq xml Conflicto E Subversion TortoiseSYMidoc source enltsvn_serverlserver xml Actualizado E Subversion TortoiseSYMWidocisource enitsvn_server server_apache xrml Actualizado E Subversion TortoiseSYMWidoci source enitsvn_serverl server_swn xml Actualizado E Subversion TortoiseSYMidoc source en Completado En revisi n 4285 i Atenci n Unos o m s archivos est n en estado en conflicto Conflicto 1 Actualizado 4 Mostrar registro 1 Si se obtiene alg n conflicto durante una actualizaci n esto puede suceder si los dem s han cambiado las mismas l neas del mismo fichero y esos cambios no concuerdan el di logo muestra esos conflictos en rojo Se puede hacer doble clic en esas l neas para iniciar la herramienta de fusi n externa para resolver los conflictos 2 Cuando se completa la actualizaci n el di logo de progreso le muestra un resumen con el n mero de tems a
21. ko Jaurlaritzaren Informatika Elkartea Sociedad Inform tica del Gobierno Vasco Diferencias entre un fichero carpeta en la copia de trabajo y una URL Si se desea ver las diferencias entre un fichero en la copia de trabajo y un fichero en cualquier repositorio de Subversion se puede hacer directamente en el explorador seleccionando el fichero y pulsando la tecla May sculas mientras se hace clic con el bot n derecho del rat n para obtener el men contextual Se selecciona TortoiseSVN gt Diferenciar con URL Se puede hacer lo mismo para una carpeta de copia de trabajo TortoiseMerge muestra esas diferencias de la misma forma que muestra un fichero de parche una lista de ficheros cambiados que se pueden ver de uno en uno Diferencias con informaci n de autor a Si se desea ver no s lo las diferencias sino tambi n el autor revisi n y la fecha en la que se hicieron los cambios se pueden combinar los informes de diferencias y de autor a desde dentro del di logo del historial de revisiones Diferencias entre carpetas Las herramientas proporcionadas con TortoiseSVN no permiten ver las diferencias entre jerarqu as de directorios Pero si se tiene una herramienta externa que soporte esta funcionalidad se puede utilizar 4 9 A adir nuevos ficheros y directorios Si se han creado nuevos ficheros y o directorios durante el proceso de desarrollo se necesitar a adirlos tambi n al control de c digo Para ello se seleccionan los f
22. mente qu ficheros se han cambiado desde la ltima vez que se actualiz la copia de trabajo y que necesitan ser confirmados Si durante una actualizaci n ocurre un conflicto el icono cambia a un signo de exclamaci n amarillo 12 20 L Eusko Jaurlaritzaren Informatika Elkartea Sociedad Inform tica del Gobierno Vasco Si se ha establecido la propiedad svn needs lock en un fichero Subversion pone a 7 ese fichero como de s lo lectura hasta que obtenga un bloqueo en dicho fichero Los ficheros de s lo lectura tienen esta sobreimpresi n para indicarle que se debe obtener un bloqueo antes de que se pueda editar ese fichero Si se ha obtenido un bloqueo sobre un fichero y el estado de Subversion es normal este icono sobreimpresionado recordar que se deber a liberar el bloqueo si no se est utilizando para permitir a los dem s que puedan confirmar sus cambios al fichero Este icono muestra que algunos ficheros o carpetas dentro de la carpeta actual se 2 han marcado para ser borrados del control de versiones o bien que falta un fichero bajo control de versiones dentro de una carpeta El signo m s indica que el fichero o carpeta est programado para ser a adido al Jp control de versiones 4 7 Di logo de registro de revisiones Para cada cambio que se haga y se confirme se deber proporcionar un mensaje de registro de dicho cambio As se podr averiguar despu s qu cambios se hicieron y por qu y se tendr un reg
23. rar ard Obtener bloqueo js seleccionados 5 archivos en total E Seleccionar Propiedades Mantener bl Copiar rutas al portapapeles Copiar toda la informaci n al portapapeles J 3 El di logo de confirmaci n mostrar todos los ficheros cambiados incluso los ficheros a adidos borrados o no versionados e Si no se desea que un fichero cambiado se confirme simplemente se desmarcar ese fichero e Si se desea incluir un fichero no versionado se marcar para a adirlo a la confirmaci n e Los tems que han sido cambiados a una ruta de repositorio diferente tambi n se indican utilizando un marcador Ais Web Accessibility Manual de usuario 9 20 4 Eusko Jaurlaritzaren Informatika Elkartea Sociedad Inform tica del Gobierno Vasco Haciendo doble clic en cualquier fichero modificado en el di logo de confirmaciones se lanzar la herramienta externa de diferenciar para mostrar los cambios Habr que asegurarse de introducir un mensaje de registro que describa los cambios que se est n confirmando Esto ayudar a saber qu ocurri y cuando seg n se navegue por los mensajes de registro del proyecto en el futuro El mensaje puede ser tan extenso o escueto como se desee muchos proyectos tienen directrices sobre qu debe incluirse en ellos el idioma que debe utilizarse y a veces incluso un formato estricto Tras pulsar Aceptar aparece un di logo mostrando el progreso de la confirmaci n
24. rol de versiones se necesita obtener la versi n que se acaba de importar 7 20 L Eusko Jaurlaritzaren Informatika Elkartea Sociedad Inform tica del Gobierno Vasco 4 2 Obtener una copia de trabajo Para conseguir una copia de trabajo se necesita obtener una de un repositorio Para ello 1 2 Seleccionar un directorio en el explorador de Windows donde se quiera poner la copia de trabajo Hacer clic con el bot n derecho del rat n para mostrar el men contextual Seleccionar el comando TortoiseSVN gt Obtener Se mostrar el siguiente cuadro de di logo Obtener Repositorio URL de repositorio http tortoisesvn tigris org svn tortoisesvn tags version_1 2 0RC1 Y r Directorio donde obtener C TortoiseSVN tags L C S lo obtener la carpeta superior C Omitir externos Revisi n Revisi n HEAD O Revisi n Mostrar registro N 5 Antes de pulsar Aceptar habr que tener en cuenta que e Si se introduce un nombre de carpeta que a n no exista se crear un directorio con ese nombre e Si se desea obtener s lo la carpeta superior y omitir todas las subcarpetas habr que hacer uso de la casilla S lo obtener la carpeta superior e Si el proyecto contiene referencias a proyectos externos que no se desea que se obtengan al mismo tiempo habr que hacer uso de la casilla Omitir externos NOTA Es recomendable obtener nicamente la parte trunk
25. s preguntas que se pueden resolver con un sistema de repositorio de archivos como Subversion ya que almacenan toda la informaci n tanto de versiones cambios por versi n y responsable de dichos cambios Debido a todo lo anterior permite adem s la concurrencia en el trabajo es decir que m s de una persona pueda trabajar con el mismo proyecto y lo que es m s importante incluso con el mismo archivo 4 Funciones elementales Antes de empezar a utilizar TortoiseSVN se deben cumplir las siguientes premisas e Tener ya instalado TortoiseSVN e Estar familiarizado con los sistemas de control de versiones 5 20 L Eusko Jaurlaritzaren Informatika Elkartea Sociedad Inform tica del Gobierno Vasco Conocer las bases de Subversion Tener preparado un servidor y o tener acceso a un repositorio de Subversion Tambi n es interesante conocer el tratamiento que hace Subversion a la rama principal trunk ramas branches y etiquetas tags o releases Una de las caracter sticas de los sistemas de control de versiones es la posibilidad de aislar cambios en una l nea separada de desarrollo Esto se conoce como una rama Las ramas se utilizan a menudo para probar nuevas caracter sticas sin molestar la l nea principal del desarrollo con errores de compilaci n y errores Tan pronto como la nueva caracter stica es lo suficiente estable la rama de desarrollo se fusiona de nuevo en la rama principal trunk troncal Otra caracter stica de
26. ter s y luego se seleccionar Comparar con la copia de trabajo desde el men contextual Diferenciar entre dos revisiones antiguas Si se desea ver las diferencias entre dos revisiones que ya se confirmaron se utiliza el di logo Registro de Revisiones y se seleccionar n las dos revisiones que se desea comparar utilizando el modificador habitual Ctrl Luego se selecciona Comparar revisiones desde el men contextual Si se hizo esto desde el historial de revisiones de una carpeta aparece un di logo Comparar Revisiones mostrando una lista de ficheros cambiados en esa carpeta Todos los cambios hechos en una confirmaci n Si se desea ver los cambios hechos a todos los ficheros en una revisi n en particular de una vez se puede utilizar la salida diff unificado formato de parche GNU Esto s lo muestra las diferencias con unas pocas l neas de contexto Es m s dif cil de leer que una comparaci n visual de ficheros pero mostrar todos los cambios juntos Desde el di logo Registro de Revisiones se selecciona la revisi n de inter s y luego se selecciona Mostrar Diferencias como Diff Unificado desde el men contextual Diferencias entre ficheros Si se desea ver las diferencias entre dos ficheros diferentes se puede hacer directamente en el explorador seleccionando ambos ficheros utilizando el modificador habitual Ctrl Luego desde el men contextual del explorador se selecciona TortoiseSVN gt Diferenciar 15 20 L Eus
Download Pdf Manuals
Related Search