Plataformas de linha de comando cliente - guia para iniciantes

Se você estiver desenvolvendo aplicativos em plataformas UNIX comuns, você pode usar o Cliente da Linha de Comando da Plataforma Cruzada para acessar o Team Foundation Server e executar operações de controle de versão.

Aqui está como começar com o cliente de linha de comando:

1. Instalar o Cliente da Linha de Comando da Plataforma Cruzada:

   1. Abra o arquivo compactado (arquivo .zip) que contém o cliente.

   2. Configurar o caminho do shell ou do sistema para incluir a pasta onde os arquivos não zipados são arquivados.Certificar-se de que você tenha o Ambiente de Tempo de Execução do Java ou o Kit de Desenvolvimento Java no caminho ou de que você definiu a variável de ambiente de JAVA_HOME.

   3. Para verificar se o cliente está funcionando, em um prompt de comando, digite tf, e escolha a chave Enter .

      Se o cliente está instalado corretamente, a saída que começa com Team Explorer Everywhere aparece.

      Para obter informações sobre alguns dos comandos, digite tf help Command, onde Command é o nome do comando para o qual você deseja a informação.Por exemplo, digite tf help checkin.

2. Exibir e aceitar os termos de licença de software Microsoft para o cliente de linha de comando da plataforma cruzada.Você precisa executar o comando de EULA abaixo antes de executar todas as operações de controle de versão.

   tf eula
   

   Termos de licença para software Microsoft serão exibidos.Você precisará digitar “yes” ou “y” para aceitar os termos.

3. Execute o comando workspace para criar um espaço de trabalho local.Um espaço de trabalho inclui pastas de cliente no disco local mapeado para pastas de controle de versão no servidor do Team Foundation.

   O exemplo a seguir cria um novo espaço de trabalho chamado Beta1 na coleção TFS “http://myserver:8080/tfs/DefaultCollection”.

   tf workspace -new Beta1 -collection:http://myserver:8080/tfs/DefaultCollection
   

   Observação
   Quando você cria ou edita um espaço de trabalho, você pode especificar se sua localização é local ou em um servidor.o local é a configuração padrão.Ele permite que você execute rapidamente operações de controle de versão principal mesmo quando você está offline.

4. Execute o comando workfold criar mapeamentos de espaço de trabalho entre pastas locais e pastas no servidor.Por padrão, os mapeamentos de espaço de trabalho são aplicados recursivamente.Quando você mapear uma pasta local para uma pasta de servidor, o sistema implicitamente cria um mapeamento entre todas suas subpastas atuais e futuras.

   O exemplo a seguir mapeia a pasta /Users/Example no espaço de trabalho Beta1 para a Controle de versão do Team Foundation pasta do servidor $/ScrumProject/JavaSample.

   tf workfold -map $/ScrumProject/JavaSample -workspace:Beta1 /Users/Example
   

5. Altere o diretório para o caminho da pasta de trabalho local que você mapeou.Por exemplo,

   cd /Users/Example
   

6. Execute o comando get para recuperar uma cópia de um arquivo do Team Foundation Server ou para sincronizar seu espaço de trabalho com as alterações mais recentemente registradas por check-in no servidor.Por exemplo,

   tf get
   

7. Editar um arquivo.As alterações são marcadas como alterações pendentes no espaço de trabalho local.

8. Crie um novo arquivo e torne-o executável.Por exemplo,

   $ chmod u+x HelloWorld.sh
   

9. Execute o comando de add para adicionar o novo arquivo ao Team Foundation Server.Por exemplo,

   tf add Helloworld.sh
   

10. Execute o comando status para examinar informações sobre alterações pendentes de itens no espaço de trabalho.

    tf status 
    

11. Execute o comando checkin para fazer o check-in das alterações pendentes do espaço de trabalho atual para o Team Foundation Server.

    O exemplo a seguir envia as alterações pendentes associadas ao item de trabalho 11 no espaço de trabalho atual para o servidor Controle de versão do Team Foundation junto com o comentário especificado para criar um novo conjunto de alterações.

    tf checkin -comment:"Fixed a bug” -associate:11 
    

Observação
Para obter mais informações sobre a sintaxe de comando e a conexão ao Team Foundation Server, consulte Sintaxe de linha de comando (em todos os lugares Team Explorer) e Autenticação de linha de comando para Team Explorer em todos os lugares.

Você concluiu as operações básicas de controle de versão usando o cliente de linha de comando.Aqui estão mais algumas operações que você também pode precisar:

• Execute o comando renomear para alterar o nome ou o caminho de um arquivo ou pasta.

  O exemplo a seguir altera o nome de test1.txt para NewTest.txt.

  tf rename test1.txt NewTest.txt
  

• Execute o comando de delete para remover um arquivo ou uma pasta do Team Foundation Server e excluí-lo do disco.Os resultados deste comando não são visíveis em outros espaços de trabalho até que você execute uma operação de check-in.Por exemplo,

  tf delete Test-new.txt
  

  Observação

  Se você tiver excluído um item no seu espaço de trabalho, mas não fizer a verificação da mudança, você pode restaurar o item ao seu espaço de trabalho e remover a exclusão da sua lista de modificações pendentes usando o comando undo. Você não pode excluir um item para o qual existe outra alteração pendente.Por exemplo, um arquivo com check-out não pode ser excluído.Para excluir estes itens você deve desfazer o atual durante a alteração.

Observação
Se você não quiser digitar a linha por linha de comandos, você pode escrever um script para automatizar todas as tarefas anteriores.Consulte Scripts no cliente de linha de comando para Team Foundation Server o cruzamento-plataforma.

Consulte também

Conceitos

Autenticação de linha de comando para Team Explorer em todos os lugares

Definir variáveis de ambiente (em todos os lugares Team Explorer)

Scripts no cliente de linha de comando para Team Foundation Server o cruzamento-plataforma

Gerenciamento de ciclo de vida de aplicativos com Visual Studio e de Team Foundation Server

Outros recursos

A adoção de Team Explorer em todos os lugares

Sintaxe de linha de comando (em todos os lugares Team Explorer)