Comparando Itens de Controle de Versão (Team Explorer Everywhere)

Você pode comparar duas versões de um arquivo ou uma pasta em um computador local ou um servidor de controle de versão identificar as diferenças entre essas versões. Por exemplo, você pode executar esta tarefa para identificar as diferenças entre duas ramificações ou entre versões do seu aplicativo. Você pode usar uma das várias abordagens para comparar arquivos e pastas.

Tarefa
Compare arquivos ou pastas: Você pode comparar uma versão de um texto ou arquivo XML ou uma pasta no computador local com uma versão no servidor de controle de versão. Você também pode comparar duas versões que estão no computador local ou duas versões que estão no servidor de controle de versão. Você pode executar estas comparações a partir da interface de usuário normalmente ou em um prompt de comando se você configurar uma ferramenta de comparação externa. Compare uma versão no computador local com a versão que você originalmente fez o check-out do servidor de controle de versão Compare uma versão no computador local com uma versão especificada no servidor de controle de versão Compare duas versões no computador local Compare duas versões no servidor de controle de versão
Configure ferramentas de comparação: Se você configurar uma ferramenta externa, será possível comparar arquivos que não são texto ou XML e você poderá exibir os resultados na interface do usuário ou em um prompt de comando. Você também pode configurar uma ferramenta externa se preferí-la à ferramenta padrão que o Plug-in do Team Foundation Server para Eclipse fornece. Importante Você deve configurar uma ferramenta externa antes que possa comparar arquivos ou pastas em um prompt de comando. Configure uma Ferramenta Externa para Comparar Tipos de Arquivos Adicionais Configure uma Ferramenta Externa para Comparar Itens com Prompt de Comando
Exibir linhas alteradas em um único arquivo: Exibindo as anotações, você pode exibir não só as linhas que foram alteradas em um arquivo, mas também o nome do usuário que alterou cada linha e a data e hora quando ela foi alterada. Esta exibição não fornece nenhuma comparação lado a lado. Identifica as Alterações Exibindo as Anotações

Permissões Necessárias

Para comparar um item no servidor de controle de versão com um item no servidor ou em um computador local, sua permisão Ler 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 comparar dois arquivos em um computador local, você não precisa de permissões em Visual Studio Team Foundation Server.

Compare uma versão no computador local com a versão que você originalmente fez o check-out do servidor de controle de versão

Você pode desejar identificar as alterações que fez a um ou mais arquivos em uma pasta local desde que você fez o check-out de controle de versão deles.

Para comparar os arquivos ou pastas usando o Gerenciador de Projeto ou Gerenciador de Pacote

• Em Gerenciador de Pacote ou Gerenciador de Projeto, clique com o botão direito no arquivo ou pasta que você deseja comparar, aponte-o para a Equipe, aponte-o para Comparar Come então clique em Versão de Espaço de Trabalho Não Modificada.

Para comparar um arquivo com sua versão de espaço de trabalho em um prompt de comando

1. Abra uma janela de Prompt de comando.

2. Digite tf diff FileName e pressione ENTER.

   Substitua FileName pelo caminho do arquivo que você deseja comparar. Para obter mais informações, consulte Comando Divergência (Controle de Versão da Team Foundation) no site da Microsoft.

   Importante
   Antes de você iniciar este procedimento, deve seguir as instruções em Configure an External Tool to Compare Items at a Command Prompt.

   O arquivo é comparado com a versão que foi para seu espaço de trabalho local.

Para comparar uma pasta e seus conteúdos com as versões de espaço de trabalho inalteradas de um prompt de comando

1. Abra uma janela de Prompt de comando.

2. Digite tf diff FolderName /recursive e pressione ENTER.

   Substitua FolderName pelo caminho da pasta cujos conteúdos você deseja comparar. Para obter mais informações, consulte Comando Divergência (Controle de Versão da Team Foundation) no site da Microsoft.

   Importante
   Antes de você iniciar este procedimento, deve seguir as instruções em Configure an External Tool to Compare Items at a Command Prompt.

   Os arquivos na pasta que você especificou são comparados com as versões que tiveram seu check-out feito no seu espaço de trabalho local.

Compare uma versão no computador local com uma versão específica no servidor de controle de versão

Você pode comparar uma versão de um item em um computador local com quaisquer das versões seguintes daquele item no servidor de controle de versão:

• A versão que é a mais recente

• A versão que tem um número de versão específico

• A versão que existiu em uma data específica

• A versão que tem um rótulo específico

• A versão como existiu em um conjunto de alterações específico

• A versão que você fez o check-out para seu espaço de trabalho local

  Observação
  Para obter mais informações, consulte Compare a version on the local computer to the version that you originally checked out.

Para comparar os arquivos no Gerenciador de Pacote ou Gerenciador de Projeto

1. Em Gerenciador de Pacote ou Gerenciador de Projeto, clique com o botão direito em um dos arquivos que você deseja comparar, aponte-o para a Equipe, aponte-o para Comparar Come então clique em Outra Versão.

   A caixa de diálogo Escolher Itens para Comparar aparece.

2. (Opcional) Em Item selecionado (origem), especifique um arquivo de origem diferente.

3. Em **Comparar com (destino)**clique em Procurar para especificar o arquivo.

   Você também pode digitar o caminho e nome do arquivo para o qual você deseja comparar o arquivo de origem.

4. Para especificar uma versão do arquivo de destino que não seja o mais recente, execute uma das seguintes tarefas:

   • Clique em Conjunto de Alteraçõese então especifique o número do conjunto de alterações ou clique 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.

   • Clique em Datae então especifique uma data digitando ou abrindo o menu e clicando em uma data no calendário.

   • Clique em Rótuloe então especifique um rótulo digitando ou clicando 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.

   • Clique em Versão do Espaço de Trabalhoe então especifique o espaço de trabalho cuja versão que você deseja comparar.

5. Clique em OK para comparar os arquivos especificados.

Para comparar pastas do Gerenciador do Controle do Código-Fonte

1. Em Gerenciador de Controle do Código-Fonte, clique com o botão direito em uma das pastas que você deseja comparar e então clique em Comparar.

   A caixa de diálogo Escolher Itens para Comparar aparece. Por padrão, a pasta especificada no servidor é comparada com a pasta correspondente em seu computador local.

2. Para especificar uma versão da pasta do servidor que não seja o mais recente, execute uma das seguintes tarefas:

   • Clique em Conjunto de Alteraçõese então especifique o número do conjunto de alterações ou clique 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.

   • Clique em Datae então especifique uma data digitando ou abrindo o menu e clicando em uma data no calendário.

   • Clique em Rótuloe então especifique um rótulo digitando ou clicando 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.

   • Clique em Versão do Espaço de Trabalhoe então especifique o espaço de trabalho cuja versão que você deseja comparar.

3. Clique OK para iniciar a comparação.

   Uma caixa de diálogo de progresso aparece enquanto os arquivos são comparados. A janela Comparar Texto aparece quando a comparação estiver concluída.

4. (Opcional) Na janela Comparação de Texto, use os botões da barra de ferramentas para procurar as diferenças entre os arquivos.

Para comparar pastas em um prompt de comando

1. Abra uma janela de Prompt de comando.

2. Digite tf diff FirstFolder SecondFolder /recursive e pressione ENTER.

   Substitua FirstFolder e SecondFolder pelos caminhos das pastas que você deseja comparar. Para obter mais informações, consulte Comando Divergência (Controle de Versão da Team Foundation) no site da Microsoft.

   Importante
   Antes de você iniciar este procedimento, deve seguir as instruções em Configure an External Tool to Compare Items at a Command Prompt.

   Os arquivos nas pastas especificadas são comparados.

Compare duas versões no computador local

Em Team Explorer Everywhere, você pode comparar dois arquivos ou pastas locais apenas usando o Gerenciador de Projeto ou Gerenciador de Pacote. Você não pode realizar esse tipo de comparação do Gerenciador do Controle do Código-Fonte ou em um prompt de comando.

Para comparar os arquivos ou pastas usando o Gerenciador de Projeto ou Gerenciador de Pacote

1. Em Gerenciador de Pacote ou Gerenciador de Projeto, realce os dois arquivos ou pastas que você deseja comparar.

2. Clique com o botão direito no arquivo ou pasta, aponte para Equipe, aponte para Comparar Come então clique em Um ao outro.

Compare duas versões no servidor de controle de versão

Você pode desejar comparar duas versões de um arquivo ou de uma pasta no servidor de controle de versão se, por exemplo, deseja identificar alterações que foram feitas como parte de um check-in. Além disso, você pode desejar identificar as alterações que foram feitas entre versões do seu aplicativo.

Você pode comparar versões de servidor do Gerenciador do Controle do Código-Fonte ou em um prompt de comando.

Para comparar duas versões de servidor do Gerenciador de Controle do Código-Fonte

1. Em Gerenciador de Controle do Código-Fonte, clique com o botão direito em um dos arquivos ou pastas que você deseja comparar e então clique em Comparar.

   A caixa de diálogo Escolher Itens para Comparar aparece. Por padrão, a fonte é definida como um item no seu computador local e o destino é definido como o item equivalente em seu servidor de controle de versão.

2. Em Item selecionado (origem), clique na seta Procurar, clique em Caminho do Servidore então clique em Procurar.

   Você também pode especificar o item de origem digitando o caminho do arquivo ou pasta de origem no servidor (por exemplo, $/DefaultAgile/fatura-serviço).

3. (Opcional) Para especificar uma versão do item que não seja o mais recente, execute uma das seguintes tarefas:

   1. Clique em Conjunto de Alteraçõese então especifique o número do conjunto de alterações ou clique 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.

   2. Clique em Datae então especifique uma data digitando ou abrindo o menu e clicando em uma data no calendário.

   3. Clique em Rótuloe então especifique um rótulo digitando ou clicando 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.

   4. Clique em Versão do Espaço de Trabalhoe então especifique o espaço de trabalho cuja versão que você deseja comparar.

4. Em Comparar com (destino), repita as etapas 2-3 para especificar o outro item que você deseja comparar e então clique em OK para iniciar a comparação.

   Uma caixa de diálogo de progresso aparece enquanto os arquivos são comparados. A janela Comparar Texto aparece quando a comparação estiver concluída.

5. (Opcional) Na janela Comparação de Texto, use os botões da barra de ferramentas para procurar as diferenças entre os arquivos ou pastas.

Para comparar arquivos em um prompt de comando

1. Abra uma janela de Prompt de comando.

2. Digite tf diff FirstItem SecondItem e pressione ENTER.

   Substitua FirstItem e SecondItem pelos caminhos dos arquivos que você deseja comparar. Além disso, você pode especificar a versão dos arquivos que você deseja comparar. Por exemplo, para comparar a versão do arquivo App.java que estava no conjunto de alterações 3200 com a versão que tem o nome de "versão", você usa a seguinte sintaxe: tf diff App.java;C3200 App.java;Lrelease.

   Para obter mais informações, consulte Comando Divergência (Controle de Versão da Team Foundation) no site da Microsoft.

   Importante
   Antes de você iniciar este procedimento, deve seguir as instruções em Configure an External Tool to Compare Items at a Command Prompt.

   Os arquivos nas pastas especificadas são comparados.

Para comparar pastas em um prompt de comando

1. Abra uma janela de Prompt de comando.

2. Digite tf diff FirstItem SecondItem /recursive e pressione ENTER.

   Substitua FirstItem e SecondItem pelos caminhos das pastas que você deseja comparar. Além disso, você pode especificar a versão das pastas que você deseja comparar. Por exemplo, para comparar a versão da pasta do serviço de cobrança que estava no conjunto de alterações 3200 com a versão que tem o rótulo de "versão", você usa a seguinte sintaxe: tf diff billing-service;C3200 billing-service;Lrelease.

   Para obter mais informações, consulte Comando Divergência (Controle de Versão da Team Foundation) no site da Microsoft.

   Importante
   Antes de você iniciar este procedimento, deve seguir as instruções em Configure an External Tool to Compare Items at a Command Prompt.

   Os arquivos nas pastas especificadas são comparados.

Configure uma Ferramenta Externa para Comparar Tipos de Arquivos Adicionais

Para comparar arquivos que não são texto ou XML, você deve configurar uma ferramenta externa para funcionar com o Plug-in do Team Foundation Server para Eclipse. Você também pode configurar uma ferramenta externa se preferí-la à ferramenta incorporada. Você pode usar qualquer ferramenta de comparação que suporte, como argumentos de linha de comando, os caminhos completos dos dois arquivos que você deseja comparar. Quando você configurar uma ferramenta de comparação, especifique um ou mais tipos de arquivos para comparar, o caminho para a ferramenta e a sintaxe da ferramenta. Especifique sua sintaxe da ferramenta através do uso de argumento como as indicações na tabela que aparece neste tópico posteriormente.

Quando você iniciar uma comparação, forneça valores específicos, como caminhos de arquivos, para estes tokens. O Plug-in do Team Foundation Server para Eclipse invoca a ferramenta externa e a passa para os argumentos apropriados para a sintaxe da ferramenta, substituindo os tokens com os valores que você forneceu. A ferramenta externa executa a comparação real e os resultados aparecem no plug-in.

Quando você especificar a sintaxe para a ferramenta, use o espaço em branco para delimitar os argumentos, como tokens. Se um argumento incluir um ou mais espaços, você deve incluí-lo em aspas (“”). Se um argumento contiver uma ou mais aspas, você deve adicionar outras aspas imediatamente depois de qualquer aspas no argumento. Por exemplo, você pode especificar o seguinte argumento:

"This "" embeds a double quote"

Você não tem que incluir um token % entre aspas, mesmo que o seu valor possa conter espaços.

Tokens

A tabela seguinte descreve os tokens que você usa quando você especifica a sintaxe de uma ferramenta externa:

Tokens	Exigido ou Opcional	Descrição
%1	Necessário	O caminho do arquivo de origem
%2	Necessário	O caminho do arquivo de destino
%5	Não usado, mas retido para compatibilidade com o cliente de Visual Studio para Visual Studio Team Foundation Server.	Comparação das opções de linha de comando(não usadas)
%6	Optional	Rótulo para o arquivo de origem
%7	Optional	Rótulo para o arquivo de destino

Para configurar uma ferramenta de comparação externa para tipos adicionais de arquivos

1. No menu Janela , clique em Preferências.

   A caixa de diálogo Preferências aparece.

2. Expanda o nó Team , expanda o nó Team Foundation Server e então clique em Ferramentas de Comparação.

   No painel de resultados, aparece uma lista das ferramentas de comparação externas configuradas. Por padrão, nenhuma ferramenta é configurada.

3. Para associar um ou mais tipos de arquivos com uma ferramenta de comparação, siga estas etapas:

   1. Clique em Adicionar.

      A caixa de diálogo Adicionar Ferramenta de Comparação Externa aparece.

   2. Em Tipos de Arquivo, especifique as extensões de nome de arquivo que você deseja usar com a ferramenta de comparação.

      Você pode especificar várias extensões, separadas por vírgulas, ou usar o caractere curinga (*) para especificar todos os tipos de arquivos.

4. Para associar todas as pastas com uma ferramenta de comparação, siga esta etapa:

   • Em Comando Diretório, clique em Adicionar.

     A caixa de diálogo Adicionar Ferramenta de Comparação Externa aparece.

5. Em Comando, especifique a sintaxe da ferramenta de comparação que você deseja usar.

   Esta sintaxe inclui o caminho da ferramenta de comparação e os argumentos que ela aceita. Você pode clicar em Procurar para especificar o caminho da ferramenta de comparação.

6. Clique em OK para concluir a configuração.

7. Clique em OK para fechar o caixa de diálogo Preferências.

Exemplo

Por exemplo, para especificar a sintaxe seguinte, especifique a ferramenta OtherDiff para arquivos Java:

C:\Program Files\OtherDiff\otherdiff.exe %1 %2

Você também pode estar apto a especificar rótulos para cada arquivo. Se você não especificar estes rótulos, a ferramenta mostrará os nomes de arquivos temporários que podem ser difíceis de ler.

Para fornecer rótulos, você pode especificar a seguinte sintaxe:

C:\Program Files\MyDiff\mydiff.exe %1 –title1=%6 %2 /title2=%7

Se você especificar esta sintaxe, %7 especifica o rótulo de arquivo %2 e %6 especifica o rótulo de arquivo %1.

Configure uma Ferramenta Externa para Comparar Itens com Prompt de Comando

Se você deseja comparar arquivos ou pastas em um prompt de comando, primeiro deve configurar uma ferramenta externa que compare os itens. Por padrão, o Cliente de linha de comando de plataforma híbrida para Team Foundation Server não tem nenhuma ferramenta de comparação. Quando você configurar uma ferramenta, especifique sua sintaxe usando tokens na tabela que aparece anteriormente neste tópico. Para obter as informações mais recentes sobre como especificar esta sintaxe, abra um prompt de comando, e digite tf help diff. Quando você usar o comando tf diff, especifique os valores que são passados à ferramenta externa em vez dos tokens e então a ferramenta externa comparará os arquivos ou pastas.

Observação
Você pode abreviar tf difference com tf diff.

Quando você configurar uma ferramenta externa para o comando tf diff, você deve usar os tokens %1 e %2 para representar os caminhos dos arquivos de origem e de destino.

Você pode usar os tokens %6 e %7 para especificar um título compreensível para os arquivos de origem e de destino. Se os valores destes tokens podem conter espaços, você deve incluir os valores entre aspas.

Exemplos

Ferramenta de comparação	O valore da variável de ambiente TF_DIFF_COMMAND
GNU diff	diff -u "%1" "%2"
Diff de GNU com rótulos	diff -u --label "%6 / %7" "%1" "%2"
SourceGear DiffMerge	diffmerge --title1="%6" --title2="%7" "%1" "%2"

Identifica as Alterações de Arquivo Exibindo as Anotações

Você pode exibir anotações para um arquivo de versão controlada para determinar quem realizou alterações e que linhas eles alteraram em todas as versões anteriores do arquivo. Quando você exibir as anotações, o arquivo aparecerá apenas em seu estado atual. Você não exibe uma comparação lado a lado de duas versões do arquivo.

Para executar estes procedimentos, suas permissão de Leitura deve ser definido para Allow. Para obter mais informações, consulte a seguinte página no site da Microsoft: Permissões do Team Foundation Server.

Importante
No Plug-in do Team Foundation Server para Eclipse, você pode usar apenas o comando Anotar do Gerenciador de Projeto ou Gerenciador de Pacote. Você não pode usar o comando Anotar a partir do Gerenciador do Controle do Código-Fonte.

Para exibir anotações de um arquivo

• Em Gerenciador de Projeto ou Gerenciador de Pacote, clique com o botão direito no arquivo que você deseja exibir as anotações, aponte-o para a Equipee então clique em Anotar.

  Uma janela de anotação aparece e exibe o conteúdo do arquivo que você especificou. Na extremidade esquerda da janela, um canal colorido indica quais linhas já foram alteradas.

  Se você apontar para qualquer seção do canal colorido, as informações sobre o conjunto de alteração aparecerão em uma dica de ferramenta. Você pode pressionar a F2 para abrir uma janela para procurar informações do conjunto de alterações.

  Você poderá personalizar a exibição das informações de revisão se você clicar com o botão direito nelas, apontar para Revisãoe em seguida clicar em uma opção.

Consulte também

Outros recursos

Usando o Controle de Versão (Team Explorer Everywhere)

Resolver Conflitos entre Dois Arquivos (Team Explorer Everywhere)