Azure DevOps Plug-in para IntelliJ IDEA e Android Studio

Azure DevOps Services | Azure DevOps Server 2020 | Azure DevOps Server | 2019 TFS 2018

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

Neste guia, mostramos como criar um repositório Git usando o portal da Web Azure DevOps Services, adicionar um código de exemplo e clonar o repositório e criar solicitações de pull de dentro do IntelliJ IDEA.

Pré-requisitos

Para concluir as etapas neste guia, você precisa:

  • Uma organização em Azure DevOps. Se você não tiver uma organização, poderá se inscrever para uma gratuitamente. Cada organização inclui repositórios Git privados gratuitos e ilimitados.
  • IntelliJ IDEA instalado em seu computador. Se você não tiver, obtenha IntelliJ IDEA.
  • O plug-in Azure DevOps para IntelliJ. Consulte a página de download do Plug-in do IntelliJ para obter instruções de instalação. Esse plug-in é compatível com as edições IntelliJ IDEA Ultimate e Community, Android Studio, RubyMine, WebStorm, PhpStorm, PyCharm, AppCode, MPS, 0xDBE e CLion.
  • Ferramentas de linha de comando git.

Criar um repositório

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

    Select project

    Observação

    Com 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 a Azure DevOps, alterne as organizações existentes para usar a nova URL de nome de domínio.

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

    Choose new repository from the web portal

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

    Set options for your new repo in the Create a Git repo dialog

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.

    Retrieve the clone URL

  2. Abra a janela de comando git (Git Bash no Git para Windows), navegue até a pasta onde você deseja que o código do repositório armazenado em seu computador e execute git clone seguido pelo caminho copiado da URL de 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, pois você a usará para as 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 serão substituídos por feeds de linha de retorno de carro (ou seja, aviso: LF será substituído por CRLF). Esses avisos podem ser ignorados.

  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 até o repositório Azure Repos DeepSpace.

    git push
    
  8. Volte para o portal da Web Azure DevOps Services e atualize e você pode ver os arquivos que foram adicionados.

    DeepSpace files

Clonar seu repositório no IntelliJ

Agora que temos um repositório Git com um código de exemplo, vamos dar uma olhada em como podemos trabalhar com o código do IntelliJ IDEA. Clonar seu repositório VSTS no IntelliJ é extremamente simples. Você nem precisa saber a URL do repositório.

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

    Clone repo

  2. Em seguida, basta entrar no Azure DevOps Services...

    Azure DevOps Services Sign-in

  3. Ao clicar em Entrar, você receberá a interface do usuário de entrada padrão Azure DevOps Services. Depois de entrar, você deverá ver a lista de todos os repositórios aos quais você tem acesso no Azure DevOps Services. Escolha o repositório correto, o DeepSpace, e clique no botão Clonar . (Talvez você também queira escolher onde, em seu disco rígido, o repositório é clonado alterando o Diretório Pai.)

    Screenshot that shows cloning a repo.

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

    DeepSpace project

Fazer algumas alterações no IntelliJ

  1. Comece certificando-se de que o projeto é compilado usando o projeto Build>Make. Se for solicitado que você adicione um SDK para o projeto, basta adicionar o JDK java mais recente instalado em seu computador.

    Se você quiser executar o projeto agora para ver o que ele faz, você pode fazer o seguinte:

    1. Na pasta raiz do DeepSpace no repositório git, execute o comando mvn jetty:run (isso requer que o maven seja instalado)
    2. Em um navegador, vá para http://localhost:3030/

    Você deve ver estrelas e planetas voando! Se você olhar de perto, você pode notar que a Terra não voa.

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

    Earth commented out

    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 confirmar-se com esse branch. Crie uma ramificação por meio do IntelliJ usando a janela interna do VCS>Git>Branches . Quando solicitado, use o nome do branch fixBugs. Depois que tivermos um branch para fazer nossas alterações, podemos cancelar a comunicação do código e recompilar o projeto. Se você seguir as instruções acima 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 menuAlterações de Confirmação do VCS>. Na caixa de diálogo de confirmação, você verá um botão VSTS acima da caixa de texto da mensagem de confirmação. Clique nesse botão para exibir sua lista de itens de trabalho atribuídos a você. Selecione o item Adicionar Trabalho terra ausente e clique em OK. Você verá a caixa de texto da mensagem de confirmação ser preenchida com o tipo, o número e o título do item de trabalho. Isso associará o item de trabalho a essa confirmação para rastreabilidade no futuro.

    Commit Earth

    Observe que essa alteração só é feita localmente; ainda não foi alterado em nosso repositório Azure DevOps Services.

Criar uma solicitação de pull

Você pode enviar por push sua ramificação local 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. Isso salva várias etapas e elimina a necessidade de você alternar para o navegador para criar a solicitação de pull.

Para fazer isso, basta selecionar aSolicitação de Pull de Criação de Git doVCS>>. Isso 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 que serão enviadas por push. Você pode fornecer à solicitação de pull um título e uma descrição.

Create pull request

Depois de clicar em 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 revisores ou comentários 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, verifique 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 seu 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 podem ter expirado.

Build status icons

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

Build status menu

Exibir solicitações pull e itens de trabalho

No menu Controle de Versão , existe uma guia Solicitação de Pull e Itens de Trabalho para permitir que você exiba facilmente 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.

Pull request menu

Na guia Itens de Trabalho , você pode exibir os itens de trabalho com base em consultas que você criou 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.

Work items menu

Próximas etapas