Utilizando o GitHub no Visual Studio 2015
O objetivo deste artigo é descrever a hospedagem de projetos no GitHub por meio do Visual Studio 2015, partindo para isto de um exemplo prático que apresenta em maiores detalhes o funcionamento desta integração.
Introdução
O GitHub é hoje uma das principais opções para o gerenciamento de código em projetos open source. Tamanha popularidade e potencial não passaram em branco diante dos gigantes da área de software, com a Microsoft adotando esta solução para a hospedagem de componentes importantes da plataforma .NET. O Entity Framework 7, o ASP.NET 5 (vNext), o .NET Core 5 e o .NET Compiler Plataform (Roslyn) são alguns dos projetos cujo código-fonte encontra-se atualmente no GitHub.
Um exemplo de ferramenta útil na manipulação de projetos hospedados neste serviço Web é o GitHub for Windows. Este aplicativo pode ser usado de forma gratuita, tendo sido concebido com o intuito de simplificar a interação com os serviços oferecidos pelo GitHub. Independentemente disto, muitos desenvolvedores preferem alternativas para controlar seus códigos-fontes a partir das próprias IDEs em que os mesmos trabalham. Atenta a tais fatos, a Microsoft disponibilizou meios para que os releases mais recentes do Visual Studio (incluindo a versão 2015) suportem o uso do GitHub.
Nas próximas seções será detalhado de que forma o GitHub pode ser utilizado a partir do Visual Studio 2015. A ideia com isto é demonstrar como funciona a hospedagem de um projeto na Web através da IDE, através de um exemplo prático em que são descritos os passos necessários para a realização deste tipo de procedimento.
Habilitando o uso do GitHub no Visual Studio 2015
Assim como acontece em versões anteriores, a integração entre o Visual Studio 2015 e o GitHub é feita por meio de uma extensão a ser instalada na própria IDE. A fim de habilitar o uso deste complemento acessar a opção o menu Tools e, em seguida, a opção "Extensions and Updates...":
Selecionar e baixar então a extensão "GitHub Extension for Visual Studio":
Exemplo de utilização do GitHub
Para demonstrar o uso do GitHub a partir do Visual Studio será criado um novo projeto chamado “TesteVS2015GitHub”, a partir da seleção do template “Class Library”:
Fará parte do projeto TesteVS2015GitHub a classe ConversorTemperatura, sendo possível observar na próxima listagem a versão inicial deste tipo:
namespace TesteVS2015GitHub
{
public static class ConversorTemperatura
{
public static double FahrenheitParaCelsius(double temperatura)
{
return 0;
}
public static double FahrenheitParaKelvin(double temperatura)
{
return 0;
}
}
}
O próximo passo será configurar o projeto TesteVS2015GitHub, a fim de que as estruturas que compõem o mesmo possam ser gerenciadas por um controlador de versões (o GitHub, no caso específico deste artigo). Acionar para isto o menu “File” e, em seguida, a opção “Add to Source Control”:
Selecionar na janela “Choose Source Control” a opção “Git”:
Neste momento aparecerá em “Team Explorer” uma relação com todos os arquivos que estarão sujeitos ao versionamento:
Será necessário preencher um comentário descrevendo esta ação e, na sequência, selecionar a opção “Commit and Sync”:
Em “Synchronization” acionar a opção "Publish to GitHub":
Na janela “Connect to GitHub” informar uma credencial cadastrada para utilização deste serviço (e que foi previamente criada a partir do site do GitHub):
Voltando à seção “Synchronization” da janela “Team Explorer”, preencher então o nome do repositório a ser criado no GitHub (normalmente é assumido como default a própria identificação do projeto), além de um comentário que descreva tal ação:
Acionando o botão “Publish” será exibida uma mensagem indicando que o repositório foi publicado com sucesso:
Observando a estrutura do projeto TesteVS2015GitHub na janela “Solution Explorer” nota-se a imagem de um “cadeado” ao lado de cada arquivo. Tal representação indica que cada um destes elementos já se encontra versionado, com itens correspondentes no repositório gerado no GitHub.
Na próxima imagem encontra-se a visualização do repositório TesteVS2015GitHub através do site do GitHub:
É possível inclusive a visualização do conteúdo de um arquivo pertencente ao repositório TesteVS2015GitHub:
A listagem a seguir apresenta uma versão ajustada da classe ConversorTemperatura, já contemplando os cálculos esperados para os métodos FahrenheitParaCelsius e FahrenheitParaKelvin:
using System;
namespace ExemploVS2015GitHub
{
public static class ConversorTemperatura
{
public static double FahrenheitParaCelsius(double temperatura)
{
return Math.Round((temperatura - 32) / 1.8, 2);
}
public static double FahrenheitParaKelvin(double temperatura)
{
return Math.Round(((temperatura - 32) / 1.8) + 273.15, 2);
}
}
}
Voltando à janela “Solution Explorer”, nota-se que o arquivo ConversorTemperatura.cs possui alterações que não foram sincronizadas com o repositório no GitHub (como destacado em “vermelho” na próxima imagem):
A fim de confirmar as alterações clicar com o botão direito sobre o arquivo ConversorTemperatura.cs, selecionando no menu de contexto a opção “Commit...”:
Na janela “Team Explorer” preencher um comentário detalhando as alterações, acionando depois a opção “Commit and Sync”:
Por fim, uma mensagem será exibida indicando que o processo de sincronização teve sucesso:
No repositório TesteVS2015GitHub do GitHub já aparecerão as últimas modificações realizadas no arquivo ConversorTemperatura.cs:
Conclusão
Este artigo procurou demonstrar, por meio de um exemplo prático, o suporte oferecido pelo Visual Studio para a utilização de projetos que dependam do GitHub. Através da extensão apresentada desenvolvedores podem ter seu trabalho facilitado de maneira bastante significativa, de forma que a manipulação de repositórios com projetos em .NET aconteça sem grandes esforços.
Referências
GitHub - Site official
https://github.com/
GitHub Extension for Visual Studio 2015
https://visualstudiogallery.msdn.microsoft.com/75be44fb-0794-4391-8865-c3279527e97d