< Anterior | Siguiente >

Lección 6: Control de origen

El componente de control de origen se encarga de almacenar, recuperar y compartir el código fuente y otros artefactos del proyecto. El soporte de control de origen de Rational Team Concert (SCM) es fácil de utilizar para diversos escenarios de desarrollo pero es un poco diferente de los sistemas SCM normales basados en archivo. Por ello, vamos a comenzar por una rápida visión general del modelo de funcionamiento del sistema.
En Rational Team Concert, queremos que los usuarios se beneficien de la capacidad de SCM de hacer un seguimiento y crear versiones de sus cambios, tanto si están listos para compartirlos con la corriente como si no. Por ello, como usuario, usted dispone de su propio espacio de trabajo de repositorio privado, en el cual se almacenan los cambios que realiza, independientemente de cuándo decida ponerlos a disposición de su equipo. Puede que sea tan solo un par de horas antes de que decida compartir sus cambios, un día antes o incluso más. Lo importante es que sus cambios se encuentran en el repositorio y solo usted decide cuándo compartirlos con su equipo. Al cargar su espacio de trabajo de repositorio, los archivos y carpetas que contiene se transfieren al espacio de trabajo de Eclipse en su sistema. Para trasladar un cambio del espacio de trabajo de Eclipse al espacio de trabajo de repositorio, incorpore el cambio.

Se emplea una corriente para almacenar el trabajo del equipo. Para compartir sus cambios con el equipo, debe entregarlos desde el espacio de trabajo de repositorio hasta una corriente. Si desea incorporar los cambios del resto de miembros del equipo, solo tiene que aceptarlos desde la corriente. Recuerde que también puede aceptar los cambios directamente desde otro espacio de trabajo de repositorio, lo cual posibilita un intercambio preciso de cambios entre los miembros de un equipo. Así, por ejemplo, dos miembros de un equipo pueden colaborar en el arreglo de un error o, en caso de que alguien inicie un cambio y se vaya de vacaciones, otro miembro del equipo puede continuarlo y entregarlo después.

Flujo de trabajo del control de origen

Todos los cambios que realiza en el espacio de trabajo de repositorio se organizan en conjuntos de cambios. Cada conjunto de cambios se compone de una serie de cambios explícitos y primitivos en uno o más archivos o carpetas. Un conjunto de cambios puede ir acompañado de un comentario y del motivo de los cambios, donde normalmente se indica el elemento de trabajo pertinente. La base del archivo de origen se construye mediante la adición gradual y constante de conjuntos de cambios, cada uno de los cuales se construye sobre todos los anteriores. Cada espacio de trabajo de repositorio y corriente se basa en una secuencia de conjuntos de cambios.

Ha llegado el momento de comenzar a realizar cambios y de aprender cómo pueden utilizarse estos conceptos en el día a día de su trabajo.

Creación de un espacio de trabajo de repositorio

El primer paso consiste en encontrar una corriente para su área de equipo. Es en la corriente donde va a compartir el código con su equipo.
  1. En la vista Artefactos de equipo, expanda el área de proyecto Prelude y Control de origen; a continuación, expanda Corriente de equipo 1 para ver el componente. Si no se visualiza ninguna entrada bajo Control de origen, examine el desplegable Personalizar Mi filtro indicado en la captura de pantalla. Abra el menú desplegable y asegúrese de que la opción Todas las áreas de equipo esté seleccionada.
    Nota: Cuando sea miembro de varios equipos, es posible que encuentre que los filtros personalizados son muy útiles.

    Las corrientes y los espacios de trabajo de repositorio pueden dividirse en componentes independientes. Dado que cada componente tiene su propio historial, dividir un producto en componentes puede ser útil para aquellos equipos que construyen software en capas, en el que las piezas evolucionan de forma semi-independiente y se desarrollan por separado. Los espacios de trabajo de repositorio y corrientes simples se componen de un solo componente. En el ejemplo, la Corriente de equipo 1 tiene solo un componente (denominado Componente predeterminado) donde se almacenarán todos los archivos y carpetas.

    Corriente de componente predeterminada de la Corriente de equipo 1

  2. Seleccione una corriente para el área de equipo con la etiqueta Corriente de equipo 1 (Equipo 1).
  3. Pulse el botón derecho del ratón y, a continuación, pulse Nuevo > Espacio de trabajo del repositorio.
  4. En el asistente Espacio de trabajo de repositorio nuevo, en la página Espacio de trabajo de repositorio nuevo, en el campo Nombre de espacio de trabajo de repositorio, escriba Chris en Prelude y pulse Finalizar. Esta acción crea y carga el nuevo espacio de trabajo de repositorio en el espacio de trabajo de Eclipse. Dado que la corriente no contiene aún código alguno, debería cargarse rápidamente.
  5. Cuando se carga un espacio de trabajo de repositorio, éste se visualiza en la vista Cambios pendientes. Si la vista Cambios pendientes no está visible, pulse Ventana > Mostrar vista > Cambios pendientes.
  6. Opcional: Si ha completado la guía de aprendizaje Invitación de equipo, ya ha finalizado uno de los elementos de trabajo creados al inicializar su área de trabajo. Ejecute de nuevo su solicitud Abrir elementos de trabajo y localice el elemento de trabajo [Uniéndose a un equipo] Cree un espacio de trabajo de repositorio. Ahora abra ese elemento de trabajo y resuélvalo exactamente del mismo modo en que resolvió el elemento de trabajo Definir miembros del equipo anteriormente.
Los espacios de trabajo de repositorio cargados presentan la peculiaridad de que al modificar un archivo o carpeta cargado en el espacio de trabajo de Eclipse, se rastrean los cambios y se añaden a la vista Cambios pendientes. Aquí podrá gestionar los cambios y realizar las siguientes tareas comunes:
  • Comprobar los cambios en el espacio de trabajo de repositorio.
  • Organizar los cambios en conjuntos.
  • Deshacer los cambios realizados.
  • Asociar conjuntos de cambios a elementos de trabajo.

En las siguientes secciones aprenderá mucho más acerca de la vista Cambios pendientes, pues se trata de un elemento fundamental en el día a día del trabajo del desarrollador.

Código de autor

Después de haberse unido a un equipo, puede escribir código y producir los artefactos que forman el proyecto.
Si tiene algunos paquetes Java™ de un proyecto pequeño que desee probar con Rational Team Concert, puede importar ahora esos proyectos al espacio de trabajo de Eclipse desde la vista Explorador de paquetes seleccionando la opción Importar en el menú de contexto. Si, por el contrario, no tiene ningún código interesante con que empezar, puede crear una aplicación de Java simple o un proyecto simple que contenga un único archivo de texto.
  1. Para obtener ayuda para crear una aplicación Java simple en el cliente Jazz, pulse Ayuda > Hojas de apuntes.
  2. En el recuadro de diálogo Selección de hoja de apuntes, expanda la categoría Desarrollo Java y pulse Crear una aplicación Hello World. Pulse Aceptar. La hoja de apuntes se visualiza en la ventana de cliente de Jazz y le guía durante la creación de una aplicación Java simple. Si necesita ayuda más avanzada, consulte la Guía de usuario de desarrollo Java de Eclipse.
    Nota: Los autores de esta guía de aprendizaje crearon un proyecto Java sencillo denominado Hello Prelude.

Colocación del código bajo Jazz Source Control

Después de haber importando o creado manualmente algún código en el espacio de trabajo de Eclipse, puede incorporar el código en el espacio de trabajo de repositorio del servidor y compartir el proyecto con el equipo.
La incorporación es el proceso en el cual usted mueve el código desde su espacio de trabajo de Eclipse a su espacio de trabajo de repositorio. La acción de trasladar código desde su espacio de trabajo de repositorio a la corriente que comparte con su equipo se denomina entregar. Puede cambiar las preferencias de Jazz Source Control para especificar la incorporación automática. También puede trabajar desconectado e incorporarlo más tarde cuando se vuelva a conectar.

Para incorporar el proyecto en Jazz Source Control:

  1. Abra la perspectiva Java. Si ésta no es la perspectiva actual, pulse Ventana > Abrir perspectiva > Java.
  2. En la vista Explorador de paquetes, seleccione el proyecto Hello Prelude.
  3. Pulse el botón derecho del ratón y, a continuación, pulse Equipo > Compartir proyecto.
  4. En el asistente para Compartir proyecto, en la página Compartir proyecto, seleccione Jazz Source Control y pulse Siguiente.
  5. En la página Seleccionar componente, asegúrese de que la conexión de repositorio chris@localhost está seleccionada en la lista desplegable en la parte superior de la página. Asegúrese también de que se seleccione Seleccionar un componente de un espacio de trabajo de repositorio existente. Expanda Chris en Prelude y seleccione Componente predeterminado. Pulse Siguiente.
  6. Aunque probablemente no tendrá que cambiar nada, en la página Revisar recursos omitidos, verifique o complete los recursos que no se deben compartir. Pulse Finalizar. El código ya se ha incorporado a su espacio de trabajo de repositorio, pero no se ha entregado a la corriente.
  7. Opcional: Conmute a la vista Cambios pendientes. En la perspectiva Java, pulse Ventana > Mostrar vista > Cambios pendientes. Ya se debería haber abierto al cargar y compartir el proyecto. Si expande el Componente predeterminado, podrá ver un conjunto de cambios para el proyecto que acaba de compartir. Se ha realizado el seguimiento de la operación de compartir y los cambios correspondientes se han incorporado automáticamente en el espacio de trabajo de repositorio.
  8. Opcional: El conjunto de cambios ya tiene asociado el comentario Compartir proyectos. Para cambiar el comentario o añadir comentarios en los conjuntos de cambios futuros que no reciban un comentario automáticamente, pulse el botón derecho del ratón en el conjunto de cambios y, a continuación, pulse Editar Comentario. En el panel de edición, escriba el comentario y pulse Intro.
  9. Opcional: Para navegar a la estructura de directorios de componente, en la vista Cambios pendientes, pulse el botón derecho del ratón en el Componente predeterminado y, a continuación, pulse Mostrar > Archivos de repositorio. En la vista Archivos de repositorio verá el proyecto que acaba de compartir.
  10. Opcional: Para examinar el historial del espacio de trabajo de repositorio, en la vista Cambios pendientes, pulse el botón derecho del ratón en el Componente predeterminado y, a continuación, pulse Mostrar > Historial. La vista Historial lista el conjunto de cambios inicial correspondiente al momento en que se creó el componente y el segundo conjunto de cambios que acaba de crear. Para explorar el contenido de un conjunto de cambios, efectúe una doble pulsación en un conjunto de cambios. Se abre la vista Explorador de cambios que le permite examinar los archivos del conjunto de cambios.

Entrega de los cambios al equipo

En esta sección, verá el conjunto de cambios que representa el código que usted creó. Seguidamente, asociará el conjunto de cambios a un elemento de trabajo existente. Para terminar, entregará el código a la corriente.
Todos los cambios que ha realizado están guardados en el espacio de trabajo del repositorio.

Para entregar los cambios y dejarlos disponibles para el resto del equipo:

  1. En la vista Cambios pendientes, pulse el botón derecho del ratón en un conjunto de cambios y, a continuación, pulse Asociar elemento de trabajo
  2. En el recuadro de diálogo Seleccionar elementos de trabajo, elimine la marca del recuadro de diálogo Sólo mis asignaciones.
  3. En el campo Que contengan el ID o texto, escriba compartir. Se visualizarán los elementos de trabajo que contienen la palabra compartir en el resumen.
  4. Seleccione el elemento de trabajo con la etiqueta Compartir código con Jazz Source Control y pulse Aceptar. Esta acción crea una conexión entre el código que ha creado y el elemento de trabajo que ha resuelto al crearlo.
  5. Para entregar y resolver el elemento de trabajo, en la vista Cambios pendientes, realice los pasos siguientes:
    1. Pulse el botón derecho del ratón en el conjunto de cambios y, a continuación, pulse Entregar y resolver elemento de trabajo.
    2. En el recuadro de diálogo Entregar y resolver, asegúrese de que se haya seleccionado el recuadro de selección Resolver elemento de trabajo.
    3. En el panel Añadir un comentario al elemento de trabajo, escriba un comentario que se añadirá al elemento de trabajo.
    4. Pulse Finalizar.
    El elemento de trabajo se resuelve y el código se ha entregado ahora del espacio de trabajo de repositorio del servidor a la corriente del área de equipo donde ahora es accesible para el resto del equipo.
  6. Opcional: Renueve la vista Historial. Esta vista muestra que el conjunto de cambios se ha asociado con el elemento de trabajo.
  7. Opcional: En la vista Artefactos de equipo, en Corriente de equipo 1, pulse con el botón derecho del ratón sobre Componente predeterminado y, a continuación, seleccione Mostrar > Historial. La vista Historial visualiza el conjunto de cambios en la corriente.
  8. Opcional: En la vista Historial, para abrir el elemento de trabajo asociado con el conjunto de cambios, pulse el botón derecho del ratón en el conjunto de cambios y, a continuación, pulse Abrir elementos de trabajo. El elemento de trabajo se resuelve y contiene un enlace al conjunto de cambios que ha creado para este trabajo.

Punto de comprobación de la lección

En esta lección, ha aprendido los conceptos básicos del componente Jazz Source Control.
< Anterior | Siguiente >

Comentarios

¿Le ha servido de ayuda? Puede incluir sus comentarios en Jazz.net (registro obligatorio): Comentarios en el foro o envíe un error