Tutorial de uso de TortoiseSVN
TortoiseSVN es un cliente gratuito y de código abierto para el sistema de control de versiones Subversion, que puede gestionar archivos y directorios a lo largo del tiempo.
Instalación de TortoiseSVN
Dirección de descarga:https://tortoisesvn.net/downloads.html, en la página hay enlaces de descarga para los paquetes de idioma.
Actualmente la última versión es la 1.11.0, dirección de descarga:https://osdn.net/projects/tortoisesvn/storage/1.11.0/
En el paquete de parches de idioma podemos encontrar el parche chino y descargarlo:
Ejecute el programa de instalación de TortoiseSVN descargado
Ejecute el paquete de idioma chino de TortoiseSVN descargado
Después de una instalación correcta, se debe reiniciar el equipo para asegurar que TortoiseSVN funcione correctamente.
Cambiar el idioma predeterminado de TortoiseSVN
Después de instalar TortoiseSVN, la interfaz predeterminada está en inglés. Podemos cambiarla al idioma instalado mediante la configuración.
Uso de TortoiseSVN
Crear un directorio de trabajo ejemplo01
El llamado directorio ejemplo01 es simplemente el lugar donde usted guarda habitualmente sus archivos de trabajo. Normalmente esperamos a que nuestro trabajo esté en un punto de corte para hacer una copia de seguridad. Así que normalmente trabajamos en el directorio ejemplo01 y, cuando llega el momento adecuado, hacemos commit al repositorio. Por ejemplo, queremos crear un directorio llamado ejemplo01 en la unidad D. Primero creamos ese directorio.
Entre al directorio creado, haga clic derecho en un área vacía (puede hacerlo sobre el icono del directorio MyWork, o entrando al directorio MyWork y haciendo clic en un espacio en blanco) y seleccioneSVN checkout。
A continuación verá la siguiente pantalla:
Primero debemos completar la ubicación del repositorio. Para SVN, la ubicación del repositorio siempre es una URL. En URL del repositorio, introduzca la dirección del repositorio de pruebas.svn://10.0.4.17/ejemplo01。
A continuación, revise el Checkout directory (directorio de checkout). Este campo debe apuntar a su directorio ejemplo01.
Después de confirmar, pulse el botón OK. Debería ver la siguiente ventana de información.
Esto indica que la acción se ha completado. Después de pulsar OK, vaya al directorio que acaba de crear. Verá que en el directorio MyWork hay un nuevo elemento llamado.svndirectorio (este directorio está oculto; si su administrador de archivos no está configurado para mostrar directorios ocultos, no podrá verlo).
Si desea hacer checkout de los archivos anteriores desde un servidor SVN ya existente, solo necesita proporcionar la URL SVN correcta y el nombre del directorio que desea verificar. Así podrá obtener los archivos y directorios especificados.
Añadir archivos y directorios al repositorio (add commit)
Cree el directorio dir01 y agregue archivos dentro del directorio.
Para agregar los nuevos archivos al control de versiones de SVN, TortoiseSVN mostrará los archivos y directorios que se van a añadir; marque los archivos que necesite agregar.
Después de pulsar OK, verá la siguiente ventana de mensaje:
Esta acción de Add (agregar) no coloca realmente los archivos en el repositorio. Solo le indica a SVN que está preparado para agregar estos archivos al repositorio. El estado de los archivos en este momento es:
Para colocar realmente estos archivos en el repositorio, haga clic derecho en un área vacía y seleccione SVN commit (confirmar). A continuación, verá la siguiente ventana:
Aquí puede ver claramente qué archivos se van a confirmar (commit) en el repositorio. Del mismo modo, si hay archivos que no desea confirmar en este momento, puede desmarcarlos y no se confirmarán en el repositorio. En el cuadro de texto "Mensaje" puede escribir una descripción para esta confirmación.
Después de hacer clic en "Aceptar" se completa la acción de commit. Luego puede ir al directorio ejemplo y comprobar si todos los iconos de archivos tienen la marca de verificación verde como la siguiente; esto indica que sus archivos se han guardado correctamente en el repositorio.
Actualizar archivos y directorios (update)
Dado que los sistemas de control de versiones suelen ser utilizados por muchas personas, es posible que otros editen los mismos archivos. Para asegurarse de que los archivos de su directorio de trabajo estén sincronizados con los del repositorio, se recomienda realizar una actualización antes de editar.
Haga clic derecho en el icono del archivo o directorio que desea actualizar y seleccione SVN Update.
A veces necesitamos volver a una fecha o versión específica; para ello podemos usar la función Update to revision de SVN. Haga clic derecho en el icono del archivo o directorio que desea actualizar y seleccione TortoiseSVN -> Update to revision (actualizar a versión).
Copiar archivos y directorios (branch)
Muchas veces querrá tener otro directorio copiado para realizar nuevas modificaciones. Una vez que esté seguro de que las modificaciones de esta rama están completas, podrá fusionarlas con la versión de desarrollo principal original. Por ejemplo, actualmente tenemos los siguientes directorios y archivos en ejemplo01/trunk:
Ahora vamos a crear una rama (branch) para el directorio trunk. Supongamos que queremos que este directorio esté en D:\ejemplo01\branch. Primero podemos hacer clic derecho en un área vacía dentro del directorio trunk, o directamente sobre el icono de trunk, y seleccionar la opción Branch/Tag… (rama/etiqueta). Verá el siguiente cuadro de diálogo.
Primero asegúrese de que el directorio en From WC at URL (desde copia de trabajo/URL) sea el directorio de origen que desea copiar. Luego, en To URL (hasta la ruta), introduzca la ruta de destino. Normalmente agrupamos todas las ramas en un solo directorio. En el ejemplo anterior, los archivos de la rama se concentran en el subdirectorio branch. En To URL solo necesita introducir el directorio deseado. Si el directorio no existe, SVN lo creará por usted. Tenga en cuenta especialmente que SVN usa la barra diagonal (/) como separador de directorios, no la barra invertida (\). Luego, en Log message (mensaje de registro), introduzca el propósito de esta rama. Pulse OK para finalizar.
Si tiene éxito, verá la siguiente pantalla:
Pulse OK para cerrar esta ventana. Si va inmediatamente al subdirectorio branch del directorio ejemplo01, se decepcionará al descubrir que no existe el directorio que acaba de especificar. Esto se debe a que la parte del directorio ejemplo01 aún es antigua. Solo necesita hacer SVN update en el subdirectorio branch para ver el nuevo directorio. El nuevo directorio ya no tiene relación con el original. Puede editarlo libremente. Cuando haya confirmado que todo el trabajo necesario en la rama está completo, puede optar por fusionar (merge) esta rama de vuelta al directorio trunk original, o mantenerla en la rama.
Acción de fusionar (merge)
Si hemos modificado o agregado archivos en la rama branch y queremos fusionarlos de vuelta al directorio trunk, el método es muy sencillo. En el ejemplo anterior, hacemos clic derecho en un área vacía del directorio D:\ejemplo01\trunk y seleccionamos Merge (fusionar):
Esta pantalla se divide principalmente en tres partes. Los campos From: y To: le preguntan desde qué versión de la rama hasta qué versión desea fusionar de vuelta al directorio trunk original. Por lo tanto, los campos URL de From y To deben apuntar al directorio de la rama original. El resto es especificar el rango de revisiones que se van a fusionar. En el ejemplo anterior, fusionamos desde la Revisión 7 de la rama hasta la última versión de la rama. Puede usar el botón Try run para probar una fusión. Esta fusión solo mostrará algunos mensajes, no actualizará realmente el directorio trunk. Solo después de pulsar el botón Merge se fusionarán realmente los archivos de la rama con los del trunk.
Si confirma que esta fusión no tiene problemas, puede usar directamente commit para confirmar estos dos archivos modificados en el repositorio SVN. Si hay problemas, puede modificar directamente estos dos archivos hasta que estén bien y luego hacer commit.
Crear un Tag o un Release
Los llamados Tag o Release son una versión especial, porque esta versión puede tener un significado especial. Por ejemplo: esta versión es un Milestone especial o una versión lanzada para el cliente. En realidad, el método de Tag y Release es exactamente el mismo que el de Branch. Solo que Branch puede necesitar fusionarse (merge) de vuelta al trunk original, mientras que tag y release en su mayoría no necesitan fusionarse de vuelta al trunk.
Por ejemplo, hoy nuestro trunk hizo una versión, y esta versión fue reconocida como la versión 1.0 del software. La versión 1.0 es un hito muy importante para el desarrollo. Así que tenemos que hacerle una marca especial, es decir, un Tag. Supongamos que esta versión 1.0 se va a lanzar oficialmente (release) al cliente o a los vendor relacionados, tenemos que poder hacerle una marca de Release. Básicamente, SVN solo tiene el concepto de directorio, no tiene un uso específico de Tag. Por eso verá que en el menú de SVN, Branch y Tag son el mismo elemento. Tomando este ejemplo de 1.0, creamos un directorio tags bajo el directorio ejemplo01 para almacenar las versiones etiquetadas, y lo enviamos al repositorio, luego en Trunk, hacemos clic derecho y seleccionamos el elemento Branch/Tag:
Si tiene éxito, habrá creado un directorio v1.0 bajo el directorio Tag correspondiente. Por supuesto, si va al directorio Tag en este momento, no verá este directorio; necesita hacer update en el directorio Tag para poder verlo.
