< Anterior | Próximo >

Lição 6: Controle de Origem

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 a controle de origem do Rational Team Concert (SCM) é fácil de usar em uma variedade de cenários de desenvolvimento, mas é um pouco diferente dos sistemas SCM baseados em arquivos regulares. Assim, vamos começar como uma visão geral rápida do modelo de uso.
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 transferir uma alteração da área de trabalho do Eclipse para a área de trabalho do repositório, você registra a 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.

Fluxo de Controle de Origem

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 Controle de Origem; em seguida, expanda Fluxo da Equipe 1 para visualizar o componente. Se nenhuma entrada for exibida em Controle de Origem, dê uma olhada no menu suspenso Customizar Meu Filtro na captura de tela. Abra o drop-down e certifique-se de que Todas as Áreas da Equipe estejam selecionada.
    Nota: Quando for membro de várias equipes, será possível localizar os filtros customizados úteis.

    Fluxos e áreas 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. Em nosso exemplo, o Fluxo da Equipe 1 possui apenas um componente (chamado Componente Padrão) que conterá nossos arquivos e pastas.

    Fluxo do Componente Padrão do Fluxo da Equipe 1

  2. Selecione o fluxo para sua área da equipe denominado Fluxo da Equipe 1.
  3. Clique com o botão direito do mouse; depois clique em Novo > Área de Trabalho do Repositório.
  4. No assistente Nova Área de Trabalho do Repositório, na página Nova Área de Trabalho do Repositório, no campo Nome da Área de Trabalho do Repositório, digite Chris em Prelúdio e clique em Concluir. Essa ação cria e carrega sua nova área de trabalho do repositório na área de trabalho do Eclipse. O carregamento deve concluir rapidamente, como ainda não há código no fluxo.
  5. Quando uma área de trabalho do repositório é carregada, ela é exibida na visualização Alterações Pendentes. Se a visualização Alterações Pendentes não estiver visível, clique em Janela > Mostrar Visualização > Alterações Pendentes.
  6. Opcional: 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.
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 executar tarefas comuns, tais como as seguintes:
  • Registre a entrada de alterações em sua área 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.

Criando Código

Após se juntar a um fluxo, é possível gravar código e produzir os artefatos que compõem seu projeto.
Se você tiver alguns pacotes Java™ de um pequeno projeto que gostaria de experimentar com Rational Team Concert, é possível importar esses projetos na área de trabalho do Eclipse agora a partir da visualização Explorador de Pacote selecionando a opção Importar no 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 Jazz, clique em Ajuda > Folhas de Dicas.
  2. Na caixa de diálogo Seleção de Folha de Dicas, expanda a categoria Desenvolvimento Java e clique em Criar um Aplicativo Hello World. Clique em OK. A folha de dicas é exibida em sua janela do cliente Jazz e o conduz 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 chamado Hello Prelude.

Deixando Seu Código Sob a Origem de Controle Jazz

Após ter importado ou criado manualmente algum código em sua área de trabalho Eclipse, é possível registrar a entrada do código na área de trabalho do repositório no servidor e compartilhar seu projeto com a equipe.
Registro 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. É possível alterar suas preferências de Controle de Origem Jazz para especificar o registro de entrada automático. Também é possível trabalhar desconectado e registrar a entrada posteriormente quando reconectado.

Para verificar seu projeto no Controle de Origem Jazz:

  1. Abra a perspectiva Java. Se essa não for a perspectiva atual, clique em Janela > Abrir Perspectiva > Java.
  2. Na visualização Package Explorer, selecione o projeto Hello Prelude.
  3. Clique com o botão direito do mouse; em seguida, clique em Equipe > Compartilhar Projeto.
  4. No assistente Compartilhar Projeto, na página Compartilhar Projeto, selecione Controle de Origem Jazz e clique em Avançar.
  5. Na página Selecionar Componente, certifique-se de que a conexão do repositório chris@localhost seja selecionada a partir da lista suspensa na parte superior da página. Além disso, certifique-se de que Selecionar um componente em uma área de trabalho do repositório existente esteja selecionada. Expanda Chris no Prelúdio e selecione o Componente Padrão. Clique em Avançar.
  6. Embora provavelmente você não terá que alterar nada, na página Revisar Recursos Ignorados, verifique ou conclua os recursos para ignorar para compartilhamento. Clique em Concluir. Seu código agora foi verificado em seu espaço de trabalho do repositório, mas não foi entregue para o fluxo.
  7. Opcional: Alterne para a visualização Alterações Pendentes. Na perspectiva Java, clique em Janela > Mostrar Visualização > Alterações Pendentes. Ela já deve ter sido aberta quando você carregou e compartilhou seu projeto. Se você expandir Componente Padrão, será possível visualizar um conjunto de alterações para o projeto que você acabou de compartilhar. Nós controlamos a operação de compartilhamento e as alterações correspondentes foram registradas automaticamente na área de trabalho do repositório.
  8. Opcional: O conjunto de alterações já possui o comentário Compartilhar Projetos associado a ele. Para alterar o comentário, ou incluir comentários em futuros conjuntos de alterações que não obtêm um comentário automaticamente, clique com o botão direito do mouse no conjunto de alterações; em seguida, clique em Editar Comentário. Na área de janela de edição, digite um comentário e clique em Inserir.
  9. Opcional: Para navegar pela estrutura do diretório de componentes, na visualização Alterações Pendentes, clique com o botão direito do mouse em Componente Padrão; em seguida, clique em Mostrar > Arquivos de Repositório. Na visualização Arquivos de Repositório, você verá o projeto que acabou de compartilhar.
  10. Opcional: Para examinar o histórico da área de trabalho do repositório, na visualização Alterações Pendentes, clique com o botão direito do mouse em Componente Padrão; em seguida, clique em Mostrar > Histórico. A visualização Histórico lista o conjunto de alterações inicial de quando o componente foi criado e o segundo conjunto de alterações que você acabou de criar. Para explorar o conteúdo de um conjunto de alterações, dê um clique duplo em um conjunto de alterações. A visualização Explorador de Alterações é aberta e permite que você navegue pelos arquivos no 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.
Todas as alterações feitas são armazenadas na área de trabalho do repositório no repositório.

Para entregar as alterações e disponibilizá-las para o restante da equipe:

  1. Na visualização Alterações Pendentes, clique com o botão direito do mouse em um conjunto de alterações; em seguida, clique em Associar Item de Trabalho
  2. Na caixa de diálogo Selecionar Itens de Trabalho, limpe a caixa de opção Apenas Minhas Designações.
  3. No campo Contendo ID ou Texto, digite compartilhar. Os itens de trabalho que contêm a palavra compartilhamento em seu resumo serão exibidas.
  4. Selecione o item de trabalho denominado Compartilhar código com o Controle de Origem do Jazz e clique em OK. Esta ação cria uma conexão entre o código que você criou e o item de trabalho que você resolveu fazendo isso.
  5. Para entregar e resolver o item de trabalho, na visualização Alterações Pendentes, conclua as seguintes etapas:
    1. Clique com o botão direito do mouse no conjunto de alterações; em seguida, clique em Entregar e Resolver Item de Trabalho.
    2. Na caixa de diálogo Entregar e Resolver, certifique-se de que a caixa de opção Resolver Item de Trabalho esteja selecionada.
    3. Na área de janela Incluir um comentário no item de trabalho, digite um comentário que será incluído no item de trabalho.
    4. Clique em Concluir.
    O item de trabalho será resolvido e seu código agora terá sido entregue da área de trabalho do repositório no servidor para o fluxo da área da equipe, onde agora ele está acessível para o restante da equipe.
  6. Opcional: Atualize a visualização Histórico. A visualização mostra que o conjunto de alterações foi associado ao item de trabalho.
  7. Opcional: Na visualização Artefatos da Equipe, no Fluxo da Equipe 1, clique com o botão direito do mouse em Componente Padrão; em seguida, clique em Mostrar > Histórico. A visualização Histórico exibe seu conjunto de alterações no fluxo.
  8. Opcional: Na visualização Histórico, para abrir o item de trabalho associado ao conjunto de alterações, clique com o botão direito do mouse no conjunto de alterações; em seguida, clique em Abrir Itens de Trabalho. O item de trabalho será resolvido e conterá um link para o conjunto de alterações que você criou para esse trabalho.

Ponto de Verificação da Lição

Nesta lição você aprendeu os conceitos básicos do controle de origem do Jazz.
< Anterior | Próximo >

Feedback

Isto foi útil? É possível fornecer feedback em Jazz.net (é necessário registrar-se): Comentar nos fóruns ou submeter um erro