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

Note

O suporte para o Controle de Versão do Team Foundation está em versão prévia no momento e algumas funcionalidades ainda não estão funcionando totalmente.Team Foundation Version Control support is currently in preview and some functionality is not yet fully working. Adoraríamos receber seus comentários sobre problemas na Comunidade de Desenvolvedores.We'd love feedback from you on any issues at Developer Community. Mais alterações ainda estão por vir!More changes are still to come!

O Azure Repos fornece dois modelos de controle de versão: o GIT, que é o controle de versão distribuído, e o TFVC (Controle de Versão do Team Foundation), que é o controle de versão centralizado.Azure Repos provides two models of version control: Git, which is distributed version control, and Team Foundation Version Control (TFVC), which is centralized version control. Este artigo fornece uma visão geral e um ponto de partida para usar o TFVC com o Visual Studio para Mac.This article provides an overview and a starting point for using TFVC with Visual Studio for Mac.

RequisitosRequirements

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

InstalaçãoInstallation

No Visual Studio para Mac, escolha Visual Studio > Extensões no menu.In Visual Studio for Mac, choose Visual Studio > Extensions from the menu. Na guia Galeria, selecione Controle de Versão > Controle de Versão do Team Foundation para o TFS e o VSTS e clique em Instalar:In the Gallery tab, select Version Control > Team Foundation Version Control for TFS and VSTS and click Install:

Gerenciador de extensões

Siga os prompts para instalar a extensão.Follow the prompts to install the extension. Depois de instalá-la, reinicie o IDE.Once it's installed, restart the IDE.

Atualizando a extensãoUpdating the extension

Periodicamente, são feitas atualizações na extensão do TFVC.Updates to the TFVC extension are made periodically. Para acessar as atualizações, escolha Visual Studio > Extensões... no menu e selecione a guia Atualizações. Selecione a extensão na lista e pressione o botão Atualizar:To access updates, choose Visual Studio > Extensions... from the menu and select the Updates tab. Select the extension in the list and press the Update button:

Gerenciador de extensão mostrando a atualização

Pressione Instalar na próxima caixa de diálogo para desinstalar o pacote antigo e instalar um novo.Press Install on the next dialog to uninstall the old package and install the new one.

Para obter informações sobre as novidades em cada versão, confira as Notas de Versão.For information on what's new in each release, see the Release Notes.

Usando o suplementoUsing the add-in

Depois de instalar a extensão, selecione o item de menu Controle de Versão > TFS/Azure DevOps > Abrir do Repositório Remoto.Once the extension is installed, select the Version Control > TFS/Azure DevOps > Open from Remote Repository menu item.

Item de menu para abrir a extensão

Escolha o VSTS ou o Team Foundation Server para começar e pressione Continuar:Choose either VSTS or Team Foundation Server to get started and press Continue:

Conectar a um servidor

Autenticação do Azure ReposAzure Repos Authentication

Quando você seleciona um projeto que está hospedado no Azure Repos, é solicitado que você insira os detalhes da conta Microsoft:When you select a project that is hosted on Azure Repos, you're prompted to enter your Microsoft account details:

Conectar-se com o Azure Repos

Autenticação do TFSTFS Authentication

Para conectar-se ao TFS, insira os detalhes do servidor e suas credenciais da conta.To connect to TFS, enter the server details and your account credentials. Insira um domínio para usar a autenticação NTLM, caso contrário, deixe em branco para usar a autenticação básica.Enter a domain to use NTLM authentication, otherwise leave blank to use basic authentication. Selecione Adicionar Servidor:Select Add Server:

Entrar em um servidor TFS

Selecionando um projetoSelecting a project

Depois que você se autenticar com êxito, será exibida uma lista de repositórios associados à conta na caixa de diálogo Abrir do Controle do Código-Fonte:Once you've successfully authenticated, you can see a list of repositories that are associated with the account in the Open from Source Control dialog:

Caixa de diálogo Abrir do Controle do Código-Fonte com projetos exibidos

Essa caixa de diálogo é organizada com os seguintes nós:This dialog is organized with the following nodes:

  • Organização ou coleção do Azure DevOps – Exibe todas as organizações conectadas à conta Microsoft com que você fez logon.Azure DevOps organization or collection – This displays all organizations connected to the Microsoft account you logged in with.
  • Projetos – Em cada organização ou coleção, você pode ter um número de projetos.Projects - In each organization or collection, you can have a number of projects. Um projeto é onde o código-fonte, os itens de trabalho e os builds automatizados são hospedados.A project is where source code, work items, and automated builds are hosted.

Neste ponto, você pode pesquisar e filtrar pelo nome de um projeto ou de uma organização.At this point, you can search and filter by the name of a project or organization.

Adicionando um novo servidorAdding a new server

Para adicionar um novo servidor à lista, pressione o botão Adicionar Host na caixa de diálogo Abrir do Controle do Código-Fonte:To add a new server to the list, press the Add Host button on the Open from Source Control dialog:

Botão de adição realçado para adicionar o novo servidor à lista

Selecione o provedor na lista e insira suas credenciais:Select the provider from the list, and enter your credentials:

Caixa de diálogo mostrando a opção de provedor de controle do código-fonte

Criando um novo workspaceCreating a new workspace

Para começar a trabalhar com um projeto, você precisa ter um workspace.To start working with a project, you need to have a workspace. Se você ainda não tem um workspace, crie um na caixa de combinação Workspace na caixa de diálogo Abrir do Controle do Código-Fonte:If you don't already have a workspace, you can create one from the Workspace combobox in the Open from Source Control dialog:

Opção da caixa de combinação Criar workspace

Defina o nome e o caminho local para seu novo workspace e selecione Criar Workspace:Set the name and local path for your new workspace and select Create Workspace:

Inserindo um nome e um caminho local para o novo workspace

Usando o Source Code ExplorerUsing the Source Code Explorer

Depois de criar um workspace e mapear o projeto, você poderá começar a trabalhar com o Source Code Explorer.Once you've created a workspace and mapped your project, you can start working with the Source Code Explorer.

Para abrir o Source Code Explorer, selecione o item de menu Controle de Versão > TFS/Azure DevOps > Source Control Explorer.To open the Source Code Explorer, select the Version Control > TFS/Azure DevOps > Source Control Explorer menu item.

O Source Code Explorer permite que você navegue em todos os projetos mapeados e em seus arquivos e pastas.The Source Code Explorer enables you to navigate through all the mapped projects, their files, and folders. Ele também permite que você execute todas as ações básicas de controle do código-fonte, como:It also allows you to perform all the basic source control actions such as:

  • Obter a versão mais recenteGet the latest version
  • Obter uma versão específicaGet a specific version
  • Fazer check-out e check-out de arquivosCheck files in and out
  • Bloquear e desbloquear arquivosLock and unlock files
  • Adicionar, excluir e renomear arquivosAdd, delete, and rename files
  • Exibir históricoView history
  • Comparar alterações.Compare changes.

Muitas dessas ações estão disponíveis por meio de ações de contexto no projeto:Many of these actions are available through context actions on the project:

Ações de menu de contexto para um projeto

Gerenciando workspacesManaging workspaces

Se você ainda não criou um espaço de trabalho, conforme descrito na seção Criando um espaço de trabalho, o Source Code Explorer estará vazio:If you haven't already created a workspace, as described in the Creating a workspace section, you'll notice that the Source Code Explorer is empty:

Source Code Explorer vazio

Para configurar seu projeto remoto com um workspace local, use as seguintes etapas:To set up your remote project with a local workspace, use the following steps:

  1. Selecione o Servidor na caixa de combinação.Select the Server from the combobox.

  2. Observe que não há "nenhum workspace" e o caminho local está como "Não Mapeado".Note that there are "no workspaces" and that the Local Path is "Not Mapped". Selecione o link Não Mapeado para exibir a caixa de diálogo Criar Workspace.Select the Not Mapped link to display the Create new Workspace dialog.

  3. Forneça um nome para o workspace e, em seguida, clique em Adicionar Pasta de Trabalho para mapear o projeto para uma pasta local no seu computador:Provide a name for the workspace and then click Add Working Folder to map the project to a local folder on your computer:

    Caixa de diálogo Criar Workspace, mostrando as opções padrão

  4. Selecione a pasta "$" para mapear todos os projetos em seu servidor para o mesmo espaço de trabalho ou selecione um projeto individual e clique em OK:Select the "$" folder to map all projects on your server to the same workspace, or select an individual project, and click OK:

    Navegue para a caixa de diálogo de pasta mostrando todos os projetos

  5. Selecione o local em seu computador local para onde deseja mapear os projetos e clique em Selecionar Pasta.Select the location on your local machine that you wish to map the project(s) to and click Select Folder.

  6. Confirme os detalhes do novo workspace pressionando OKConfirm the details of the new workspace by pressing OK

    Caixa de diálogo Criar Workspace, com a pasta de trabalho adicionada

Depois que o workspace for configurado, ele poderá ser alterado ou removido clicando no botão Gerenciar Workspaces no Source Code Explorer.Once your workspace is set up, it can be changed or removed by clicking the Manage Workspaces button in the Source Code Explorer.

Gerenciar Workspaces

Solução de problemasTroubleshooting

Problemas no uso da autenticação básicaProblems using basic authentication

As opções a seguir podem ser usadas para a autenticação no servidor:The following options can be used to authenticate with a server:

  • OAuthOauth
  • BasicBasic
  • NTLMNtlm

Para usar a autenticação Básica é necessário habilitar Credenciais de autenticação alternativas no Azure DevOps Services, seguindo as etapas abaixo:To use basic authentication it is necessary to enable Alternative authentication credentials in Azure DevOps Services, by following the steps below:

  1. Entre em sua organização do Azure DevOps como o proprietário (https://dev.azure.com/{organization}/{project}).Sign in to your Azure DevOps organization as the owner (https://dev.azure.com/{organization}/{project}).

  2. Na barra de ferramentas da organização, selecione o ícone de engrenagem e escolha Política:From your organization toolbar, select the gear icon and select Policy:

    Opção de configurações de política selecionada

  3. Examine as configurações de conexão do aplicativo.Review your application connection settings. Altere essas configurações, com base em suas políticas de segurança:Change these settings, based on your security policies:

    Opção de configurações de política selecionada

Não vejo nada no TFVCI do not see anything in TFVC

Para definir o TFVC (Controle de Versão do Team Foundation) no computador de desenvolvimento, você precisa criar um workspace, conforme a descrição na seção Gerenciando workspaces.To set up Team Foundation Version Control (TFVC) on your dev machine, you must create a workspace, as described in the Managing workspaces section.

No Source Control Explorer, pressione o botão Gerenciar Workspaces.In Source Control Explorer, press the Manage Workspaces Button. Siga as etapas para mapear o projeto para uma pasta no computador de desenvolvimento.Follow the steps to map the project to a folder on your dev machine.

Não vejo um/nenhum dos meus projetosI do not see any / all of my projects

Após a autenticação, você deverá ver a lista de projetos.After authenticating you should see the list of projects. Por padrão, apenas os projetos do TFS são mostrados.By default, only TFS projects are shown. Para ver outros tipos de projetos, marque a caixa "Ver todos os projetos".To see other types of projects, check the "See all projects" box.

Tenha em mente que os projetos que estão no servidor não serão exibidos se você não tiver os privilégios corretos.Keep in mind that projects that are on the server will not appear if you don't have the correct privileges.

Estou recebendo o erro "Não é possível criar o workspace.I am getting the error "Cannot create the workspace. Tente novamente"Please, try again"

Ao tentar criar um workspace, verifique se as seguintes condições são atendidas:When trying to create a new workspace, you should make sure the following conditions are met:

  • Nenhum uso de caracteres inválidos no nome do workspace.No use of invalid characters in the workspace name.
  • O nome deve ter menos de 64 caracteres.The name must be less than 64 characters.
  • O caminho local não pode ser usado por outros workspaces.The local path cannot be used by any other workspaces.

Consulte tambémSee also