UNIVERSIDAD PONTIFICIA COMILLAS Escuela Técnica Superior de Ingeniería (ICAI) 5º Ingeniería Informática Ingeniería del software II Curso 2009/10

Transcripción

1 UNIVERSIDAD PONTIFICIA COMILLAS Escuela Técnica Superior de Ingeniería (ICAI) 5º Ingeniería Informática Ingeniería del software II Curso 2009/10 Manual Subversion Alumnos: Merlo Álvarez, Roberto García Salazar, Ramiro Gordón Romero, Antonio Valls Esteban, Jorge

2 QUÉ ES? 2 PORQUÉ? 2 CÓMO SE USA? 2 SERVIDOR SVN 2 CLIENTE SNV 2 CREACIÓN DEL PROYECTO 3 IMPORTACIÓN INICIAL 3 ACCIONES SOBRE EL PROYECTO 5 AÑADIR ARCHIVO 5 CONFIRMAR CAMBIOS 6 ARREGLAR CONFLICTOS 7 ANEXO A. SVN 9 ANEXO B. GMAIL COMO REPOSITORIO SVN. 10 URL 12 CONTRASEÑA 12

3 Qué es? En pocas palabras, sistema de control de versiones. Porqué? Existen dos situaciones para trabajar con subversion; Desarrollo de un proyecto de manera individual y se quiere tener un lugar donde poder tener un control de todos los cambios que se han ido realizando. De este modo si en un momento dado, algo deja de funcionar, podemos volver a la última versión que funcionaba correctamente. Desarrollo colaborativo de un proyecto. Mas de una persona, trabajando sobre el mismo proyecto. Permite tener de una manera centralizada, la versión correcta y actualizada del código, así cómo un control de todos los cambios realizados. En anexo A, se tiene una explicación más detallada de las características de esta herramienta/filosofía de trabajo. Cómo se usa? Servidor SVN Para poder poner en marcha esta herramienta, necesitaremos un servidor donde poder ir guardando los cambios. Se podría hacer de forma local, pero esto sólo cubriría una de las situaciones mencionadas en el apartado anterior. En el anexo B, se explica cómo configurar una cuenta de gmail, para dar soporte de control de versiones. Cliente SNV Antes de poder usar el plugin subversion de netbeans, tenemos que instalar el cliente svn. Dependiendo del SO que tengamos tenemos que elegir una instalación u otra. En

4 este enlace se explica cómo instalar los binarios necesarios o Creación del proyecto Lo primero de todo es crear un proyecto nuevo, o podemos trabajar con uno existente. Para realizar este manual, voy a partir de uno nuevo que voy a crear. Importación inicial Seleccionando el proyecto que acabamos de crear, pinchamos con el botón derecho sobre él, y seleccionamos Control de Versiones =>Importar al repositorio de Subversion.

5 Veremos esta pantalla, donde rellenaremos los campos como se indica a continuación: URL del repositorio, consultar anexo B. Seleccionamos siguiente, e introducimos un comentario. Para la importación inicial, es obligatorio introducir dicho comentario. Presionando el botón siguiente, nos aparece esta ventana, donde se muestra un resúmen, con los archivos que se van a importar al servidor.

6 Aparentemente no se aprecia que hayamos hecho nada en el proyecto, pero si todo ha ido correctamente, ya tenemos nuestro proyecto controlado. Acciones sobre el proyecto En esta sección se explicarán la mayoría de las posibles acciones que se pueden realizar sobre un proyecto. Añadir archivo Para este ejemplo, voy a crear una nueva clase App. Observamos como ahora han aparecido unos nuevos iconos en el navegador de proyectos de NetBeans, y el color del fichero App.java, es verde.

7 Estos iconos y colores en los nombres de los ficheros, pueden variar dependiendo del entorno de desarrollo que se esté usando. Para este caso concreto; Verde indica fichero nuevo. Azul, fichero que se ha modificado. Negro, fichero sin cambios. Rojo, fichero con conflictos. El simbolito azul que está al lado de los directorios/paquetes, te informa que contiene algún fichero con modificaciones o nuevo. Para una explicación más detallada del significado de los iconos y colores, se puede consultar este enlace 1. Confirmar cambios Seleccionamos con el botón derecho el archivo del que queremos confirmar los cambios al repositorio. Nos aparecerá esta ventana, donde podremos introducir un comentario, y presionaremos el botón de confirmar. 1

8 Arreglar conflictos Un conflicto se produce cuando alguien del equipo de trabajo realiza un cambio sobre una versión x de un fichero, y actualiza/sube esos cambios al servidor, y yo realizo otros cambios sobre la versión x de dicho fichero, e intento actualizar/subir mis cambios. Se puede observar en la imagen siguiente cómo netbeans nos muestra que se han producido conflictos al intentar confirmar los cambios realizados sobre un fichero. Se puede observar como ha marcado el archivo en color rojo, y hay tres archivos nuevos. A estos archivos no le vamos a hacer mucho caso, porque son interno de subversion. Para arreglar estos conflictos, pinchamos con el botón derecho sobre el archivo rojo y seleccionamos Subversion, Resolver Conflictos. Nos aparecerá una ventana como la siguiente.

9 Básicamente, esta ventana nos muestra mediante una ventana partida, las dos versiones del fichero (Parte izquierda nuestra versión y parte derecha la versión del servidor) y el resultado que quedará después de arreglar el conflicto. En este momento es decisión del usuario, saber con qué cambios se queda; La versión que yo tengo es la buena. La versión que está en el servidor es la buena. Una mezcla. Se trata de elegir sobre un fichero final, aquellos cambios que afectan a las dos versiones que queremos que permanezcan.

10 Anexo A. SVN Para evitar hacer un copy/paste completo de lo que hay en la web, mencionaré un par de sitios importantes donde poder saber más sobre subversion

11 Anexo B. Gmail como repositorio SVN. Accedemos a la url Al seleccionar la pestaña Mis favoritos, pinchamos en Acceder, para logarnos con nuestro usuario y contraseña de Google. Una vez que nos hemos logado correctamente, seleccionamos el enlace Project Hosting, de los enlaces que están en la parte izquierda, y en la siguiente ventana, seleccionamos Contribuye al software libre, Create Project.

12 En la ventana que nos aparece rellenamos los datos necesarios para crear nuestro repositorio. Para añadir colaboradores a nuestro proyecto, en la pestaña de Project Home, en la opción People, podemos añadir miembros.

13 URL En la pestaña Source, tenemos la url de nuestro repositorio. Contraseña Para saber cual es la contraseña para poder hacer cambios en los fichero del servidor, tenemos seleccionar el enlace Profile, que se encuentra en la esquina superior derecha. Después seleccionaremos la pestaña Settings para poder configurar nuestro cliente svn.