Configurar um repositório GITSet 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 para exibir a caixa de diálogo Selecionar Repositório:In the Menu bar, select Version Control > Publish in Version Control 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

    Também é possível usar SSH para conectar-se ao GIT.It is also possible to use SSH to connect to Git.

  5. Para tentar publicar o aplicativo no GIT, selecione o repositório 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. Na janela Credenciais do Git, insira seu nome de usuário do GitHub e a senha.In the Git Credentials window, enter your GitHub username and password.

Note

Se sua conta tiver a 2FA (autenticação de dois fatores) habilitada, você precisará criar um token de acesso, que será usado no lugar de uma senha.If your account has two-factor authentication (2FA) enabled, you will 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.

  1. 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

  2. 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

  3. Depois de começar a fazer mais alterações, selecione Efetuar push das alterações para efetuar push das alterações ao 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:

    Efetuar push das alterações para um repositório remoto

Publicar um novo projetoPublishing a new project

A caixa de diálogo Novo projeto pode ser usada para criar um novo projeto com um repositório git local.The new project dialog can be used to create a new project with a local git repository. Para habilitá-lo, selecione a caixa de seleção Usar o git para controle de versão, conforme ilustrado na captura de tela a seguir.To enable it, select the Use git for version control 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:

Criar novo projeto com suporte ao git

Siga as etapas abaixo para efetuar push do seu novo repositório local para um novo repositório do GitHub:Follow the steps below to push your new local repository to a new GitHub repository:

Note

Se você ainda não tiver criado um repositório do GitHub, consulte a seção Criando um repositório remoto no GitHub.If you have not already created a GitHub repository, refer to the Creating a remote repo on GitHub section.

  1. Crie sua primeira confirmação acessando Controle de versão > Examinar a solução e confirmar na Barra de Menus.Create your first commit by going to Version Control > Review Solution and Commit in the Menu Bar.

  2. Na guia Status, escolha Confirmar no canto superior esquerdo.In the Status tab, choose Commit in the top left.

  3. Escreva uma mensagem de confirmação, por exemplo "Primeira Confirmação", depois clique em Confirmar:Write a commit message, for example "First Commit", then click on Commit:

    Confirmar alterações inicias para o repositório git

  4. Em seguida, na barra de menus, vá para Controle de versão > Gerenciar Branches e Remotos.Next, in the Menu Bar go to Version Control > Manage Branches and Remotes.

  5. Vá para a guia Fontes Remotas e, em seguida, clique em Adicionar.Go to the Remote Sources tab, then click Add.

  6. Na janela Fonte Remota, adicione os detalhes do seu repositório GitHub criado anteriormente e clique em OK:In the Remote Source window, add the details of your previously created GitHub repository and click OK:

    Configurar fontes remotas para o repositório git

  7. Feche a janela Configuração do Repositório Git e depois, na barra de menus, acesse Controle de Versão > Efetuar Push das Alterações.Close the Git Repository Configuration window, then in the Menu Bar go to Version Control > Push Changes.

  8. Na janela Efetuar Push ao Repositório, clique no botão Efetuar Push das Alterações:In the Push to Repository window click on the Push Changes button:

    Efetuar push das alterações para o repositório remoto

  9. Quando solicitado, insira seu nome de usuário do GitHub e a senha.When prompted, enter your GitHub username and password.

Note

Se sua conta tiver a 2FA (autenticação de dois fatores) habilitada, você precisará criar um token de acesso, que será usado no lugar de uma senha.If your account has two-factor authentication (2FA) enabled, you will 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.

O Visual Studio para Mac agora efetuará push das alterações para o repositório remoto do GitHub:Visual Studio for Mac will now push the changes to your remote GitHub repository:

Confirmação de que a operação efetuar push foi concluída com êxito

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

Provavelmente você precisará trabalhar com um repositório do GitHub que exista apenas remotamente e não em seu computador local.It's 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 rapidamente o check-out desse repositório.Visual Studio for Mac allows you to check this repo out 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

Poderão ocorrer problemas se o repositório tiver mais de 4 GB de tamanho.You may experience issues if the repo is over 4 GB 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:

  1. Acesse a pasta da solução.Go to your solution folder.
  2. Pressione Command + Shift + .Press Command + Shift + . para mostrar os arquivos e as pastas ocultos.to show the hidden files and folders.
  3. Se houver uma pasta .git, exclua-a.If there's a .git folder, delete it.
  4. Se houver um arquivo gitignore, exclua-o.If there's a gitignore file, delete it.
  5. Pressione Command + Shift + .Press Command + Shift + . para ocultar os arquivos e as pastas.to hide the files and folders.
  6. Abra a solução no VS para Mac.Open your solution in VS for Mac.
  7. No Painel de Soluções, selecione o nó da solução.On the solution Pad, select your solution node.
  8. 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.
  9. Siga as etapas do tutorial acima a partir da etapa 6.Follow the steps of the above tutorial starting from the step 6.

Consulte tambémSee also