Conexão com o Controle de Versão do Team FoundationConnecting to Team Foundation Version Control

Note

Para obter a melhor experiência de controle de versão no macOS, recomendamos o uso do Git em vez do Controle de Versão do Team Foundation (TFVC).For the best version control experience on macOS, we recommend using Git instead of Team Foundation Version Control (TFVC). O Git é suportado no Visual Studio para Mac e é a opção padrão para repositórios hospedados no Team Foundation Server (TFS)/Azure DevOps.Git is supported in Visual Studio for Mac and is the default option for repositories hosted in Team Foundation Server (TFS)/Azure DevOps. Para saber mais sobre como usar o Git com o TFS/Azure DevOps, confira o artigo Configurar um Repositório Git.To learn more about using Git with TFS/Azure DevOps, see the Setting up a Git Repository article.

Se a versão prévia da extensão do TFVC para o Visual Studio para Mac foi usada anteriormente, ela não é mais compatível no Visual Studio 2019 para Mac.If you previously used the preview release of the TFVC extension for Visual Studio for Mac, it is no longer supported in Visual Studio 2019 for Mac.

O Azure Repos fornece dois modelos de controle de versão: Git, um sistema de controle de versão distribuído, e Controle de Versão do Team Foundation (TFVC), um sistema de controle de versão centralizado.Azure Repos provides two models of version control: Git, a distributed version control system, and Team Foundation Version Control (TFVC), a centralized version control system.

O Visual Studio para Mac fornece suporte completo para repositórios Git, mas requer algumas soluções alternativas para trabalhar com o TFVC.Visual Studio for Mac provides full support for Git repositories, but requires some workarounds to work with TFVC. Se você estiver usando o TFVC para o controle de versão hoje, veja abaixo algumas soluções que você poderá usar para acessar seu código-fonte hospedado no TFVC:If you're using TFVC for version control today, here are some solutions you can use to access your source code hosted in TFVC:

O restante deste artigo explica as opções listadas acima.The rest of this article walks you through the options listed above.

RequisitosRequirements

  • Visual Studio Community, Professional ou Enterprise para Mac versão 7.8 e posterior.Visual Studio Community, Professional, or Enterprise for Mac version 7.8 and later.
  • Azure DevOps Services, Team Foundation Server 2013 e posterior, ou Azure DevOps Server 2018 e posterior.Azure DevOps Services, Team Foundation Server 2013 and later, or Azure DevOps Server 2018 and later.
  • Um projeto no Azure DevOps Services ou no Team Foundation Server/Azure DevOps Server, configurado para usar o Controle de Versão do Team Foundation.A project in Azure DevOps Services or Team Foundation Server/Azure DevOps Server, configured to use Team Foundation Version Control.

Usar o Visual Studio Code e a extensão Azure ReposUse Visual Studio Code and the Azure Repos extension

Se você gosta de trabalhar com uma interface gráfica para gerenciar seus arquivos no controle de versão, a extensão Azure Repos para o Visual Studio Code fornece uma solução com suporte da Microsoft.If you like to work with a graphical interface to manage your files in version control, then the Azure Repos extension for Visual Studio Code provides a supported solution from Microsoft. Para começar, faça o download do Visual Studio Code e saiba como configurar a extensão do Azure Repos.To get started, download Visual Studio Code and then learn how to configure the Azure Repos extension.

Conectar-se usando o cliente de linha de comando Team Explorer EverywhereConnecting using the Team Explorer Everywhere Command Line Client

Se você se sentir confortável usando o macOS Terminal, o Cliente de Linha de Comando do Team Explorer Everywhere (TEE-CLC) fornecerá uma forma com suporte de se conectar à sua fonte no TFVC.If you're comfortable using the macOS Terminal, then the Team Explorer Everywhere Command Line Client (TEE-CLC) provides a supported way to connect to your source in TFVC.

Você pode seguir as etapas abaixo para configurar sua conexão com o TFVC e confirmar as alterações.You can follow the steps below to set up your connection to TFVC and commit changes.

Configurar o TEE-CLCSetting up the TEE-CLC

Há duas maneiras de configurar com o TEE-CLC.There are two ways to get setup with the TEE-CLC.

  • Use o Homebrew para instalar o cliente ouUse Homebrew to install the client, or
  • Baixe e instale manualmente o clienteDownload and manually install the client

A solução mais fácil é usando o HomeBrew, que é um gerenciador de pacotes para macOS.The easiest solution is using HomeBrew, which is a package manager for macOS. Para instalar usando esse método:To install using this method:

  1. Inicie o aplicativo macOS Terminal.Launch the macOS Terminal application.
  2. Instale o Homebrew usando o Terminal e as instruções na página inicial do Homebrew.Install Homebrew using the Terminal and the instructions on the Homebrew home page.
  3. Uma vez instalado o Homebrew, execute o seguinte comando no seu Terminal: brew install tee-clcOnce Homebrew is installed, run the following command from your Terminal: brew install tee-clc

Para configurar manualmente o TEE-CLC:To setup the TEE-CLC manually:

  1. Faça o download da versão mais recente do tee-clc da página de lançamentos do repositório GitHub Team Explorer Everywhere (por exemplo, tee-clc-14.134.0.zip no momento desta publicação).Download the latest version of the tee-clc from the releases page of the Team Explorer Everywhere GitHub repo (e.g. tee-clc-14.134.0.zip at the time of this writing).
  2. Extraia o conteúdo do .zip para uma pasta no disco.Extract the content of the .zip to a folder on disk.
  3. Abra o aplicativo macOS Terminal e use o comando cd para alternar para a pasta usada na etapa anterior.Open the macOS Terminal app and use the cd command to switch to the folder you used in the previous step.
  4. Na pasta, execute o comando ./tf para testar se o cliente da linha de comando pode ser executado, você pode ser solicitado a instalar o Java ou outras dependências.From within the folder, run the command ./tf to test that the command line client can run, you may be prompted to install Java or other dependencies.

Depois que o TEE-CLC estiver instalado, você poderá executar o comando tf eula para visualizar e aceitar o contrato de licença do cliente.Once the TEE-CLC is installed, you can run the command tf eula to view and accept the license agreement for the client.

Por fim, para autenticar com seu ambiente TFS/Azure DevOps, você precisará criar um token de acesso pessoal no servidor.Finally, to authenticate with your TFS/Azure DevOps environment, you'll need to create a personal access token on the server. Saiba mais sobre autenticação com tokens de acesso pessoal.Learn more about authenticating with personal access tokens. Ao criar um token de acesso pessoal para usar com o TFVC, certifique-se de fornecer acesso completo ao configurar o token.When creating a personal access token to use with TFVC, be sure to provide Full Access when configuring the token.

Usar o TEE-CLC para se conectar ao seu repositórioUsing the TEE-CLC to connect to your repo

Para se conectar ao seu código-fonte, primeiro você precisa criar um espaço de trabalho usando o comando tf workspace.To connect to your source code, you first need to create a workspace using the tf workspace command. Por exemplo, os seguintes comandos se conectam a uma Organização no Azure DevOps Services chamada "MyOrganization":For example, the following commands connect to an Organization in Azure DevOps Services called "MyOrganization":

export TF_AUTO_SAVE_CREDENTIALS=1
tf workspace -new MyWorkspace -collection:https://dev.azure.com/MyOrganization

A configuração do ambiente TF_AUTO_SAVE_CREDENTIALS é usada para salvar suas credenciais, para que você não seja solicitado a inseri-las várias vezes.The TF_AUTO_SAVE_CREDENTIALS environment setting is used to save your credentials so you aren't prompted to enter them multiple times. Quando for solicitado um nome de usuário, use o token de acesso pessoal criado na seção anterior e use uma senha em branco.When prompted for a user name, use the personal access token you created in the previous section and use a blank password.

Para criar um mapeamento de seus arquivos de origem para uma pasta local, você usará o comando tf workfold.To create a mapping of your source files to a local folder, you'll use the tf workfold command. O exemplo a seguir mapeará uma pasta chamada "WebApp.Services" do projeto TFVC "MyRepository" e a configurará para ser copiada para a pasta ~/Projects/ local (ou seja, uma pasta "Projects" na pasta inicial dos usuários atuais).The following example will map a folder named "WebApp.Services" from the "MyRepository" TFVC project and set it up to be copied into the local ~/Projects/ folder (i.e. a "Projects" folder in the current users's home folder).

tf workfold -map $/MyRepository/WebApp.Services -workspace:MyWorkspace ~/Projects/

Por fim, use o seguinte comando para obter os arquivos de origem do servidor e copiá-los localmente:Finally, you use the following command to get the source files from the server and copy them locally:

tf get

Confirmar as alterações usando o TEE-CLCCommitting changes using the TEE-CLC

Depois de fazer alterações em seus arquivos no Visual Studio para Mac, você pode voltar ao Terminal para verificar suas edições.After you've made changes to your files in Visual Studio for Mac, you can switch back to the Terminal to check in your edits. O comando tf add é usado para adicionar arquivos à lista de alterações pendentes a serem registradas e o comando tf checkin executa a entrada real no servidor.The tf add command is used to add files to the list of pending changes to be checked-in and the tf checkin command performs the actual check-in to the server. O comando checkin inclui parâmetros para adicionar um comentário ou associar um item de trabalho relacionado.The checkin command includes parameters to add a comment or associate a related work item. No trecho de código a seguir, todos os arquivos em uma pasta WebApp.Services são adicionados, recursivamente, ao check-in.In the following code snippet, all files in a WebApp.Services folder are added, recursively, to the checkin. Em seguida, o código é verificado com um comentário e associado a um item de trabalho com a ID "42".Then, the code is checked in with a comment and associated with a work item with the ID "42".

cd WebApp.Services
tf add * /recursive
tf checkin -comment:"Replaced 'Northwand' typos with the correct word Northwind" -associate:42

Para aprender mais sobre os comandos mencionados aqui, ou outros, você pode usar o seguinte comando do Terminal:To learn more about the commands mentioned here, or others, you can use the following command from the Terminal:

tf help

Consulte tambémSee also