O Visual Studio para Mac oferece suporte para o Controle de Versão do Team Foundation?

Cuidado

A versão prévia da extensão do TFVC para o Visual Studio para Mac não é mais compatível com o Visual Studio 2019 para Mac.

Opções alternativas de controle de versão no Visual Studio para Mac

Para a melhor experiência de controle de versão no macOS, é recomendável usar o Git em vez de Controle de Versão do Team Foundation (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. Para saber mais sobre como usar o Git com o TFS/Azure DevOps, confira o guia Configurar um Repositório Git.

Soluções alternativas sem suporte para TFVC

Embora o Visual Studio para Mac não forneça oficialmente o suporte para TFVC, este guia proporciona algumas soluções alternativas para trabalhar com TFVC no macOS. 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:

Opção 1. Usar Visual Studio Code e a extensão Azure Repos dados

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. Para começar, faça o download do Visual Studio Code e saiba como configurar a extensão do Azure Repos.

Opção 2. Conectando-se usando o Team Explorer Everywhere de linha de comando

Importante

Conforme o arquivo Leiame do Team Explorer Everywhere, este projeto não recebe mais manutenção.

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.

Você pode seguir as etapas abaixo para configurar sua conexão com o TFVC e confirmar as alterações.

Configurar o TEE-CLC

Há duas maneiras de configurar com o TEE-CLC.

  • Use o Homebrew para instalar o cliente ou
  • Baixe e instale manualmente o cliente

A solução mais fácil é usando o HomeBrew, que é um gerenciador de pacotes para macOS. Para instalar usando esse método:

  1. Inicie o aplicativo macOS Terminal.
  2. Instale o Homebrew usando o Terminal e as instruções na página inicial do Homebrew.
  3. Uma vez instalado o Homebrew, execute o seguinte comando no seu Terminal: brew install tee-clc

Para configurar manualmente o TEE-CLC:

  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).
  2. Extraia o conteúdo do .zip para uma pasta no disco.
  3. Abra o aplicativo macOS Terminal e use o comando cd para alternar para a pasta usada na etapa anterior.
  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.

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.

Por fim, para autenticar com seu ambiente TFS/Azure DevOps, você precisará criar um token de acesso pessoal no servidor. Saiba mais sobre autenticação com tokens de acesso pessoal. Ao criar um token de acesso pessoal para usar com o TFVC, certifique-se de fornecer acesso completo ao configurar o token.

Usar o TEE-CLC para se conectar ao seu repositório

Para se conectar ao seu código-fonte, primeiro você precisa criar um workspace usando o comando tf workspace. Por exemplo, os seguintes comandos se conectam a uma Organização no Azure DevOps Services chamada "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. 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.

Para criar um mapeamento de seus arquivos de origem para uma pasta local, você usará o comando tf workfold. 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).

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:

tf get

Confirmar as alterações usando o 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. 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. O comando checkin inclui parâmetros para adicionar um comentário ou associar um item de trabalho relacionado. No snippet de código a seguir, todos os arquivos em uma pasta WebApp.Services são adicionados, recursivamente, ao check-in. Em seguida, o código é verificado com um comentário e associado a um item de trabalho com a 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:

tf help

Confira também