Cómo utilizar Subversion y Eclipse juntos

Subclipse es un proyecto que agrega soporte de Subversion al IDE de Eclipse. Usaremos el administrador de actualizaciones de Eclipse para agregar Subclipse al IDE de Eclipse. Abra el administrador de actualizaciones seleccionando Actualizaciones de software > Buscar e instalar en el menú Ayuda de Eclipse.

Figura 1. Administrador de actualizaciones de Eclipse

Además de usar este administrador de actualizaciones para buscar actualizaciones de software, también podemos usar el administrador de actualizaciones para buscar e instalar nuevas funciones, como Subclipse. Asegúrese de marcar Buscar nuevas funciones para instalar y haga clic en Siguiente para continuar. Eclipse mostrará el siguiente panel del administrador de actualizaciones.

Figura 2. Sitio del Administrador de actualizaciones

Dado que necesitamos una funcionalidad específica, desmarcamos el sitio existente y hacemos clic en Nuevo sitio remoto para mostrar el cuadro de diálogo Nuevo sitio de actualización (consulte la Figura 3). . Usaremos este cuadro de diálogo para agregar el sitio de actualización de Subclipse a la lista.

Figura 3. Agregar un nuevo sitio de actualización

Ingrese el nombre que desee en Nombre (Subclipse es la mejor opción) e ingrese la siguiente URL: (Sitio de actualización actual de Subclipse). Haga clic en Aceptar para agregar el sitio de actualización de Subclipse a la lista del administrador de actualizaciones.

En la ventana del Administrador de actualizaciones, haga clic en Finalizar para comenzar a buscar nuevas funciones. En este caso, la nueva característica que necesitamos es Subclipse. Después de unos momentos, la búsqueda de Update Manager se completa y se muestran los resultados.

Figura 4. Nuevas funciones instalables

Seleccione Subclipse (puede hacer clic en el triángulo para ver los detalles de la función) y luego haga clic en Siguiente para ver los términos de licencia de la función. Acepte los términos y haga clic en Siguiente para revisar las funciones que elige instalar. Haga clic en Finalizar para descargar e instalar Subclipse.

El administrador de actualizaciones descarga los componentes de Subversion. Antes de instalar cualquier función, Eclipse le notifica que la función no está firmada digitalmente (Figura 5). Esta es su última oportunidad para cancelar la instalación. Haga clic en Instalar todo para continuar con la instalación.

Figura 5. Subclipse no tiene firmas digitales

Inmediatamente después de instalar Subversion, Eclipse le notifica que es posible que necesite reiniciar el IDE para activar nuevas funciones (consulte la Figura 6). Para estar seguro, reinicie Eclipse.

Figura 6. Reinicie Eclipse después de instalar nuevas funciones

Haga una copia de seguridad de Eclipse para que pueda instalar y utilizar Subclipse correctamente.

Si está ejecutando Eclipse en Mac OS X o Linux, es posible que necesite instalar la biblioteca JavaHL. La biblioteca se describe en la sección "Solución de problemas" de las preguntas frecuentes de Subclipse (ver Recursos). Haga estos preparativos antes de continuar intentando usar Subclipse.

Prueba rápida

Una vez completada la instalación, es una buena idea probar la nueva funcionalidad. Comprobaremos una copia de Subclipse del repositorio de Subversion para asegurarnos de que se instaló; correctamente.

Seleccione Importar en el menú Archivo de Eclipse para abrir el Administrador de importaciones (consulte la Figura 7). Seleccione Ver proyecto desde SVN y haga clic en Siguiente.

Administrador de importaciones

En el panel Seleccionar/Crear ubicación (ver Figura 8), necesitamos crear una nueva ubicación (ya que aún no hemos configurado nada), así que haga clic en Siguiente para continuar. Si el botón Siguiente está deshabilitado, cambie a la opción Usar ubicación de repositorio existente y luego vuelva a Crear una nueva ubicación de repositorio para habilitar el botón Siguiente.

Figura 8. Cree una nueva ubicación de repositorio

En la siguiente sección (ver Figura 9), agregue la URL del repositorio en el campo URL y haga clic en Siguiente. Si no tiene una cuenta en el sitio de Subclipse, ingrese invitado como ID de usuario, ingrese la contraseña en los espacios, marque la casilla Guardar contraseña y haga clic en Aceptar. Agregar URL del repositorio

Eclipse muestra las carpetas en el repositorio de Subclipse (ver Figura 10). Expanda el tronco para resaltar la carpeta subclipse y haga clic en Finalizar para ver su propia copia del código fuente del proyecto Subclipse. Como no sabe nada sobre esto, elija Simple > Proyecto cuando se lo solicite el Asistente para nuevo proyecto. Biblioteca de recursos de Subclipse

Volver al principio

Operaciones básicas de Subversion

En este punto, hemos instalado Subclipse con éxito y agregado soporte para el servidor Subversion en la configuración de Eclipse. Y probé Subclipse descargando el último código fuente de Subclipse del repositorio. Ahora es el momento de pensar en cómo utilizar nuestro propio código y el repositorio de Subversion.

Antes de mostrarte cómo usar Subversion, déjame darte una breve introducción a mi repositorio. Creé un nuevo repositorio de Developerworks para albergar el código relacionado con mis artículos de DeveloperWorks. Puse el proyecto directamente en el directorio raíz del repositorio. Otros repositorios suelen tener carpetas troncales, etiquetas y ramas en el directorio raíz, que se utilizan para almacenar versiones de desarrollo, etiquetas y ramas, respectivamente. Pero no quiero etiquetar ni bifurcar código de un artículo de DeveloperWorks.

Agregué dos proyectos del primer artículo de DeveloperWorks: forkWork y threadWork. Mi espacio de trabajo de Eclipse (ver Figura 11) también contiene otros tres proyectos de artículos de desarrolladorWorks (getopt_demo, getopt_long_demo y readdir_demo).

Figura 11. Mi proyecto Eclipse C/C

Ahora todo está listo.

Agregar proyecto al repositorio

Para agregar un nuevo proyecto a un repositorio de Subversion, haga clic derecho en el proyecto (en cualquier vista de proyecto de Eclipse o vista de Navegador) y seleccione Seleccionar equipo > Compartir proyecto . Cuadro de diálogo del proyecto.

Figura 12. Diálogo Compartir Proyecto

Seleccione SVN de la lista de repositorios actualmente soportados por Eclipse y haga clic en Siguiente. El siguiente cuadro de diálogo (ver Figura 13) le permite seleccionar una ubicación de repositorio existente o crear un repositorio nuevo.

Figura 13. Seleccione la ubicación del repositorio

Si su repositorio ya aparece en la lista (como puede ver, agregué mi propio repositorio), seleccione el repositorio y haga clic en "Finalizar". .

Si su repositorio no aparece en la lista, agréguelo (consulte la Prueba rápida para obtener instrucciones) y continúe.

Figura 14. Agregar contenido del proyecto

Ingrese una descripción adecuada del proyecto en el campo en la parte superior y haga clic en Seleccionar todo para seleccionar todos los archivos del proyecto. Haga clic en Aceptar para registrar el proyecto y pasar su estado actual al repositorio de Subversion.

Los comandos y la salida de Subversion se muestran en la vista de consola, que generalmente se encuentra en la parte inferior de la ventana de Eclipse (si desea ver qué está haciendo Subclipse con su proyecto en acción).

Actualizar proyecto

Una característica importante de un sistema de control de versiones es que otros desarrolladores pueden continuar el desarrollo en cualquier momento y confirmar sus cambios cuando estén listos. Para descargar estos cambios e integrarlos con su copia local, necesita actualizar el proyecto.

Haga clic derecho en el proyecto que desea actualizar y seleccione Equipo>Actualizar en el menú. Eclipse recuperará los cambios del repositorio e intentará fusionarlos con la copia local.

Agregar un archivo o directorio

Si agrega un archivo al proyecto (consulte la Figura 15), no se convierte automáticamente en parte del control de versiones; debe agregarlo explícitamente a un repositorio específico. En la captura de pantalla siguiente, puede ver que agregué el archivo ReadMe.txt al proyecto threadWork.

Figura 15. Agregar nuevo archivo

Haga clic derecho en el nuevo archivo y seleccione Team gt; La próxima vez que envíe cambios en este proyecto al repositorio, los archivos nuevos también se registrarán.

Eliminar un archivo o directorio

Si se agregó un archivo a un repositorio que no es relevante para el proyecto, puede eliminarlo fácilmente. No es necesario utilizar el menú del equipo, Subclipse marca automáticamente los archivos para eliminarlos y los elimina del proyecto. La próxima vez que se confirmen cambios en el repositorio, el archivo se eliminará.

Cambiar el nombre de un archivo o directorio

Para cambiar el nombre de un archivo o directorio controlado por Subclipse, haga clic derecho en el archivo o directorio y seleccione Cambiar nombre. Se cambiará el nombre del archivo en el proyecto y la operación de cambio de nombre (operación de agregar para agregar un nuevo nombre, usar la operación de eliminación para eliminar el nombre anterior) se pondrá en cola para la próxima confirmación. En la Figura 16, puede ver el proyecto threadWork después de cambiar el nombre de main.c a threadWork.c y antes de confirmarlo. Observe el pequeño signo más azul que Subclipse agrega en el archivo "nuevo", lo que indica que el archivo está programado para agregarse en la próxima confirmación.

Figura 16. Cambiar el nombre de un archivo es una operación atómica, aunque incluye operaciones de agregar y eliminar

Ignorar archivos

Si el proyecto genera archivos o contiene archivos que Si no desea firmar los archivos del repositorio de Subversion que importó, puede decirle a Subclipse que los ignore. Haga clic derecho en el archivo o directorio que desea excluir del control de versiones y luego seleccione Team gt; Agregar a svn:ignore para mostrar el cuadro de diálogo Agregar a svn:ignore.

Figura 17. Ignorar el recurso desde el control de versiones

Haga clic en Aceptar para agregar este archivo específico al atributo svn:ignore del directorio del proyecto. Seleccione Extensión comodín para ignorar todos los archivos con la extensión de archivo actual, o Modo personalizado para agregar sus propios caracteres comodín a la lista de ignorados. Estos cambios a la lista de ignorados se agregarán al repositorio la próxima vez que se confirmen los cambios.

Confirmar cambios

Cuando esté satisfecho con los cambios en su proyecto, esté seguro de que el código se ha compilado y haya probado los cambios, debe enviarlos al repositorio de Subversion. Esto servirá como respaldo en caso de que su estación de trabajo falle y permitirá que otros desarrolladores actualicen sus copias locales para incluir sus cambios.

Asegúrese de actualizar su proyecto antes de intentar realizar cambios (consulte "Actualizar un proyecto"). Haga clic derecho en el proyecto y seleccione Equipo > Confirmar en el menú. Eclipse muestra un cuadro de diálogo Confirmar (consulte la Figura 18) que resume los cambios realizados.

Figura 18. Confirmar cambios en el repositorio

Si miras de cerca, encontrarás que las propiedades del directorio del proyecto han sido cambiadas (agregué el atributo svn:ignore para eliminar ciertos archivos permanecen fuera del repositorio) y main.c se eliminó cuando se agregó threadWork.c.

En este punto, si deseas mantener ciertos recursos fuera del repositorio, puedes deseleccionarlos. Esto es útil si el trabajo en el archivo está parcialmente completado y no desea registrar los cambios no terminados. Ingrese un comentario apropiado en el campo de texto en la parte superior y haga clic en Aceptar para verificar los cambios en el repositorio.