Compartilhar via

Criar uma solicitação de pull no Visual Studio

  • Artigo

Se você for autenticado no GitHub ou no Azure DevOps e tiver enviado alterações por push para o repositório remoto, poderá criar uma solicitação de pull sem sair do Visual Studio. As solicitações pull são uma ferramenta essencial no GitHub e no Azure DevOps para revisão de código. Essas revisões ajudam a capturar problemas nos novos recursos e permitem que os colegas compartilhem sua experiência com diferentes regiões da base de código - melhorando a integridade da base de código em geral.

Observação

Para experimentar o recurso, verifique se ele está habilitado em Ferramentas>Opções>Visualizar Recursos>Solicitação de Pull

Para criar uma solicitação de pull, siga estas etapas:

  1. Antes de criar uma solicitação de pull, você precisa criar uma nova ramificação para suas alterações. Essa ramificação mantém suas modificações separadas da ramificação principal até que estejam prontas para serem mescladas.

  2. Em seguida, você pode confirmar e enviar por push suas alterações como faria normalmente na janela Alterações do Git.

  3. Selecione o link na faixa de notificação para Criar no Visual Studio ou Criar no navegador.

    Captura de tela da janela Alterações do Git com a barra de informações “QP enviado com êxito para a origem. Pull request: Criar no Visual Studio ou criar no navegador.” no Visual Studio 2022.

    Como alternativa, você pode criar uma solicitação de pull de uma ramificação remota navegando até a janela Nova Solicitação de Pull pelo menu de nível superior Git>GitHub ou Azure DevOps>Nova Solicitação de Pull. Ou clique com o botão direito do mouse em uma ramificação na Janela do Repositório Git.

    O menu de nível superior do Git com o GitHub selecionado e o texto 'Nova pull request' realçado no Visual Studio 2022.

    Ou selecione com o botão direito do mouse uma ramificação na Janela do Repositório Git para abrir o menu de contexto e selecione Nova Solicitação de Pull.

    A janela Repositório do Git com o texto do link de saída/entrada realçado no Visual Studio 2022.

  4. Selecione a ramificação na qual você quer mesclar e dê à sua solicitação de pull um título e uma descrição. Você pode usar a sintaxe de markdown para formatar sua descrição de solicitação pull do Visual Studio. Experimente digitando os símbolos de markdown na caixa Descrição e visualizar sua marcação selecionando o botão Visualizar.

    Dica

    Com o Visual Studio 2022 versão 17.10 preview 2 e posterior e as extensões do GitHub Copilot, você pode usar a IA para gerar uma descrição detalhada da pull request que descreve suas alterações. Pressione o ícone de caneta brilhante para solicitar que o GitHub Copilot gere uma descrição de pull request. Para instalar o GitHub Copilot, consulte Instalar e gerenciar o GitHub Copilot no Visual Studio.

    Captura de tela do ícone de caneta brilhante para solicitar que o GitHub Copilot gere uma descrição de pull request.

    A janela Nova pull request com o texto do botão de visualização realçado no Visual Studio 2022.

  5. A visualização da diferença permite que você veja todas as alterações nos arquivos que foram confirmadas como parte da sua solicitação de pull. Confira Comparar arquivos - exibição de comparação.

    Dica

    A opção de exibição de diferença de resumo permite que você revise apenas as seções alteradas do código.

    A janela Nova pull request com o texto do botão de resumo realçado no Visual Studio 2022.

  6. Você pode vincular itens de trabalho referenciando-os com a pesquisa de problemas, digitando # a descrição ou pressionando o botão # no canto inferior direito. Você também pode adicionar seus revisores digitando seu nome de usuário do GitHub ou a identidade ou email do Azure DevOps.

    Nova pull request com # na caixa de descrição e uma lista dos problemas relacionados do GitHub e solicitações pull mostradas no Visual Studio 2022.

  7. ’Depois de clicar em Criar na sua solicitação de pull, outros desenvolvedores poderão examinar suas alterações e fornecer comentários. Ou, com o Visual Studio 17.12 e posterior, clique na lista suspensa e escolha Criar como rascunho.

    Captura de tela mostrando a opção de criar uma nova solicitação de pull como rascunho.

Com o Visual Studio 17.12 e posterior, você pode habilitar o recurso Modelos de Solicitação de Pull (em Recursos de Visualização do Ambiente>de Opções>de Ferramentas>) para que seu modelo de PR padrão em seu repositório seja usado ao criar uma nova solicitação de pull para GitHub e Azure DevOps. Saiba mais sobre como adicionar um modelo de solicitação de pull ao repositório na documentação do GitHub e na documentação do Azure DevOps.

Exibir comentários de solicitação de pull no editor

A partir do Visual Studio 17.11, você pode exibir comentários e sugestões de revisores sem alternar contextos para o navegador.

Captura de tela mostrando comentários de relações públicas.

Para habilitar esse recurso, abra Opções de>Ferramentas>Recursos de pré-visualização e certifique-se de que Comentários de solicitação de pull esteja selecionado.

Para exibir os comentários de uma solicitação de pull, faça check-out de qualquer ramificação com uma ramificação de solicitação de pull ativa e selecione Mostrar comentários em arquivos na barra de informações. Você também pode selecionar o número de PR na janela Alterações do Git ou no menu de nível superior do Git com Git>GitHub ou Azure DevOps>Mostrar comentários em arquivos.

Captura de tela mostrando o link para visualizar comentários na janela Alterações do Git.

Você pode navegar entre arquivos e comentários individuais usando os ícones na barra de ferramentas ou usar os seguintes atalhos de teclado:

Ação Atalho de teclado
Vá para o arquivo anterior na solicitação de pull Ctrl+Shift+Alt+F6
Vá para o próximo arquivo na solicitação de pull Ctrl+Alt+F6
Vá para o comentário anterior Ctrl+Shift+Alt+F8
Vá para o próximo comentário Ctrl+Alt+F8

Próximas etapas

Para continuar seu percurso, visite a página Fetch, pull e sync no Visual Studio.

Confira também