Configurando um repositório GitSetting up a Git repository

O Git é um sistema de controle de versão distribuído que permite que as equipes trabalhem nos mesmos documentos simultaneamente.Git is a distributed version control system that allows teams to work on the same documents simultaneously. Isso significa que há um único servidor que contém todos os arquivos, mas sempre que um repositório passar por check-out nessa fonte central, todo o repositório será clonado localmente para seu computador.This means there is a single server that contains all the files, but whenever a repository is checked out from this central source, the entire repository is cloned locally to your machine.

Há muitos hosts remotos que permitem trabalhar com o Git para controle de versão, porém o mais comuns deles é o GitHub.There are many remote hosts that allow you to work with Git for version control, however the most common host is GitHub. O exemplo a seguir usa um host do GitHub, mas você pode usar qualquer host Git para controle de versão no Visual Studio para Mac.The following example uses a GitHub host, but you can use any Git host for version control in Visual Studio for Mac.

Se você quiser usar o GitHub, verifique se tem uma conta criada e configurada antes de seguir as etapas neste artigo.If you wish to use GitHub, make sure that you have an account created and configured before following the steps in this article.

Criando um repositório remoto no GitHubCreating a remote repo on GitHub

O exemplo a seguir usa um host do GitHub, mas você pode usar qualquer host Git para controle de versão no Visual Studio para Mac.The following example uses a GitHub host, but you can use any Git host for version control in Visual Studio for Mac.

Para configurar um repositório Git, execute as seguintes etapas:To set up a Git repository, execute the following steps:

  1. Crie um novo repositório Git em github.com:Create a new Git repo at github.com:

    Criar um novo repositório Git

  2. Defina o nome do repositório, a descrição e a privacidade.Set Repo Name, description, and privacy. Não inicialize o repositório.Do not initialize Repo. Defina .gitignore e a licença como Nenhum:Set .gitignore and license to None:

    Defina os detalhes do repositório git

  3. O próximo local fornecerá uma opção para exibir e copiar o endereço HTTPS ou SSH para o repositório que você criou:The next page gives you an option to display and copy either the HTTPS or SSH address to the repo you have created:

    exibir e copiar endereço

    Você precisará do endereço HTTPS para apontar o Visual Studio para Mac para este repositório.You'll need the HTTPS address to point Visual Studio for Mac to this repo.

Publicar um projeto existentePublishing an existing project

Se você tiver um projeto existente que ainda não está no controle de versão, use as seguintes etapas para configurá-lo no Git:If you have an existing project that is not already in version control, use the following steps to set it up in Git:

  1. Selecione o nome da Solução do Painel de Soluções do Visual Studio para Mac.Select the Solution name from the Solution Pad in Visual Studio for Mac.

  2. Na barra de menus, selecione Controle de versão > Publicar no Controle de versão...In the Menu bar, select Version Control > Publish in Version Control… para exibir a caixa de diálogo Selecionar Repositório:to display the Select Repository dialog:

    Iniciar o check-out no Visual Studio para Mac

    Se esse item de menu aparecer esmaecido no menu, verifique se você selecionou o nome da Solução.If this menu item appears greyed out in the menu, make sure you have selected the Solution name.

  3. Escolha a guia Repositórios registrados e pressione o botão Adicionar:Choose the Registered Repositories tab and press the Add button:

  4. Digite o nome do repositório como você gostaria de exibi-lo localmente e cole a URL da etapa 3.Enter the name of the repository as you would like it to display locally, and paste in the URL from step #3. A caixa de diálogo de Configuração do repositório deve ser semelhante ao seguinte.Your Repository Configuration dialog should look similar to the following. Pressione OK:Press OK:

    Caixa de diálogo Insira os detalhes do git

    Observe que também é possível usar o SSH para se conectar-se ao Git.Note that it is also possible to use SSH to connect to Git.

  5. Para tentar publicar o aplicativo no Git, selecione o repositório que você criou e verifique se ambos os campos de texto Nome do módulo e Mensagem foram preenchidos:To attempt to publish the app to Git, select the repository, and ensure that both Module Name and Message text fields are completed:

    Tentativa de publicar o projeto para o git

  6. Clique em OK e em Publicar na caixa de diálogo de alerta.Click Okay, and then Publish from the alert dialog.

  7. Se você já não tiver inserido suas credenciais do Git nas preferências do Visual Studio para Mac, digite-as agora.If you have not already entered your Git credentials in Visual Studio for Mac preferences, enter them now. Primeiro, será necessário criar um Token de acesso, que é usado em vez de uma senha.First, you need to create an Access Token, which is used in place of a password. Se você não criou um token de acesso, siga as etapas na documentação de Token de acesso do Git.If you have not created an access token, follow the steps in the Git Access Token documentation.

  8. Insira o nome de usuário e o token de acesso pessoal e pressione OK:Enter the username and Personal Access Token, and press Okay:

    Insira o nome de usuário e a senha para o git

  9. Depois de alguns segundos, a Solução deverá ser publicada com sua confirmação inicial.After a few seconds, the Solution should be published with its initial commit. Confirme que isso foi publicado navegando o item de menu de Controle de versão, que agora deve ser populado com várias opções:Confirm it has been published by browsing the Version Control menu item, which should now be populated with many options:

    Menu de Controle de versão

  10. Depois de começar a fazer mais alterações, selecione Efetuar push nas alterações... para enviar por push as alterações para o repositório remoto.Once you start to make additional changes, select Push Changes... to push the changes to the remote repository. Isso permitirá que todos os usuários apropriados possam exibi-las em github.com:This will allow all appropriate users to view it on github.com:

    Enviar alterações por push para um repositório remoto

Publicar um novo projetoPublishing a new project

A caixa de diálogo Novo projeto pode ser usada para publicar um novo projeto usando o git.The new project dialog can be used to publish a new project using git. Para habilitá-lo, marque a caixa de seleção Usar o git para controle de versão.To enable it, select the Use git for version control. conforme ilustrado na captura de tela a seguir.checkbox, as illustrated in the following screenshot. Isso inicializará seu repositório e adicionará um arquivo .gitignore opcional:This will initialize your repo and add an optional .gitignore file:

Enviar alterações por push para um repositório remoto

Fazer check-out de um repositório existenteCheckout an existing repository

É muito provável que você precisará trabalhar com um repositório do GitHub que exista apenas remotamente e não em seu computador local.It's very likely that you'll have to work with a GitHub repo that exists only on the remote, not on your local machine. O Visual Studio para Mac permite que você faça check-out desse repositório rapidamente.Visual Studio for Mac allows you to checkout this repo quickly. Siga as etapas abaixo para cloná-lo em seu computador:Follow the steps below to clone it to your machine:

  1. Na Barra de menus, selecione Controle de versão > Check-out...:In the Menu bar, select Version Control > Checkout…:

  2. Isso exibirá a guia Conectar ao Repositório:This displays the Connect to Repository tab:

    Conectar-se à guia Repositório com os detalhes inseridos

  3. Na página do GitHub do repositório remoto, pressione o botão Clonar ou Baixar e copie a URL fornecida:On the GitHub page of the remote repository, press the Clone or Download button and copy the URL provided:

    url do github exibida

  4. Substitua todo o texto no campo de entrada de URL na guia Conectar ao Repositório. Isso preencherá a maioria dos outros campos desta guia, conforme ilustrado na imagem da etapa nº 2.Replace all the text in the URL entry field in the Connect to Repository tab. This will populate most other fields in this tab for you, as illustrated in the image in step #2.

  5. Insira o diretório no qual você deseja clonar o repositório e pressione Check-out.Enter the directory that you want to clone the repo into and press Checkout.

Note

Você poderá enfrentar problemas se o repositório for superior a 4 GB de tamanho.You may experience issues if the repo is over 4GB in size.

Solução de problemasTroubleshooting

Se houver problemas ao inicializar seu projeto com um repositório remoto vazio, você poderá tentar executar as seguintes etapas:If you have issues with initializing your project with an empty remote repository, you can try the following steps:

  • Acesse a pasta da solução.Go to your solution folder.
  • Pressione Command + Shift + . para mostrar os arquivos e as pastas ocultos.Press Command + Shift + . To show the hidden files and folders.
  • Se houver uma pasta .git, exclua-a.If there's a .git folder, delete it.
  • Se houver um arquivo gitignore, exclua-o.If there's a gitignore file, delete it.
  • Pressione Command + Shift + . para ocultar os arquivos e as pastas.Press Command + Shift + . To hide the files and folders.
  • Abra a solução no VS para Mac.Open your solution in VS for Mac.
  • No painel de soluções, selecione o nó da sua solução.On the solution pad, select your solution node.
  • Navegue para o menu de Controle de versão e escolha Publicar no controle de versão.Browse to the Version Control menu and choose Publish in Version Control.
  • Siga as etapas do tutorial acima a partir da etapa 6.Follow the steps of the above tutorial starting from the step 6.