Usar o plug-in do Azure DevOps para IntelliJ IDEA e Android Studio

Azure DevOps Services | Azure DevOps Server | Azure DevOps Server 2022

IntelliJ IDEA é um IDE produzido pela JetBrains. Você pode saber mais sobre isso em https://www.jetbrains.com/idea/. O Plug-in do Azure DevOps para IntelliJ permite que você se conecte aos repositórios Git ao Azure DevOps de maneira direta e intuitiva. Você também pode usar esse plug-in para importar projetos para o Azure Repos ou criar solicitações pull no repositório Git do Azure DevOps.

Pré-requisitos

Criar um repositório

1. Navegue até seu projeto no Azure DevOps navegando https://dev.azure.com/{your organization} até e selecionando o nome do seu projeto. Você pode selecioná-lo na lista Todos os projetos ou na lista Projetos Recentes se tiver acessado recentemente.

   

   Observação

   Com o Azure DevOps Services, o formato da URL do projeto é dev.azure.com/{your organization}/{your project}. No entanto, ainda há suporte para o formato anterior que faz referência ao visualstudio.com formato. Para obter mais informações, consulte Introdução ao Azure DevOps, Alterne as organizações existentes para usar a nova URL de nome de domínio.

2. Na área Projeto no portal da Web, selecione Código e, em seguida, selecione a lista suspensa ao lado do nome do repositório atual e escolha Novo Repositório.

   

3. Na caixa de diálogo Criar um novo repositório , verifique se o Git é o tipo de repositório, insira DeepSpace para seu novo nome de repositório e selecione Criar.

   

Adicionar código de exemplo ao repositório

1. Selecione Clonar no canto superior direito da janela Código e copie a URL do Clone.

   

2. Abra a janela de comando do Git (Git Bash no Git para Windows), navegue até a pasta em que você deseja que o código do repositório seja armazenado em seu computador e execute git clone seguido pelo caminho copiado da URL do Clone na etapa anterior, conforme mostrado no exemplo a seguir.

   git clone https://dev.azure.com/contoso-ltd/MyFirstProject/_git/DeepSpace
   

3. Alterne para a pasta DeepSpace executando o comando a seguir.

   cd DeepSpace
   

   Mantenha essa janela aberta para uso nas etapas subsequentes.

4. Baixe o código de exemplo do DeepSpace e extraia-o para o diretório local no computador em que você clonou o repositório do DeepSpace.

5. Volte para a janela de comando do Git e execute o comando a seguir, que confirma os arquivos de código de exemplo para o repositório local.

   git add --all
   

   Você pode ver alguns avisos informando que os feeds de linha são substituídos por feeds de linha de retorno de carro. Você pode ignorar esses avisos.

6. Confirme os arquivos no repositório local executando o comando a seguir.

   git commit -m "Committing DeepSpace sample files"
   

7. Execute o comando a seguir para enviar por push a confirmação de arquivos de exemplo do DeepSpace para o repositório deepspace do Azure Repos.

   git push
   

8. Volte para o portal da Web do Azure DevOps e atualize. Os arquivos foram adicionados.

   

Clonar seu repositório no IntelliJ

Agora que temos um repositório Git com algum código de exemplo, vamos examinar como podemos trabalhar com o código do IntelliJ IDEA. Você nem precisa saber a URL do repositório para cloná-la.

1. Abra o IntelliJ IDEA e selecione Fazer check-out no Controle de Versão e escolha o Git do VSTS.

   

2. Entre no Azure DevOps.

   

3. Ao selecionar Entrar, você receberá a interface do usuário de entrada padrão do Azure DevOps. Depois de entrar, você deverá ver a lista de todos os repositórios aos quais você tem acesso no Azure DevOps. Escolha o repositório correto, o DeepSpace e selecione o botão Clonar . Altere também o diretório pai, em que o repositório é clonado no disco rígido.

   

4. Após a conclusão do clone, o IntelliJ perguntará se você deseja abrir o projeto. Selecione Sim e você deve acabar com o projeto deepspace aberto no IntelliJ IDEA.

   

Fazer algumas alterações no IntelliJ

1. Verifique se o projeto é compilado usando o projeto Build>Make. Se for solicitado que você adicione um SDK para o projeto, adicione o JDK Java mais recente instalado em seu computador.

   Para executar o projeto agora para ver o que ele faz, execute as seguintes etapas:

   1. Na pasta raiz do DeepSpace no repositório git, execute o comando mvn jetty:run, que requer a instalação do Maven.
   2. De um navegador, vá para http://localhost:3030/.

   Estrelas e planetas devem estar voando! Se você olhar de perto, você pode notar que a Terra não voa.

2. Em nosso exemplo de DeepSpace , há algumas seções de código que são comentadas. Se você abrir o src/main/java/com.microsoft.tfs.demo/ImageService.java arquivo no IntelliJ, poderá ver uma das seções.

   

   Vamos corrigir esta seção do código localmente. Normalmente, ao trabalhar em um repositório Git, você deve criar um branch para seu trabalho e se comprometer com esse branch. Crie uma ramificação por meio do IntelliJ usando a janela interna deBranches> do >. Quando solicitado, use o nome do branch fixBugs. Depois que tivermos um branch para fazer nossas alterações, poderemos cancelar o comentário do código e recompilar o projeto. Se você seguir as instruções anteriores para executar o programa novamente, verá a Terra passar.

3. Agora que nossas alterações foram criadas e testadas, podemos confirmá-las localmente usando o menuConfirmar Alterações do >. Na caixa de diálogo de confirmação, você verá um botão VSTS acima da caixa de texto da mensagem de confirmação. Selecione nesse botão para exibir sua lista de itens de trabalho atribuídos a você. Selecione o item de trabalho Adicionar Terra Ausente e selecione OK. Uma mensagem de confirmação exibe a caixa de texto preenchida com o tipo, número e título do item de trabalho, que associa o item de trabalho a essa confirmação para rastreabilidade no futuro.

   

   Essa alteração só é feita localmente; ele ainda não foi alterado em nosso repositório do Azure DevOps.

Criar uma solicitação de pull

Você pode enviar seu branch local por push para o servidor e criar uma solicitação de pull para que sua equipe examine. Nosso plug-in ajuda você a criar a solicitação de pull com base no contexto atual no IntelliJ. Essa ação salva várias etapas e elimina a necessidade de alternar para o navegador para criar a solicitação de pull.

Selecione Vcs>Git>Create Pull Request. Essa ação abre a caixa de diálogo Criar Solicitação de Pull . Essa caixa de diálogo fornece muitas informações, incluindo os arquivos que foram alterados e as confirmações a serem enviadas por push. Você pode dar à solicitação de pull um título e uma descrição.

Depois de selecionar Criar Solicitação de Pull, você deverá receber uma notificação de que a solicitação de pull foi criada. Ele também contém um link para a solicitação de pull caso você queira adicionar comentários ou revisores específicos. Depois que as revisões de código forem concluídas, você poderá mesclar a solicitação de pull no branch principal.

Verificar o status do build

Depois de mesclar as alterações no branch principal, você pode verificar se o build de CI foi bem-sucedido no IntelliJ. No canto inferior direito, há um ícone que exibe seu status de build para você. Se você vir uma marca de seleção verde, isso significa que o build foi bem-sucedido. Se você vir um X vermelho, o build falhou. Se você vir um ponto de interrogação cinza, seu build não foi encontrado ou suas credenciais poderão ter expirado.

Você pode selecionar no ícone para obter mais opções, como exibir detalhes do build, enfileirar um novo build e atualizar o status manualmente.

Exibir solicitações de pull e itens de trabalho

No menu Controle de Versão, as guias Solicitação de Pull e Itens de Trabalho permitem exibir as informações necessárias sem sair do IDE. A guia Solicitação de Pull mostra as solicitações de pull atuais criadas por você e atribuídas a você juntamente com seu status. A guia também oferece a capacidade de criar e/ou abandonar solicitações de pull.

Na guia Itens de Trabalho , você pode exibir os itens de trabalho com base em consultas criadas ou usar a consulta padrão para ver os itens de trabalho atribuídos a você. Você também pode criar uma ramificação baseada em um item de trabalho para que possa associar um item de trabalho ao branch para fins futuros de rastreabilidade.

Próximas etapas

Artigos relacionados

• Exibir as perguntas frequentes sobre o plug-in do IntelliJ