Ramificando Arquivos e Pastas (Team Explorer Everywhere)

Você pode usar ramificações para realizar as seguintes tarefas:

  • Gerencie trabalho simultâneo com várias equipes na mesma base de código.

  • Isole riscos que são apresentados por conjuntos diferentes de alterações na base de código.

  • Obtenha instantâneos e então suporte as alterações isoladas subsequentes (por exemplo, criar uma versão ou ramificação de atendimento).

Por exemplo, a ilustração seguinte mostra como a empresa fictícia DinnerNow desenvolveu uma estrutura de ramificação para satisfazer suas necessidades comerciais:

VcViewHierarchyExample

Caracterize a Equipe A e B, cada uma faz seu trabalho em ramificações separadas. Quando as equipes estiverem prontas para integrar seus trabalhos, elas mesclarão suas remificações na ramificação de Dev. Quando as compilações da ramificação de Dev estiverem estáveis e prontas para teste, as equipes mesclarão a ramificação de Dev na ramificação de Teste.

Ao passo que cada versão é laçada, a ramificação Principal é transformada em uma nova ramificação de versão, como a ramificação Version1 e a Version2. Seguindo esta estratégia, a empresa pode aprimorar ou corrigir cada versão anterior do produto separadamente.

ObservaçãoObservação

A ramificação é uma técnica importante e poderosa que sua equipe pode usar para criar um conjunto alternativo de versões para seus arquivos. Porém, as ramificações podem adicionar complexidade e custo ao seu projeto. Por exemplo, você pode ter que resolver conflitos quando mesclar ramificações.

Antes de criar uma ramificação, você deve considerar se pode satisfazer melhor suas necessidades através da aplicação de um rótulo. Aplicando um rótulo, você pode obter informações rapidamente e facilmente sobre o estado dos seus arquivos para que você possa então recuperar ou compilar os arquivos em um estado específico. Para obter mais informações, consulte Use Rótulos para Obter um Instantâneo de Seus Arquivos (Team Explorer Everywhere).

Neste tópico

  • Convert a Folder to a Branch

  • Branch a Branch

  • Branch a Folder or File

Converta uma Pasta para uma Ramificação

A versão de Visual Studio Team Foundation Server 2010 iniciou uma distinção entre ramificações e pastas. A ilustração seguinte mostra o nível superior da estrutura de pastas para DinnerNow:

Estrutura de pastas DinnerNow no Gerenciador do Controle do Código-Fonte

vcExplorerFoldersAndBranchesCalloutsTEE

Como mostra a ilustração, você ainda pode usar pastas para organizar ramificações na hierarquia do sistema de arquivos para um projeto de equipe sob controle de versão. Porém, pastas e ramificações têm uma aparência e recursos diferentes. Quando você clica com o botão direito em uma pasta ou ramificação e então clica em Propriedades, você exibe informações diferentes e funcionalidade diferente.

Quando você executar operações de ramificação, as ramificações têm vantagens importantes sobre as pastas. Ramificações suportam características de controle de versão que fornecem visibilidade extra em sua estrutura de ramificação e em onde seus conjuntos de alterações foram mesclados.

Observação importanteImportante

No cliente Visual Studio para Team Foundation Server 2010, você pode exibir uma representação visual de suas ramificações. Esta visualização de ramificação não está disponível em Team Explorer Everywhere 2010.

Você não pode aninhar ramificações. Portanto, você não poderá converter nenhuma pasta para uma ramificação se ela contiver uma ramificação ou estiver contida por uma ramificação. Por exemplo, a ilustração seguinte mostra como nem o pai nem o filho da ramificação FeatureTeamA podem ser convertidos a uma ramificação.

Ramificações aninhadas não são permitidas

Você pode ainda ramificar e mesclar entre ramificações, mas a melhor prática é a de ramificar e mesclar apenas entre ramificações. O seguinte procedimento explica como converter uma pasta a uma ramificação.

Permissões Necessárias

Para executar o seguinte procedimento, sua permissão Gerenciar ramificação deve ser definida para Permitir. Para obter mais informações, consulte a seguinte página no site da Microsoft: Permissões do Team Foundation Server.

ObservaçãoObservação

Você não pode usar o Cliente de linha de comando de plataforma híbrida para Team Foundation Server para converter uma pasta em uma ramificação.

Para converter uma pasta para uma ramificação

  1. Em Gerenciador de Controle do Código-Fonte, clique com o botão direito na pasta que você deseja converter e então clique em Converter para Ramificação.

    A caixa de diálogo Converter Pasta em Ramificação aparece.

    Observação importanteImportante

    Se você estiver convertendo uma pasta que você já ramificou, marque a caixa de seleção Execute recursivamente esta conversão a todas as pastas filhos ramificadas. Esta opção também converte a ramificações todas as pastas que foram ramificadas desta pasta.

  2. (Opcional) Em Proprietário, digite o nome do usuário que possui esta ramificação.

    ObservaçãoObservação

    O campo Proprietário é apenas para obter informações. Nenhuma permissão adicional é concedida ao usuário nomeado no campo Proprietário.

  3. (Opcional) Em Descrição, digite informações que você acha que poderiam ajudar aos outros membros da equipe que devem usar esta ramificação ou entender sua finalidade.

  4. Clique em Converter.

Ramifique uma Ramificação

Depois de converter uma pasta a uma ramificação, você pode criar outras ramificações da mesma ramificação.

Permissões Necessárias

Para executar este procedimento, sua permissão de Gerenciar Ramificação deve ser definida para Permitir para os caminhos das ramificações de origem e destino. A sua permissão de Mesclar para o caminho da ramificação de destino deve estar definida para Permitir. Para obter mais informações, consulte a seguinte página no site da Microsoft: Permissões do Team Foundation Server.

Observação importanteImportante

Você não pode usar o Cliente de linha de comando de plataforma híbrida para Team Foundation Server para ramificar uma ramificação.

Para ramificar uma ramificação

  1. Em Gerenciador de Controle do Código-Fonte, clique com o botão direito na ramificação que você deseja ramificar e então clique em Ramificar.

    A caixa de diálogo Ramificar de aparece.

  2. Em Nome da Ramificação de Destino, especifique o caminho da nova ramificação.

  3. (Opcional) Na lista Feito por , clique em um das seguintes opções:

    • Se você clicar em Última Versão, a ramificação será criada para a versão mais recente no controle de versão.

    • Se você clicar em Conjunto de Alterações, poderá especificar o número do conjunto de alterações na caixa Conjunto de Alterações. Como alternativa, você também pode clicar nas reticências (...) para abrir a caixa de diálogo Localizar Conjuntos de alterações.

      Para obter mais informações, consulte Search for a Changeset.

    • Se você clicar em Rótulo, você pode digitar o nome de rótulo na caixa Rótulo. Como alternativa, você pode clicar também nas reticências (...) para abrir a caixa de diálogo Localizar Rótulo.

      Para obter mais informações, consulte List, Find, View, Edit, and Remove Labels.

    • Se você clicar em Data, você pode especificar uma data na caixa Data.

    • Se você clicar em Versão do Espaço de Trabalho, você pode especificar um computador e um espaço de trabalho Team Foundation Server na caixa Espaço de Trabalho.

  4. Clique em Ramificar.

Ramifique uma Pasta ou Arquivo

Observação importanteImportante

Na maioria dos casos, este procedimento não é a prática mais recomendada. Porém, em Visual Studio Team System 2008 Team Foundation Server e Visual Studio 2005 Team Foundation Server, você pode usar apenas este tipo de ramificação. Você não pode converter pastas em ramificações ou ramificar uma ramificação.

Você pode ainda ramificar diretamente uma pasta ou arquivo, mas este tipo de operação não é normalmente a melhor abordagem para a maioria das finalidades. A prática mais recomendada é a de ramificar e só mesclar entre ramificações, como descrita antes neste tópico.

Permissões Necessárias

Para executar este procedimento, sua permissão de Check-Out e sua permissão de Mesclar para o caminho designado deve ser definida para Permitir. Para obter mais informações, consulte a seguinte página no site da Microsoft: Permissões do Team Foundation Server.

Para ramificar uma pasta ou arquivo

  1. Em Gerenciador de Controle do Código-Fonte, clique com o botão direito na pasta ou arquivo que você deseja ramificar e então clique em Ramificar.

    A caixa de diálogo Ramificar aparece.

  2. Em Destino, modifique o local e o nome nova ramificação.

    Você também pode clicar em Procurar para especificar um destino.

  3. Na lista Por , clique em um das seguintes opções:

    • Se você clicar em Última Versão, a ramificação será criada para a versão mais recente no controle de versão.

    • Se você clicar em Conjunto de Alterações, poderá especificar o número do conjunto de alterações na caixa Conjunto de Alterações. Como alternativa, você também pode clicar nas reticências (...) para abrir a caixa de diálogo Localizar Conjuntos de alterações.

      Para obter mais informações, consulte Search for a Changeset.

    • Se você clicar em Rótulo, você pode digitar o nome de rótulo na caixa Rótulo. Como alternativa, você pode clicar também nas reticências (...) para abrir a caixa de diálogo Localizar Rótulo.

      Para obter mais informações, consulte List, Find, View, Edit, and Remove Labels.

    • Se você clicar em Data, você pode especificar uma data na caixa Data.

    • Se você clicar em Versão do Espaço de Trabalho, você pode especificar um computador e um espaço de trabalho Team Foundation Server na caixa Espaço de Trabalho.

  4. (Opcional) Selecione a caixa de seleção Criar cópias de trabalho locais para a nova ramificação para criar uma cópia do item de versão controlada no espaço de trabalho local. Desmarque a caixa de seleção se você não precisar de uma cópia local e se você deseja melhorar o desempenho não baixando muitos itens para seu computador.

  5. (Opcional) Marque a caixa de seleção Converter as pastas de origem e de destino para ramificações para converter as pastas de origem e de destino para ramificações. Desmarque a caixa de seleção se você deseja converter apenas a pasta de destino para uma ramificação.

  6. Clique em OK.

    A ramificação é criada e aparece no Gerenciador de Controle do Código-Fonte.

    Uma janela de Procurar Pasta aparece se você marcar a caixa de seleção Criar cópias de trabalho locais para a nova ramificação e se a pasta local que você especificou não for mapeada no espaço de trabalho atual.

  7. (Opcional) Procurar por uma pasta ou clique em Criar Nova Pasta, especifique uma pasta para sincronizar os itens de versão controlada e então clique em OK.

Para ramificar uma pasta ou arquivo em um prompt de comando

  • Em um prompt de comando, digite tf branch ItemSpec BranchName e pressione ENTER.

    Substitua ItemSpec pelo nome do arquivo ou pasta que você deseja ramificar. Substitua o BranchName pelo nome da ramificação que você deseja criar.

    Para obter mais informações, consulte a seguinte página no site da Microsoft: Comando Ramificar (Controle de Versão da Team Foundation).

Consulte também

Outros recursos

Ramificando e Mesclando (Team Explorer Everywhere)

Use Rótulos para Obter um Instantâneo de Seus Arquivos (Team Explorer Everywhere)

Mesclando Arquivos e Pastas (Team Explorer Everywhere)