Tutorial: abrir um projeto de um repositório

  • Artigo

Neste tutorial, você usará o Visual Studio para se conectar a um repositório pela primeira vez, cloná-lo e, em seguida, abrir um projeto nele.

Se você ainda não tiver instalado o Visual Studio, acesse a página Downloads do Visual Studio para instalá-lo gratuitamente.

Abrir um projeto de um repositório GitHub

O Visual Studio facilita a abertura de um projeto de um repositório. Você pode fazer isso quando iniciar o Visual Studio ou diretamente de dentro do Visual Studio IDE.

Veja aqui como fazer isso.

Usar a janela de início

  1. Abra o Visual Studio.

  2. Na janela inicial, selecione Clonar um repositório.

    Screenshot of the Clone a Repository dialog in Visual Studio.

  3. Insira ou digite a localização do repositório e, em seguida, selecione o botão Clonar.

    Screenshot of the Clone a Repository dialog in Visual Studio where you enter a Git repo URL.

  4. Se ainda não estiver conectado, talvez seja solicitado que você faça login no Visual Studio ou na sua conta do GitHub.

    Dica

    Para obter mais informações sobre como entrar no Visual Studio, consulte a página Entrar no Visual Studio. Para obter informações específicas sobre como usar a conta do GitHub para entrar, consulte a página Trabalhar com contas do GitHub no Visual Studio. E se você receber uma notificação de confiança e quiser saber mais sobre ela, consulte a página Definir configurações de confiança para arquivos e pastas.

Mostrar arquivos no Gerenciador de Soluções

  1. Em seguida, o Visual Studio carrega as soluções do repositório usando o Modo de Exibição de Pasta no Gerenciador de Soluções.

    Screenshot of the Folder View in Solution Explorer in Visual Studio 2022.

    Você pode exibir uma solução no Modo de Exibição de Solução clicando duas vezes em seu arquivo .sln.

    Ou, você pode selecionar o botão Alternar Modos de Exibição e, em seguida, selecionar Program.cs para exibir o código de uma solução.

    Screenshot of a project in Git that's open in Solution Explorer, with the Switch Views button highlighted.

Dica

Você pode mudar da visualização de pasta padrão para a visualização de solução no menu Git. Selecione Configurações>Controle do Código-Fonte>Configurações globais do Git>Carregar a solução automaticamente ao abrir um repositório do Git para fazer isso.

Abrir um projeto localmente de um repositório GitHub clonado anteriormente

  1. Abra o Visual Studio.

  2. Na janela de início, clique em Abrir um projeto ou uma solução.

    O Visual Studio abre uma instância do Explorador de Arquivos, em que você pode navegar até a solução ou projeto e selecioná-la para abrir.

    Screenshot of the 'Open a project or solution' window in Visual Studio 2022.

    Dica

    Se você abriu o projeto ou a solução recentemente, selecione-o na seção Abrir recente para abri-lo rapidamente novamente.

    Iniciar codificação!

Usar o IDE

Você também pode usar o menu Git ou o controle Selecionar Repositório no Visual Studio IDE para interagir com pastas e arquivos de um repositório.

Veja aqui como fazer isso.

Para clonar um repositório e abrir um projeto

  1. No Visual Studio IDE, selecione o menu Git e, em seguida, selecione Clonar Repositório.

    Screenshot of the Git menu in Visual Studio 2022 with Clone Repository selected.

  2. Siga os prompts para se conectar ao repositório Git que inclui os arquivos que você está procurando.

Para abrir pastas e arquivos locais

  1. No Visual Studio IDE, selecione o menu Git, selecione Repositórios Locais e, em seguida, selecione Abrir Repositório Local.

    Screenshot of the Git menu in Visual Studio 2022 with the Local Repository and Open Local Repository showing.

  2. Siga os prompts para se conectar ao repositório Git que possui os arquivos que você está procurando.

Procurar um repositório do Azure DevOps

Veja como procurar e clonar um repositório do Azure DevOps usando o Visual Studio.

  1. Abra o Visual Studio.

  2. Na janela inicial, selecione Clonar um repositório.

    Screenshot of the Clone a Repository dialog in Visual Studio, for Azure DevOps.

  3. Na seção Navegar em um repositório, selecione Azure DevOps.

    Screenshot of the 'Browse a repository' section of the 'Clone a repository' dialog box in Visual Studio, Azure DevOps highlighted.

  4. Siga os prompts para clonar um repositório do Azure DevOps que inclui os arquivos que você está procurando e abra seu projeto.

Abrir um projeto de um repositório GitHub com o Visual Studio 2019

A forma como você abre um projeto de um repositório do GitHub usando o Visual Studio depende da versão que você tem. Especificamente, se você instalou o Visual Studio 2019 versão 16.8 ou posterior, há uma experiência do Git no Visual Studio nova e totalmente integrada disponível para você.

Mas não importa qual versão você instalou, você sempre pode abrir um projeto de um repositório do GitHub com o Visual Studio.

Visual Studio 2019 versão 16.8 e posterior

Veja como usar o Git no Visual Studio 2019 versão 16.8 ou posterior.

Clonar um repositório GitHub e, em seguida, abrir um projeto

  1. Abra o Visual Studio 2019.

  2. Na janela inicial, selecione Clonar um repositório.

    Screenshot of the Clone a Repository dialog in Visual Studio 2019 version 16.8 and later

  3. Insira ou digite a localização do repositório e, em seguida, selecione Clonar.

    Screenshot of the Clone a Repository dialog where you enter a Git repo URL in Visual Studio 2019 version 16.8 and later.

  4. Você pode ser solicitado a fornecer informações de entrada do usuário na caixa de diálogo Informações do Usuário do Git. Você pode adicionar suas informações ou editar as informações padrão fornecidas.

    Screenshot of the Git User Information dialog where you enter or edit your account info in Visual Studio 2019 version 16.8 and later.

    Selecione Salvar para adicionar as informações ao arquivo .gitconfig global. (Ou você pode selecionar Cancelar se quiser salvar as informações mais tarde.)

    Dica

    Para obter mais informações sobre como entrar no Visual Studio, consulte a página Entrar no Visual Studio. E para obter informações específicas sobre como usar a conta do GitHub para entrar, consulte a página Trabalhar com contas do GitHub no Visual Studio.

    Em seguida, o Visual Studio carrega e abre automaticamente a solução do repositório.

    Screenshot of a project in Git that's open in Solution Explorer in Visual Studio 2019 version 16.8 and later.

  5. Se o repositório contiver várias soluções, o Gerenciador de Soluções as exibirá. Para obter uma exibição de lista das soluções, selecione o botão Alternar Exibições no Gerenciador de Soluções.

    Screenshot of a project in Git that's open in Solution Explorer, with the Switch Views button highlighted in Visual Studio 2019 version 16.8 and later.

    O Gerenciador de Soluções oferece a opção de abrir a pasta raiz no Modo de Exibição de Pasta ou selecionar um arquivo de solução a ser aberto.

    Screenshot of the .sln file in Git that's open in Solution Explorer, after you've selected the Switch Views button in Visual Studio 2019 version 16.8 and later.

    Para alternar o modo de exibição, selecione o botão Alternar Modos de Exibição novamente.

    Dica

    Você também pode usar o menu Git no Visual Studio IDE para clonar um repositório e abrir um projeto.

    Screenshot of the Git menu in Visual Studio 2019 version 16.8 and later.

Abrir um projeto localmente de um repositório GitHub clonado anteriormente

  1. Abra o Visual Studio 2019 versão 16.8 ou posterior.

  2. Na janela de início, clique em Abrir um projeto ou uma solução.

    O Visual Studio abre uma instância do Explorador de Arquivos, em que você pode navegar até a solução ou projeto e selecioná-la para abrir.

    Screenshot of the 'Open a project or solution' window in Visual Studio 2019 version 16.8 and later.

    Se você abriu o projeto ou a solução recentemente, selecione-o na seção Abrir recente para abri-lo rapidamente novamente.

    Dica

    Você também pode usar o menu Git no Visual Studio IDE para abrir pastas e arquivos locais de um repositório clonado anteriormente.

    Screenshot of the Git menu in Visual Studio 2019 version 16.8 and later, with the Local Repositories option expanded.

    Iniciar codificação!

Visual Studio 2019 versão 16.7 e anteriores

Veja como usar o Git no Visual Studio 2019 versão 16.7 ou anterior.

Clonar um repositório GitHub e, em seguida, abrir um projeto

  1. Abra o Visual Studio 2019 versão 16.7 ou anterior.

  2. Na janela de início, selecione Clonar ou verificar código.

    Screenshot of the 'Create a new project' window in Visual Studio 2019 version 16.7 and earlier.

  3. Insira ou digite a localização do repositório e, em seguida, selecione Clonar.

    Screenshot of the 'Clone or checkout code' window in Visual Studio 2019 version 16.7 and earlier.

    O Visual Studio abre o projeto do repositório.

  4. Se houver um arquivo de solução disponível, ele é exibido no menu suspenso "Soluções e Pastas". Selecione-o, e o Visual Studio abrirá sua solução.

    Screenshot of the Solution Explorer drop-down list in Visual Studio 2019 version 16.7 and earlier.

    Se você não tiver um arquivo de solução (especificamente, um arquivo .sln) em seu repositório, o menu suspenso diz "Nenhuma solução encontrada". No entanto, você pode clicar duas vezes em qualquer arquivo no menu de pastas para abri-lo no editor de código do Visual Studio.

    Iniciar codificação!

Navegue até um repositório do Azure DevOps com o Visual Studio 2019

O que você vê quando navega e clona um repositório do Azure DevOps usando o Visual Studio 2019 depende de qual versão você tem. Especificamente, se você instalou a versão 16.8 ou posterior, alteramos a interface do usuário para acomodar uma nova experiência do Git mais totalmente integrada no Visual Studio.

Mas não importa qual versão você instalou, você sempre pode procurar e clonar um repositório do Azure DevOps com o Visual Studio.

Visual Studio 2019 versão 16.8 e posterior

  1. Visual Studio 2019 versão 16.8 ou posterior.

  2. Na janela inicial, selecione Clonar um repositório.

    Screenshot of the Clone a Repository dialog in Visual Studio 2019 version 16.8 and later, for Azure DevOps.

  3. Na seção Navegar em um repositório, selecione Azure DevOps.

    Screenshot of the 'Browse a repository' section of the The 'Connect to a Project' dialog box in Visual Studio 2019 version 16.8 and and later.

  4. Se você vir uma janela de entrada, entre em sua conta.

  5. Na caixa de diálogo Conectar-se a um Projeto, escolha o repositório a que você deseja se conectar e selecione Clonar.

    Screenshot of the 'Connect to a Project' dialog box that's generated from Visual Studio 2019 version 16.8 and later.

    Dica

    Se você não vir uma lista pré-preenchida de repositórios aos quais se conectar, selecione Adicionar Azure DevOps Server para inserir uma URL do servidor. (Como alternativa, você pode ver um prompt "Nenhum servidor encontrado" que inclui links para adicionar um Azure DevOps Server existente ou criar uma conta do Azure DevOps.)

    Em seguida, o Visual Studio abre o Gerenciador de Soluções que mostra as pastas e os arquivos.

  6. Selecione a guia Team Explorer para exibir as ações do Azure DevOps.

    Screenshot of the 'Team Explorer' dialog box that's generated from Visual Studio 2019 version 16.8 and later.

Visual Studio 2019 versão 16.7 e anteriores

  1. Abra o Visual Studio 2019 versão 16.7 ou anterior.

  2. Na janela de início, selecione Clonar ou verificar código.

    Screenshot of the 'Create a new project' window in Visual Studio 2019 version 16.7 and earlier.

  3. Na seção Navegar em um repositório, selecione Azure DevOps.

    Screenshot of the 'Clone or check out code' window with the 'Browse a repository' section that lists Azure DevOps in Visual Studio 2019 version 16.7 and earlier.

    Se você vir uma janela de entrada, entre em sua conta.

  4. Na caixa de diálogo Conectar-se a um Projeto, escolha o repositório a que você deseja se conectar e selecione Clonar.

    Screenshot of the 'Connect to a Project' dialog box that's generated from Visual Studio 2019 version 16.7 and earlier.

    Observação

    O que é exibido na caixa de listagem depende dos repositórios Azure DevOps a que você tem acesso.

    O Visual Studio abrirá o Team Explorer e uma notificação será exibida quando a clonagem for concluída.

    Screenshot of the Team Explorer window in Visual Studio 2019 version 16.7 and earlier, after clone is complete.

  5. Para exibir pastas e arquivos, selecione o link Mostrar Exibição de Pasta.

    Screenshot of the Solutions section of the Team Explorer window in Visual Studio 2019 version 16.7 and earlier, after clone is complete.

    O Visual Studio abre o Gerenciador de Soluções.

  6. Escolha o link Soluções e Pastas para procurar um arquivo de solução (especificamente, um arquivo .sln) para abrir.

    Screenshot of the 'Solutions and Folders' notification from Team Explorer in Visual Studio 2019 version 16.7 and earlier.

    Se você não tiver um arquivo de solução no seu repositório, a mensagem 'Nenhuma Solução Encontrada' aparecerá. No entanto, você pode clicar duas vezes em qualquer arquivo no menu de pastas para abri-lo no editor de códigos do Visual Studio.

Próximas etapas

Fique à vontade para se aprofundar em qualquer um dos seguintes tutoriais específicos da linguagem:

Confira também