Migrar para o Cloud Tools for IntelliJ

Neste documento, descrevemos como migrar seu projeto do App Engine com base em IntelliJ para Cloud Tools for IntelliJ.

Antes de começar

  • Caso seu projeto seja baseado em Maven ou Gradle e você use os plug-ins anteriores baseados no SDK do App Engine, como com.google.appengine.appengine-maven-plugin e com.google.appengine:gradle-appengine-plugin, faça primeiro a migração dos novos plug-ins do Maven e do Gradle baseados no SDK do Cloud.

  • O novo plug-in não é compatível com as melhorias do Datanucleus. Para usar esse recurso, será preciso configurar manualmente as melhorias do Datanucleus (JDO e JPA) se quiser migrar seu projeto para o Cloud Tools for IntelliJ. Use o Objectify como camada ORM para fazer leituras/gravações no Cloud Datastore.

Instalar o novo plug-in

Para instalar o plug-in, proceda da seguinte maneira:

  1. From inside IDEA, open File > Settings. Or, on Mac OS X, open IntelliJ IDEA > Preferences.
  2. Select Plugins from the navigation pane and search for Cloud Code.
  3. Click Install.
  4. Choose to Restart your IDE.
  5. Configure the project JDK:
    1. Open File > Project Structure. Or on Mac OS X open IntelliJ IDEA > Project Structure.
    2. Choose Project Settings > Project.
    3. If the Project JDK is missing, click New... and choose a JDK.

Configurar o IntelliJ e o projeto

Depois de instalar o plug-in, configure o IntelliJ e o projeto para usar o novo plug-in da seguinte maneira:

  1. Quando notificado de que o novo plug-in está em conflito com a integração atual do App Engine, aceite o prompt para desativar o plug-in antigo.

    Captura de tela mostrando a notificação de que o plug-in está em conflito e o prompt para desativá-lo.

  2. Reinicie o IntelliJ.

  3. Quando notificado de que o projeto está em um formato antigo, clique na opção para converter seu projeto no novo formato.

    Captura de tela mostrando a notificação de que o projeto está no formato antigo e o prompt para convertê-lo.

  4. Exclua as instâncias atuais do App Engine Server e Cloud e as recrie usando o novo SDK do Cloud.

    1. Navegue até Configurações -> Criação, execução, implantação -> Servidores de aplicativos.

    2. Selecione suas instâncias do App Engine Dev e clique em Excluir (-).

    3. Clique em Adicionar (+) e selecione Google App Engine Dev Server.

      Captura de tela mostrando a lista de servidores de aplicativos e o ícone para excluí-los e adicioná-los.

    4. Navegue até Configurações -> Criação, execução, implantação -> Nuvens.

    5. Selecione as instâncias da nuvem do Google App Engine e clique em Excluir (-).

    6. Clique em Adicionar (+) para configurar um destino de implantação da nuvem do App Engine.

      Captura de tela mostrando a lista de instâncias da nuvem e os ícones para excluí-las e adicioná-las.

  5. Se você tiver configurações de execução do servidor local do App Engine, atualize-as para usar o servidor de aplicativos recém-configurado.

  6. Navegue até Ferramentas -> Google Cloud Tools para consultar a lista de ações disponíveis para executar e implantar seu aplicativo ou consulte a documentação para mais informações.

  7. Para projetos com base em Maven ou Gradle, verifique se você está usando a versão mais recente dos plug-ins do App Engine do Gradle e Maven.

Como configurar projetos nativos do IntelliJ

No caso de projetos nativos do IntelliJ (ou seja, projetos configurados manualmente com a faceta do App Engine anterior e não sincronizados com o Gradle ou o Maven), atualize suas dependências do App Engine.

As dependências do App Engine ainda estão configuradas como "Bibliotecas externas" e são fornecidas pela instalação antiga do SDK do App Engine. Se você exclui-la, o aplicativo não será compilado.

Captura de tela mostrando a lista de bibliotecas externas.

Para remover essa dependência do SDK do App Engine antigo, configure as dependências da API App Engine usando o recurso de importação da biblioteca do App Engine Facet da seguinte maneira:

  1. Os usuários do recurso de melhoria do Datanucleus JDO/JPA do plug-in antigo precisam acessar aplicativos para Maven ou Gradle, já que a melhoria do Datanucleus não é compatível com o plug-in do Cloud Tools for IntelliJ.

  2. Na IU do IntelliJ Project Structure, navegue até a guia de dependências do módulo do App Engine Standard.

  3. Remova todas as bibliotecas relacionadas ao App Engine.

    Captura de tela mostrando a lista de bibliotecas externas e os ícones para excluí-los.

  4. Na mesma IU do Project Structure, navegue até a faceta do Google App Engine do módulo do App Engine.

  5. No painel Bibliotecas, selecione as dependências do App Engine que você está usando.

    Captura de tela mostrando a lista de bibliotecas disponíveis para seleção.

    Esta ação recuperará essas dependências automaticamente do Maven Central e as adicionará ao seu classpath do módulo.

  6. Execute localmente e implante para verificar se a nova configuração está funcionando.

  7. Nesse momento, você pode excluir com segurança seu antigo App Engine SDK.

A seguir

  • Explore o código do plug-in e informe problemas no GitHub ou faça uma pergunta no Stack Overflow.
Esta página foi útil? Conte sua opinião sobre:

Enviar comentários sobre…

Cloud Tools for IntelliJ
Precisa de ajuda? Acesse nossa página de suporte.