Parte 6 – Controle de Origem – Rational Team Concert

• Lição 1: Como configurar um projeto e uma equipe
• Lição 2: Como conectar-se ao projeto como um usuário
• Lição 3: Como utilizar itens de trabalho
• Lição 4: Como configurar planos de iteração
• Lição 5: Como gerenciar e organizar o trabalho em equipe com as visualizações Central de Equipes e Meu Trabalho
• Lição 6: Como salvar e compartilhar código-fonte
• Lição 7: Como utilizar a Interface com o Usuário da Web
• Lição 8: Como configurar construções de equipes

O componente do controle de origem manipula o armazenamento, a recuperação e o compartilhamento do código-fonte e outros artefatos em seu projeto. O suporte de controle de origem do Rational Team Concert (SCM) é fácil de utilizar para uma variedade de cenários de desenvolvimento mas é um pouco diferente do arquivo regular baseado em sistema SCM. Assim, vamos começar como uma visão geral rápida do modelo de uso.

Por Que e Quando Desempenhar Esta Tarefa

No Rational Team Concert, nós queremos que os usuários se beneficiem da habilidade do SCM de rastrear e definir versões de suas alterações, quer você esteja ou não pronto para compartilhar tais alterações com sua equipe. Adequadamente, como um usuário, você tem seu próprio espaço de trabalho do repositório particular que armazena as alterações feitas, independente de quando você decide disponibilizá-las para sua equipe. Algumas vezes, serão apenas algumas horas antes de decidir compartilhar suas alterações; algumas vezes será um dia ou mais. A chave é que suas alterações estejam no repositório e você decida quando torná-las disponíveis para sua equipe. Quando você carrega seu espaço de trabalho do repositório, os arquivos e pastas nele são transferidos para seu espaço de trabalho do Eclipse em seu computador. Para enviar uma alteração do seu espaço de trabalho do Eclipse para o espaço de trabalho do repositório você efetua o registro de entrada da alteração.

Um fluxo é utilizado para armazenar o trabalho da equipe. Quando desejar fazer alterações disponíveis para sua equipe, entregue-as de um espaço de trabalho do repositório para um fluxo. Quando desejar incorporar alterações de outros membros da equipe, você as aceita do fluxo. Observe que você também pode aceitar alterações diretamente de outro espaço de trabalho do repositório, possibilitando compartilhamento de granularidade fina de alterações entre os membros da equipe. Por exemplo, dois membros da equipe podem colaborar em uma pequena correção de erro; ou, se alguém inicia uma alteração e sai em férias, outro membro da equipe poderia continuar o trabalho e então fornecê-lo posteriormente.

Todas as alterações feitas em seu espaço de trabalho do repositório são rastreados nos conjuntos de alterações. Cada conjunto de alterações é composto de uma coleta de alterações explícitas e primitivas para um ou mais arquivos ou pastas. Um conjunto de alterações também pode conter um comentário e a razão das alterações terem sido feitas, normalmente referenciando o item de trabalho relevante. A base do arquivo de origem é criada do nada mas o acréscimo constante dos conjuntos de alterações, cada um baseado em tudo que vem depois dele. Cada espaço de trabalho do repositório ou fluxo é baseado em uma seqüência de conjuntos de alterações.

Vamos começar a fazer alterações e aprenda como estes conceitos podem ser utilizados no trabalho diário.

Criando um Espaço de Trabalho do Repositório

A primeira etapa é localizar o fluxo da sua área da equipe. O fluxo é onde você compartilha seu código com sua equipe.

1. Na visualização Artefatos da Equipe, expanda a área do projeto Prelúdio e expanda Fluxos, em seguida, expanda Fluxo da Equipe do Prelúdio para visualizar o componente. Observe que se nenhuma entrada aparecer sob Fluxos, examine o drop-down Customizar Meu Filtro na captura de tela. Abra o drop-down e certifique-se de que Todas as Áreas da Equipe estejam selecionada. Nota: Observe que no futuro, quando você for um membro de várias equipes, pode localizar filtros customizados muito úteis.Os fluxos e espaços de trabalho do repositório podem ser particionados em componentes separados. Como cada componente possui seu próprio histórico, dividir um produto em componentes é útil para equipes que constroem software em camadas no qual as peças de desenvolvem de maneira semi-independente e são implementadas separadamente. Espaços de trabalho de repositórios simples e fluxos consistem em um único componente. No nosso exemplo, o Fluxo da Equipe do Prelúdio tem apenas um componente (denominado Componente Padrão) que conterá nossos arquivos e pastas.
2. Selecione o fluxo para sua área da equipe denominada Fluxo da Equipe do Prelúdio (Equipe do Prelúdio).
3. No menu de contexto (clique com o botão direito do mouse), selecione a ação Novo Espaço de Trabalho do Repositório…. Um assistente é exibido, possibilitando que você nomeie o espaço de trabalho do repositório que será criado a partir do fluxo.
4. Nomeie seu espaço de trabalho do repositório Chris no Prelúdio e clique em Concluir. Isto criará e então carregará seu novo espaço de trabalho do repositório em seu espaço de trabalho do Eclipse. O carregamento deve concluir rapidamente, como ainda não há código no fluxo.
5. Quando um espaço de trabalho do repositório é carregado, ele aparece na visualização Alterações Pendentes. Se a visualização Alterações Pendentes não estiver visível, na barra de menus selecione Janela > Mostrar Visualização > Alterações Pendentes.
6. Se você conseguiu concluir o tutorial de convite da equipe, então você concluiu um dos itens de trabalho criados quando sua área do projeto foi inicializada. Execute sua consulta Itens de Trabalho Abertos novamente e observe o item de trabalho [Juntando-se à Equipe] Criar um Espaço de Trabalho do Repositório. Você pode agora abrir esse item de trabalho e resolvê-lo da mesma forma que resolveu o item de trabalho Definir Membros da Equipe anteriormente.

Resultados: Os espaços de trabalho do repositório carregados são especiais já que sempre que você altera um arquivo ou pasta carregada em seu espaço de trabalho do Eclipse, as alterações são rastreadas e mostradas na visualização Alterações Pendentes. Aqui, você pode gerenciar suas alterações e realizar tarefas comuns, tais como:

• Efetuar o registro de entrada das alterações em seu espaço de trabalho do repositório.
• Organizar alterações nos conjuntos de alterações.
• Desfazer as alterações que você fez.
• Associar conjuntos de alterações com itens de trabalho.

Você visualizará muito mais da visualização Alterações Pendentes nas próximas seções, já que ela está realmente no centro do trabalho diário do desenvolvedor.

Autoria de Código

Uma vez que você se juntou a um fluxo, pode começar no negócio de criação de código e produção de artefatos que formam seu projeto.Por Que e Quando Desempenhar Esta TarefaNeste ponto, se você tiver alguns pacotes Java de um pequeno projeto, poderia tentar o Rational Team Concert. Você pode importar estes projetos em seu espaço de trabalho do Eclipse agora da visualização Package Explorer selecionando a opção Importar… do menu de contexto. Mas se você não tiver nenhum código interessante com o qual iniciar, pode criar um aplicativoJava simples ou criar a projeto simples contendo um único arquivo de texto.

1. Para ajudar na criação de um aplicativo Java simples no cliente do Jazz, selecione a ação AjudaFolhas de Dicas… da barra de menus.
2. No diálogo Seleção da Folha de Dicas, expanda a categoria Desenvolvimento Java, selecione a folha de dicas do aplicativo Criar um Hello World e, então, clique em OK. A folha de dicas aparecerá na janela do seu cliente do Jazz e o orientará pela criação de um aplicativo Java simples. Para obter ajuda mais avançada, consulte o Guia do Usuário de Desenvolvimento Eclipse Java. Nota: Os autores deste tutorial criaram um projeto Java simples denominado Hello Prelude que visualizará nas capturas de tela no restante deste tutorial.

Colocando seu Código sob o Controle de Origem do Jazz

Assim que tiver importado ou criado manualmente algum código no seu espaço de trabalho do Eclipse, pode efetuar o registro de entrada do seu código em seu espaço de trabalho do repositório no servidor. Por Que e Quando Desempenhar Esta TarefaRegistro de Entrada é o processo de mover código do seu espaço de trabalho do Eclipse para seu espaço de trabalho do repositório. O termo para movimentação do código do seu espaço de trabalho do repositório no fluxo a ser compartilhado com sua equipe é entrega. Observe que você pode alterar suas preferências de Controle de Origem do Jazz para especificar o registro de entrada automático. Você também pode trabalhar desconectado e efetuar o registro de entrada posteriormente quando reconectado.

1. Se ainda não estiver nela, abra a perspectiva Java (). Se esta não for a perspectiva atual, na barra de menu selecione Janela > Abrir Perspectiva > Java.
2. Na visualização Package Explorer, selecione o projeto Hello Prelude.
3. Em seu menu de contexto (clique com o botão direito do mouse), selecione Equipe > Compartilhar Projeto… O assistente Compartilhar Projeto é exibido.
4. Selecione Controle de Origem do Jazz e, então, clique em Avançar.
5. Na página Selecionar Componente do assistente, certifique-se de que a conexão do repositório chris@localhost esteja selecionado na lista drop-down na parte superior da página. Além disso, certifique-se de que Selecionar um componente em um espaço de trabalho existente esteja selecionado. Expanda Chris no Prelúdio e selecione o Componente Padrão. Clique em Avançar.
6. Embora você provavelmente não tenha que alterar qualquer coisa, na página Revisar Recursos Ignorados do assistente, verifique ou conclua os recursos para ignorar o compartilhamento. A seguir, pressione Concluir. Seu código agora foi verificado em seu espaço de trabalho do repositório, mas não foi entregue para o fluxo.

ResultadosVá em frente e alterne para a visualização Alterações Pendentes (Janela > Mostrar Visualização > Alterações Pendentes da perspectivaJava). Ela já deve ter sido aberta quando você carregou e compartilhou. Se você expandir o Componente Padrão, observará um conjunto de alterações para o projeto que acabou de compartilhar. Observe que nós rastreamos a operação de compartilhamento e as alterações correspondentes tiveram o registro de entrada efetuado automaticamente no espaço de trabalho do repositório. Observe que o conjunto de alterações já tem o comentário “Compartilhar Projetos” associado a ele (consulte a captura de tela abaixo). Você pode alterar o comentário se desejar (ou incluir comentários para conjuntos de alterações futuros que não recebem um comentário automaticamente) selecionando o conjunto de alterações e a partir do seu menu pop-up, selecione a ação Editar Comentário. A seguir, digite na caixa de edição. Quando tiver terminado, pressione a tecla Enter para aplicar o comentário.

Vamos examinar outras duas maneiras de procurar os arquivos que você incluiu no seu espaço de trabalho do repositório. O primeiro é navegar na estrutura do diretório do componente. Para fazer isto, clique no Componente Padrão na visualização Alterações Pendentes e a partir de seu menu pop-up, selecione a ação Mostrar > Arquivos de Repositório. Na visualização Arquivos de Repositório visualizará o projeto que acabou de compartilhar.

Outra coisa que você pode examinar é o histórico do seu espaço de trabalho do repositório. Novamente, selecione o Componente Padrão da visualização Alterações Pendentes e execute a ação Mostrar > Histórico. A visualização Histórico será aberta e você visualizará dois conjuntos de alterações listados. O primeiro é o conjunto de alterações inicial de quando o componente foi criado. O segundo é o conjunto de alterações que acabou de criar. Dê um clique duplo no conjunto de alterações e a visualização Alterar Explorer será aberta e possibilitará que você explore os conteúdos do conjunto de alterações.

Entregando suas Alterações para sua Equipe

Nesta seção, você visualizará o conjunto de alterações representando o código que você criou. Então você associará seu conjunto de alterações com um item de trabalho existente. Finalmente, você entregará seu código para o fluxo.Por Que e Quando Desempenhar Esta TarefaTodas as alterações feitas até agora estão armazenadas com segurança em seu espaço de trabalho do repositório no repositório. Agora você deseja tornar as alterações disponíveis para o resto da equipe entregando-as.

1. A primeira coisa a fazer é abrir a visualização Alterações Pendentes se ela ainda não estiver aberta.
2. Selecione o conjunto de alterações e no menu de contexto (clique com o botão direito do mouse) e selecione Associar Item de Trabalho… Um diálogo é exibido.
3. Desmarque a caixa Mostrar apenas minhas designações.
4. No campo Contendo ID ou Texto, digite compartilhar. Ele selecionará os itens de trabalho contidos em seu resumo ou descrição a palavra “compartilhar.”
5. Selecione o item de trabalho denominado Compartilhar código com o Controle de Origem do Jazz e clique em OK. Isto estabelece a conexão entre o código que você criou e o item de trabalho no qual resolveu fazer isso.
6. No mesmo menu de contexto, selecione a ação Entregar e Resolver Item de Trabalho…. Certifique-se de que a caixa de opção Resolver os itens de trabalho associados após a entrega está marcada. A seguir, digite um comentário, que será incluído no item de trabalho e clique em Concluir. Quando isto tiver sido concluído, seu código foi entregue do seu espaço de trabalho do repositório no servidor para a fluxo da área da equipe onde ele agora está acessível para o restante da equipe e o item de trabalho foi resolvido.
7. Atualize a visualização Histórico. Você observará que ela mostra que o conjunto de alterações foi associado com o item de trabalho. Além disso, volte para a visualização Artefatos da Equipe e clique no Componente Padrão no Fluxo da Equipe do Prelúdio e execute a ação Mostrar Histórico. Você observará na visualização Histórico que o fluxo também contém seu conjunto de alterações.

Resultados: Se você abrir o item de trabalho associado com a alteração (na visualização Histórico, selecione o conjunto de alterações conforme mostrado acima e a partir de seu menu pop-up, selecione a ação Itens de Trabalho Abertos), visualizará que o item de trabalho foi corretamente resolvido e tem um link para o conjunto de alterações que você criou para este trabalho.