Exceto Recursos de Projeto de Eclipse do Controle de Versão

Se você instalou o Plug-in do Team Foundation Server para Eclipse em seu computador local, o Eclipse detectará automaticamente recursos novos ou alterados nos projetos e o Plug-in do Team Foundation Server para Eclipse acrescentará estes recursos à sua lista de alterações pendentes. Os recursos que são derivados de outro recurso, como arquivos de saída do processo de compilação, normalmente não são adicionados à lista de alterações pendentes. Porém, algumas configurações de compilação, como estas que executam etapas de compilação externa, podem criar recursos que a Eclipse não reconhece como derivados. Para impedir estes recursos de se tornarem adições pendentes ao controle de versão, você pode especificar dois conjuntos de filtros para determinar quais recursos devem ser excluídos do controle de versão:

Recursos Ignorados

Em Eclipse 3.0, você pode especificar os recursos para ignorar usando a página de Recursos Ignorados sob a categoria de preferência da Equipe. Esta página contém uma lista de caracteres curingas que se aplicam a recursos de projeto e qualquer recurso compatível não é acrescentado à lista de alterações pendentes. O Plug-in do Team Foundation Server para Eclipse testa primeiro esta lista de forma que você pode usá-la em vez do arquivo .tpignore em muitas circunstâncias. Porém, estas preferências não podem ser compartilhadas facilmente com outros membros da equipe. Cada membro da equipe deve configurar as Preferências Ignoradas para cada espaço de trabalho de Eclipse no seu computador local. Além disso, estas preferências correspondem a apenas o último segmento de um caminho de recurso: o arquivo ou nome de diretório no final. Portanto, você pode preferir usar o arquivo .tpignore.

Para modificar os Recursos Ignorados

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

    A caixa de diálogo Preferências aparece.

  2. Na lista de categorias, expanda o nó Equipe e clique em Recursos Ignorados.

  3. Execute uma ou mais das seguintes tarefas:

    • Para ignorar um padrão que aparece na lista Ignorar Padrões, marque a caixa de seleção que corresponda ao padrão.

    • Para parar de ignorar um padrão que aparece na lista Ignorar Padrões, desmarque a caixa de seleção que corresponda ao padrão.

    • Para acrescentar um padrão à lista Ignorar Padrões, clique em Adicionar Padrãoe então especifique o padrão que você deseja adicionar.

      Por padrão, as caixas de seleção são marcadas para todos os novos padrões.

  4. Clique OK para salvar suas alterações.

.tpignore Arquivo

Você pode especificar que um arquivo denominado .tpignore no diretório raiz de um projeto do Eclipse. O Plug-in do Team Foundation Server para Eclipse tem seu check-in feito cada hora que ele examina um recurso de Eclipse. Se o novo recurso corresponder com qualquer padrão no arquivo, o recurso não será adicionado à lista de alterações pendentes. Se o recurso não corresponder com qualquer dos padrões, ele será adicionado à lista de alterações pendentes. Você pode adicionar manualmente arquivos que correspondam aos padrões de exclusão usando o Cliente de linha de comando de plataforma híbrida para Team Foundation Server.

Você não precisa reiniciar o Eclipse quando modificar o arquivo com extensão .tpignore. Suas alterações entram em vigor quando ocorrer o próximo evento do recurso. O plug-in também carrega automaticamente as alterações que foram feitas a este arquivo se uma nova versão dele for recuperada no controle de versão.

Por padrão, arquivos que começem com um período não aparecem no Gerenciador de Pacotes, assim você pode precisar usar uma ferramenta diferente da Eclipse para criar, modificar ou excluir o arquivo .tpignore. Você também pode modificar seus filtros do Package Explorer para exibir arquivos que iniciam em um período. Depois que você criar um .tpignore arquivo, você pode adicioná-lo ao controle de versão para que os outros desenvolvedores usando o plug-in possam usar seus padrões. Você não tem que acrescentar o arquivo com extensão .tpignore ao controle de versão para usá-lo em seu computador local. Para obter mais informações sobre o formato de arquivo .tpignore, consulte .tpignore File Format.

Para fazer o Plug-in do Team Foundation Server para Eclipse iniciar automaticamente acrescentando recursos descobertos à lista de alterações pendentes, remova ou faça em um comentário a linha ou linhas no arquivo .tpignore que correspondam aos recursos que você deseja adicionar.

Comportamento de Correspondência

Os padrões no arquivo .tpignore são expressões Java regulares. As correspondências são executadas de um modo sem diferenciação de maiúsculas e minúsculas em sistemas operacionais onde o sistema de arquivos não difere maiúsculas de minúsculas e de um modo com diferenciação de maiúsculas e minúsculas em sistemas operacionais onde o sistema de arquivos difere maiúsculas de minúsculas.

Quando o plug-in testa um caminho de recurso de Eclipse para um diretório contra uma expressão regular no arquivo .tpignore, o plug-in assegura que o caminho sempre terminará em uma barra (/) antes do teste for executado. Isto permite que suas expressões regulares sejam mais simples quando você deseja corresponder um diretório. Os caminhos para arquivar recursos nunca terminam com uma barra. É importante lembrar-se que, para escrever seus padrões, todos os caminhos de recurso devem iniciar com uma barra.

.tpignore Formato de Arquivo

O arquivo .tpignore é um arquivo de texto. Cada linha é uma linha de comentário ou uma linha de padrão. Cada linha de padrão contém uma única expressão regular no estilo Java. O caminho para um recurso de Eclipse recém descoberto que corresponde a qualquer padrão do arquivo .tpignore não é adicionado à lista de alterações pendentes. Os espaços em branco em cada linha são ignorados quando as expressões são lidas do arquivo .tpignore.

Formato Backus-Naur (BNF)

    <.tpignore>             ::= { <line> }
    <line>                  ::= <comment-line> | <pattern-line> <EOL>
    <comment-line>          ::= "#" <ignored-text>
    <pattern-line>          ::= <java-regular-expression>

Exemplo

Você pode usar o seguinte arquivo com extensão .tpignore:

    # Lines that begin with #, like this one, are ignored.
    .*/core
    .*\.class
    .*/[^/]+\.class
    /some/path/README
    /output/.*
    /bin/

Cada linha é descrita como segue:

  1. A primeira linha mostra um comentário que será ignorado. Um arquivo .tpignore pode conter zero ou mais linhas de comentário.

  2. A segunda linha monstra uma expressão regular que corresponderá a qualquer caminho de recurso de Eclipse para um arquivo que termine com os caracteres “/core”, incluindo /core, /bin/core, e /caminho/muito/longo/core. O ". *" é sintaxe de expressão regular que significa "correspondem a zero ou mais ocorrências de qualquer caractere." O resto da linha especifica os caracteres literais a serem correspondidos. O recurso /bin/core/main.c não corresponde porque há caracteres adicionais no caminho de recurso depois da parte literal da expressão /core. Não corresponderá a diretórios porque todos os diretórios terminam com uma barra.

  3. A terceira linha mostra uma expressão regular que corresponderá a qualquer caminho de recurso de Eclipse para um arquivo que termina com o caracteres ".class." O período na extensão deve ser escapado porque o ele tem um significado especial na sintaxe da expressão regular Java (corresponde a qualquer caractere). Esta expressão corresponderia arquivos nomeados /Program.class ou /um/caminho/longo/Program.class. Não corresponderá a diretórios porque todos os diretórios terminam com uma barra.

  4. A quarta linha mostra uma expressão regular que corresponderá a qualquer caminho de recurso de Eclipse para um arquivo que termine com os caracteres ".class" e tem, pelo menos, um caractere antes do ponto no último segmento do caminho. Como na terceira linha, o ponto da extensão deve ser escapado. A sintaxe de expressão [^/] significa "correspondem a todos os caracteres neste grupo e ele contém todos os caracteres com exceção da barra." Isto faz com que a expressão corresponda aos arquivos nomeados /Program.class ou /um/caminho/longo/.class. Não corresponderá a diretórios porque todos os diretórios terminam com uma barra.

  5. A quinta linha mostra uma expressão regular que não usa nenhuma sintaxe especial mas ainda é avaliada como uma expressão regular. Simplesmente combina qualquer arquivo extamente de nome "/some/path/README". Não corresponde ao recurso de diretório "/some/path/README/", porque os caminhos de recurso de diretório sempre terminam em uma barra.

  6. A sexta linha mostra uma uma expressão regular que corresponde ao recurso de diretório "/output/" e quaisquer de seus filhos, quer sejam arquivos ou diretórios. Não corresponderá a um arquivo "/output" porque o padrão requer uma barra à direita e caminhos de arquivos não as têm.

  7. A sétima linha mostra uma expressão regular que corresponde apenas ao recurso de diretório "/bin/" e não aos seus filhos. Não corresponde a um arquivo a "/bin" porque especifica uma barra à direita que só está presente em caminhos de diretório.

Consulte também

Outros recursos

Colocando Arquivos em Versão Controle (Team Explorer Everywhere)

Faça Check-in das Alterações Pendentes (Team Explorer Everywhere)

Aplicando Atrivutos de Sistema de arquivos Unix a Arquivos sob Controle de Versão