Manual Subversion

Alumnos: Merlo Álvarez, Roberto García Salazar, Ramiro

Gordón Romero, Antonio Valls Esteban, Jorge

UNIVERSIDAD PONTIFICIA COMILLAS Escuela Técnica Superior de Ingeniería (ICAI)

5º Ingeniería Informática Ingeniería del software II

Curso 2009/10

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

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

este enlace se explica cómo instalar los binarios necesarios

‘http://www.open.collab.net/downloads/netbeans/index.html’ o

‘http://subversion.tigris.org/’.

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.

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.

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.

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

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 http://netbeans.org/kb/docs/ide/subversion.html#badges

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.

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.

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.

• http://es.wikipedia.org/wiki/Subversion

• http://subversion.tigris.org/

• http://netbeans.org/kb/docs/ide/subversion.html

Anexo B. Gmail como repositorio SVN. Accedemos a la url ‘http://code.google.com/intl/es/’.

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

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.

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.