Como gerenciar projetos com o GIR

GIT integration in Studio requires the Microsoft Visual C++ 2015 Redistributable Update 3 x86 version. Check the Software Requirements page.

Autenticação para o GIT

Os métodos de autenticação no Studio diferem de acordo com os métodos usados para clonar um repositório do GIT, seja ele o HTTPS ou o SSH. Verifique esta página para ver qual você deve usar se estiver trabalhando com o GitHub.

Observação:

• As credenciais do GIT que você fornecer no Studio ficam armazenadas no Gerenciador de Credenciais do Windows.
• Atualmente, a integração do GIT com o Studio é compatível com a autenticação de dois fatores. Como solução alternativa, utilize o método de autenticação do SSO com um token pessoal ou o método básico para autenticação de acesso.

O guia atual detalha os passos de autenticação para um repositório do GitHub, mas a integração do GIT no Studio não fica limitada somente a este serviço.

No HTTPS

Ao clonar um repositório remoto do GIT ou copiar o projeto atual para um repositório existente do GIT usando o HTTPS pela primeira vez, é necessário fornecer suas credenciais do GIT. Essas credenciais devem ser inseridas nos campos Usar Credenciais:

Você pode autenticar usando:

• O nome de usuário e a senha em seus campos específicos;
• O nome de usuário no campo Usuário, e o token do GIT no campo Token;

Follow the steps detailed in this page to generate a GIT token for your GitHub repository.

Sobre o SSH

Ao clonar um repositório ou copiar o projeto atual para um repositório do GIT existente usando o SSH pela primeira vez, você tem a opção de usar uma chave privada:

Adicione o Caminho da Chave Privada e a Senha e clique em Abrir para clonar seu repositório remoto do GIT. Para gerar uma chave SSH para seu repositório do GITHub, verifique as etapas detalhadas aqui.

Falha na autenticação

No HTTPS

Se a senha ou o nome do usuário tiverem sido digitados incorretamente durante a clonagem de um repositório do GIT usando o método HTTPS, a janela Inserir Credenciais será exibida com a mensagem Falha na autenticação:

Insira as credenciais corretas de Usuário e Senha e tente novamente. Você também pode usar o Git Bash, por exemplo, para clonar seu repositório remotamente e, assim, verificar se o nome do usuário e a senha estão corretos.

Na imagem a seguir, tentamos clonar um repositório no HTTPS, mas inserimos uma senha incorreta. A janela Git Bash mostra que as credenciais estavam incorretas.

Sobre o SSH

A janela Inserir Credenciais a seguir é exibida quando a autenticação em SSH falhar:

Digite o Caminho da Chave Privada e a Senha corretos e tente novamente. Você também pode usar o Git Bash, por exemplo, para clonar seu repositório remotamente e, assim, verificar se o token e/ou a senha estão corretos.

Na imagem a seguir, tentamos clonar um repositório com SSH, mas não tínhamos nenhuma chave SSH pública configurada em nossa conta.

Clonar um repositório remoto de GIT

1. Na guia Equipe, selecione Clonar Repositório. A opção Clonar um repositório remoto do GIT remoto. será exibida.
2. Escolha em Clonar com o HTTPS ou Use o SSH.
3. Digite a URL do Repositório e escolha um Diretório de Check out vazio.
4. Clique na caixa de seleção Usar Credenciais ou Usar Chave para adicionar seu nome de usuário do GIT ou o Caminho da Chave Privada e a senha.
5. Clique em Abrir e o Studio abre o projeto no painel Designer.
6. Na janela Abrir, selecione um arquivo project.json para abrir no Studio.

Depois de clonar um repositório do GIT para um diretório local de trabalho, o subdiretório .git é criado contendo os metadados do GIT necessários. Os metadados incluem subdiretórios para os arquivos de objetos, referências e modelos. Além disso, um arquivo HEAD também é criado, o qual aponta para a confirmação dos verificados no momento.

Adicionar um Projeto ao GIT

O recurso GIT Init adiciona o projeto atual em um repositório GIT local. Acesse o comando na guia Equipe ou a barra de status.

1. Crie ou abra um projeto no Studio. Clique na guia Iniciar > Equipe. A aba Equipe será mostrada.

2. Clique no botão GIT Init e, depois, selecione o caminho onde o repositório deve ser inicializado. O local pode ser o mesmo do projeto ou a pasta parent. A janela Confirmar alterações se abrirá.

   

3. A seção Arquivos Modificados exibe os arquivos do projeto que devem ser adicionados ao repositório do GIT. Desmarque a caixa ao lado dos arquivos que não deseja adicionar ou use as opções Selecionar Todos, Selecionar Nenhum.

4. Selecione a caixa Mostrar Arquivos Não Versionados para adicionar arquivos não versionados à lista.

   Grave em Confirmar Mensagem. Clique no botão Confirmar para confirmar as alterações ao repositório local do GIT.

When a project is added to GIT, the context menu in the Project panel includes GIT-specific options. For more information, see Context Menu Options for GIT.

Confirmação e Envio por push para o GIT

1. Na mesma janela Confirmar alterações, clique no botão Confirmar e enviar para confirmar as alterações e enviá-las para o repositório remoto. A janela Gerenciar Remotos é exibida. A janela também fica disponível na barra de status.

   

2. Na seção Nome, adicione o nome do repositório remoto.

3. Na seção URL, adicione a URL remota.

Se quiser modificar nos repositórios adicionados, basta clicar em uma entrada, alterar o nome e URL e depois clicar no botão Atualizar. Quando estiver tudo pronto clique em Adicionar e depois em Salvar. A seguinte caixa de mensagem será aberta. Isso significa que o repositório local não está sincronizado com o remoto.

• Clique no botão Substituir conteúdo remoto para enviar por push as versões locais dos arquivos para o repositório remoto, substituindo os arquivos que estiverem ali.
• Clique no botão Efetuar Pull (trocar a base) para fazer o pul dos arquivos remotos e trocar a base da ramificação atual.
• Clique no botão Cancelar para descartar a operação inteira.

O número de alterações não enviadas por push e os arquivos recém-adicionados ficam visíveis na barra de status. Clique no ícone para abrir a janela Confirmar alterações ou o ícone para enviar alterações por push.

Observação:

Se você editar um arquivo de um projeto, adicionado para controle de origem em um editor externo, a alteração ficará fisível no painel Projeto e na barra de status somente depois de clicar em Atualizar, no painel Projeto.

Alterar a Última Confirmação

A integração do Studio com o Git também vem com uma opção para Corrigir Confirmação para alterar a última confirmação realizada, antes que o envio por push for realizado.

1. Clique com o botão direito do mouse em um arquivo modificado no painel Projeto e selecione a opção Confirmar. A janela Confirmar alterações será mostrada.

   

2. Selecione a caixa Corrigir Confirmação. A última mensagem de confirmação é exibida, junto com os arquivos que foram confirmados. Para visualizar as alterações entre o arquivo atual e a última confirmação, utilize a opção Mostrar Alterações.

3. Altere a mensagem de confirmação e selecione os arquivos que deseja incluir. Clique no botão Confirmar e Enviar por Push ou Confirmar.

Desfazer alterações pendentes

O Studio vem com a opção de desfazer alterações feitas aos arquivos versionados, antes de confirmá-las e enviá-las por push para o repositório remoto.

Após fazer as alterações a um arquivo no repositório local, clique em Desfazer no menu de contexto do GIT para abrir a janela Desfazer Alterações Pendentes.

Selecione a caixa de seleção ao lado dos arquivos e clique em Desfazer. Os arquivos agorão são revertidos para o estado de antes das alterações.

Observação:

A função Desfazer não abrange os arquivos não versionados. Se você criar novos arquivos e depois selecionar Desfazer, os arquivos não serão removidos do projeto. Uma vez adicionados à árvore do projeto, os novos arquivos permanecerão ali, a menos que forem excluídos manualmente.

Copiar um Projeto para o GIT

O botão Copiar para o GIT na exibição de Backstage do Studio e a barra de status permite copiar o projeto atual para um repositório GIT existente.

Para tanto, primeiro abra ou crie um projeto no Studio. Na guia Equipe, selecione Copiar para o GIT e escolha uma pasta de repositório do GIT existente em sua máquina. O projeto é adicionado ao repositório local do GIT e a caixa de mensagem Copiar para o GIT será aberta.

• Selecione Sim para abrir o projeto no novo local. A janela Confirmar Alterações se abrirá. Grave uma Mensagem de Confirmação e clique em Confirmar e Enviar por Push ou apenas Confirmar.
• Selecione Não para retornar para a interface de usuário do Studio.

Criar e Gerenciar Ramificações

1. In the Project panel, right-click the project node or contained file, or the icon in the status bar and select Manage Branches. The Manage Branches window is displayed.

   

2. Add a branch by clicking on the button. Write a name for the branch in the Name section. Click Add and then Save. The branch is added to the list.

Clique com o botão direito em qualquer ramificação para exibir as opções das ramificações do GIT:

• A opção Fazer check-out de ramificação alterna para a ramificação selecionada.
• A opção Trocar base troca a base da ramificação atual para a ramificação selecionada.
• A opção Mesclar mescla a ramificação selecionada na ramificação atual.

Para fundir uma ramificação na master de um repositório remoto do GIT, você precisa que a ramificação master passe pelo check-out no Studio, para então fundir a ramificação modificada na mestre.

To switch between branches, click the icon in the status bar to open the list with all the recently checked out branches. Click an item to switch the branch.

Solução de conflitos

A integração do GIT com o Studio vem com um recurso para resolver conflitos que podem ocorrer ao se executar os comandos Trocar Base ou Enviar por Push, encontrados na janela Confirmar Alterações.

Sempre que o Studio detectar um conflito entre o arquivo local e um arquivo encontrado no repositório remoto, a janela Resolver conflitos será exibida.

The window is similar to File Diff, showing the differences between the Remote version of the file and the Local version.

A tabela a seguir descreve as opções disponíveis na janela Solucionar conflitos.

Opção	Description
Escolher à Esquerda	Selecione o arquivo à esquerda, que representa o arquivo no repositório remoto para enviar por push.
Escolher à Direita	Selecione o arquivo à direita, que representa o arquivo no repositório local para enviar por push.
Salvar	Depois de escolher o arquivo à esquerda ou à direita, clique em Salvar.
Cancelar	Cancele a operação e saia da janela Solucionar conflitos.
Anterior	Segue para a alteração anterior nos arquivos comparados.
Avançar	Segue para a próxima alteração nos arquivos comparados.
Recolher Tudo	Fecha todos os nós nos arquivos .xaml.
Expandir Tudo	Expande todos os nós nos arquivos .xaml.

Desconectar-se do GIT

A opção Desconectar em Exibição Backstage do Studio > na guia Equipe fica disponível em relação aos arquivos versionados nos dois casos a seguir:

1. Um processo é inicializado como um repositório local do GIT. Crie um novo processo, use o GIT Init para adicioná-lo a um repositório local do GIT e, em seguida, use a opção Desconectar para remover an tag da subversão.
2. É possível remover a tag da subversão, clicando em Desconectar em relação ao repositório do GIT, o que inclui projetos parent e child.
3. Se você desconectar um projeto child, então o repositório GIT inteiro contendo o projeto aberto será desconectado do controle de origem. Será exibida uma caixa de mensagem no Studio, solicitando sua confirmação antes que a ação de desconectar seja executada.

Alteração de assinatura

É possível alterar a assinatura de confirmação do GIT a partir da guia Equipe > Alterar Assinatura. Preencha seu nome e endereço de e-mail e clique em OK.

Uso do GIT com um Servidor Proxy

A integração do GIT no Studio oferece suporte ao acesso de repositórios remotos se o acesso à Internet for realizado através de um servidor proxy. Isso pode ser feito de duas maneiras: seja configurado em nível da máquina na janela de Configurações de Proxy ou fazendo alterações aos comandos git.

Os detalhes do Proxy, configurados na janela Configurações de Proxy são considerados, sem a necessidade de inseri-los no arquivo .gitconfig.

Para configurar os detalhes do proxy com os comandos git, adicione-os aos arquivos de configuração do GIT no formulário a seguir:

[http "https://domain.com"] proxy = http://proxyUsername:[e-mail]:port

Os arquivos de configuração do GIT podem ser encontrados nos seguintes locais:

• config arquivo: %ProgramData%\Git
• .gitconfig arquivo: %UserProfile%
• arquivo config local do nível do projeto, como por exemplo, o %UserProfile%\Desktop estproject\.git.