Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Neste documento, você vai aprender a migrar seu projeto do App Engine baseado no IntelliJ para o Cloud Code para IntelliJ.
Antes de começar
Se o projeto tiver como base o Maven ou Gradle e usar os plug-ins mais antigos baseados no SDK do App Engine (por exemplo, com.google.appengine.appengine-maven-plugin e com.google.appengine:gradle-appengine-plugin), faça primeiro a migração para os novos plug-ins Maven e Gradle com base na CLI gcloud.
O novo plug-in não é compatível com as melhorias do Datanucleus. Se você depende desse recurso, precisa configurar manualmente as melhorias do Datanucleus (JDO e JPA). Somente após isso o projeto será migrado para o Cloud Code.
Use a API Objectify como sua camada ORM ao ler/gravar no Datastore.
Instalar o novo plug-in
Se você ainda não tiver feito isso, instale o plug-in da seguinte maneira:
Verifique se você tem a versão compatível do ambiente de desenvolvimento integrado, a versão 2022.3 ou uma mais recente do JetBrains (como IntelliJ Ultimate/Community, PyCharm Professional/Community, WebStorm e GoLand), no PATH da sua máquina.
Abra o IntelliJ IDEA ou qualquer ambiente de desenvolvimento integrado compatível do JetBrains.
Abra a janela do mercado de plug-ins usando Arquivo > Configurações > Plug-ins. No Mac OS X, use IntelliJ IDEA > Preferences > Plugins.
Pesquise o plug-in "Cloud Code" e instale-o.
Talvez seja necessário reiniciar o ambiente de desenvolvimento integrado para ativar o plug-in.
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:
Quando notificado de que o novo plug-in está em conflito com a integração atual do App Engine,
clique no link da solicitação.
No prompt "Desativar o plug-in" a seguir, selecione "Desativar e reiniciar" para desativar
o plug-in do App Engine e reiniciar o ambiente de desenvolvimento integrado para que as alterações na configuração do plug-in
entrem em vigor.
Quando notificado de que o projeto está em um formato antigo, clique na opção para converter seu projeto no novo formato.
Exclua as instâncias atuais do App Engine Server e do Cloud e as recrie usando a nova CLI gcloud.
Navegue até Configurações -> Criação, execução, implantação ->
Servidores de aplicativos.
Selecione suas instâncias do App Engine Dev e clique em Excluir (-).
Clique em Adicionar (+) e selecione Google App Engine Dev Server.
Navegue até Configurações -> Criação, execução, implantação ->
Clouds.
Selecione as instâncias da nuvem do Google App Engine e clique em Excluir (-).
Clique em Adicionar (+) para configurar um destino de implantação da nuvem do App Engine.
Se tiver configurações de execução do servidor local do App Engine, atualize-as para usar o servidor de aplicativos recém-configurado.
Acesse Ferramentas > Cloud Code > App Engine para ver a lista de ações
disponíveis para executar e implantar seu aplicativo ou
consulte a documentação para mais informações.
Para projetos baseados em Maven ou Gradle, certifique-se de estar usando a versão mais recente dos plug-ins do App Engine do Gradle e Maven.
Como configurar projetos específicos do IntelliJ
Atualize as dependências do App Engine no caso de projetos nativos do IntelliJ, ou seja, projetos configurados manualmente com os atributos do App Engine anterior e não sincronizados com o Gradle ou o Maven.
As dependências do App Engine ainda estão configuradas como "Bibliotecas externas" e são fornecidas pela instalação do SDK do App Engine antigo. Ao excluí-la, o aplicativo não será compilado.
Para remover essa dependência no SDK do App Engine antigo, configure as dependências da API do App Engine usando o recurso de importação da biblioteca do App Engine Facet da seguinte maneira:
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 Code.
Na IU do IntelliJ Project Structure, vá até a guia de dependências do módulo do ambiente padrão do App Engine.
Remova todas as bibliotecas relacionadas ao App Engine.
Na mesma IU do Project Structure, acesse o atributo Google App Engine do módulo do App Engine.
No painel Bibliotecas, selecione as dependências do App Engine que você está usando.
Esta ação recuperará essas dependências automaticamente do Maven Central e as adicionará ao seu classpath do módulo.
Execute localmente e implante para verificar se a nova configuração está funcionando.
Nesse momento, você pode excluir com segurança seu antigo App Engine SDK.
Receber suporte
Para enviar um feedback ou informar um problema no ambiente de desenvolvimento integrado do IntelliJ, acesse
Tools > Cloud Code > Help / About > Envie
feedback ou informe um problema para informar um problema no GitHub.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Informações incorretas ou exemplo de código","incorrectInformationOrSampleCode","thumb-down"],["Não contém as informações/amostras de que eu preciso","missingTheInformationSamplesINeed","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-09-04 UTC."],[[["\u003cp\u003eThis guide explains the process of migrating App Engine projects from IntelliJ to Cloud Code for IntelliJ, focusing on necessary configurations and plugin installations.\u003c/p\u003e\n"],["\u003cp\u003eCloud Code supports Java 8 runtimes, but due to the impending deprecation of Java 8 support for App Engine, it is disabled by default and creating new App Engine projects is discouraged.\u003c/p\u003e\n"],["\u003cp\u003eBefore migrating, Maven or Gradle projects using older App Engine SDK plugins should switch to the new gcloud CLI-based plugins, as well as migrate from Datanucleus enhancement.\u003c/p\u003e\n"],["\u003cp\u003eUsers must install the Cloud Code plugin, disable the old App Engine plugin, convert their project format, delete old App Engine server and cloud instances, and ensure they use the latest version of Gradle and Maven App Engine plugins.\u003c/p\u003e\n"],["\u003cp\u003eIntelliJ-specific projects must remove old App Engine SDK dependencies and use the App Engine Facet library import feature to retrieve necessary dependencies from Maven Central, allowing for deletion of the old App Engine SDK.\u003c/p\u003e\n"]]],[],null,["# Migrate to Cloud Code for IntelliJ\n\nThis document describes how to migrate your IntelliJ-based App Engine project\nto Cloud Code for IntelliJ.\n| **Caution:** As of January 31, 2024, Java 8 support for App Engine has ended, and will be deprecated on January 31, 2026. As a result, Cloud Code disables App Engine by default. To enable App Engine in your IDE, navigate to **Settings** \\\u003e **Google\n| Cloud Code** \\\u003e **App Engine** . Due to the upcoming deprecation of App Engine, we don't recommend creating new App Engine projects. For more information about App Engine deprecations, see [Feature deprecations](/appengine/docs/standard/deprecations). For more information about the runtime support schedule for App Engine, see [Runtime support schedule](/appengine/docs/standard/lifecycle/support-schedule).\n\nBefore you begin\n----------------\n\n- If your project is Maven or Gradle based and uses the older\n App Engine SDK based plugins (e.g.\n `com.google.appengine.appengine-maven-plugin` and\n `com.google.appengine:gradle-appengine-plugin`), you should first migrate to\n the new gcloud CLI based\n [Maven](/appengine/docs/standard/java/tools/migrate-maven)\n and\n [Gradle](/appengine/docs/standard/java/tools/migrate-gradle)\n plugins.\n\n- The new plugin does not support Datanucleus enhancement. If you depend on\n this feature, you will have to manually configure Datanucleus\n ([JDO](/appengine/docs/standard/java/datastore/jdo/overview-dn2),\n [JPA](/appengine/docs/standard/java/datastore/jpa/overview-dn2))\n enhancement for your project to migrate to Cloud Code.\n You should use\n [Objectify](/appengine/docs/legacy/standard/java/datastore#using_objectify_with)\n as your ORM layer when reading/writing to Datastore.\n\nInstall the new plugin\n----------------------\n\nIf you haven't already, install the plugin by doing the following:\n\n- Ensure you have the supported IDE version, JetBrains IDE version 2022.3+ (such as IntelliJ Ultimate/Community, PyCharm Professional/Community, WebStorm, GoLand), on the `PATH` of your machine.\n- Open IntelliJ IDEA (or any supported JetBrains IDE).\n- Open the plugins marketplace window using **File** \\\u003e **Settings** \\\u003e **Plugins** . For Mac OS X, use **IntelliJ IDEA** \\\u003e **Preferences** \\\u003e **Plugins**.\n- Search for the 'Cloud Code' plugin and install it.\n\n You may be prompted to restart your IDE to activate the plugin.\n\nConfigure IntelliJ and your project\n-----------------------------------\n\nAfter installing the plugin, configure IntelliJ and your project to use the new\nplugin as follows:\n\n1. When notified that the new plugin conflicts with the existing\n App Engine integration, click the link in the prompt.\n\n2. In the following Disable Plugin prompt, select 'Disable and Restart' to\n disable the App Engine plugin and restart the IDE for the plugin\n configuration changes to take effect.\n\n3. When notified that your project is in an old format, click the option to\n **Convert** your project to the new format.\n\n4. You should delete your existing App Engine Server and Cloud\n instances and recreate them using the new gcloud CLI.\n\n 1. Navigate to **Settings** \\\u003e **Build, Execution, Deployment** \\\u003e\n **Application Servers**.\n\n 2. Select your **App Engine Dev** instances and click\n **Delete** (-).\n\n 3. Click **Add** (+) and select **Google App Engine Dev Server**.\n\n 4. Navigate to **Settings** \\\u003e **Build, Execution, Deployment** \\\u003e\n **Clouds**.\n\n 5. Select your **Google App Engine** cloud instances and click\n **Delete** (-).\n\n 6. Click **Add** (+) to configure an App Engine cloud deployment\n target.\n\n5. If you have any App Engine local server run configurations, then\n you must update them to use the newly configured Application Server.\n\n6. Navigate to **Tools** \\\u003e **Cloud Code** \\\u003e **App Engine** to see the list of actions\n available to you for running and deploying your application, or view\n [the documentation](/code/docs/intellij/how-to) for more information.\n\n7. For Maven or Gradle-based projects, ensure that you are using the latest\n version of the Gradle and Maven App Engine plugins.\n\nConfiguring IntelliJ-specific projects\n--------------------------------------\n\nFor IntelliJ-specific projects only (i.e., projects that have manually configured\nproject settings with the old App Engine facet and are not synced from\nGradle or Maven), update your App Engine dependencies.\n\nYour App Engine dependencies are still configured as\n'External Libraries' and provided by your old App Engine SDK\ninstallation. If you delete your App EngineSDK installation, your\napplication will not compile.\n\nTo remove this dependency on the old App Engine SDK, configure your\nApp Engine API dependencies using the App Engine Facet\nlibrary import feature as follows:\n\n1. Users of the old plugin's Datanucleus JDO/JPA enhancement feature need to\n port their applications to Maven or Gradle as Datanucleus enhancement is not\n supported by the Cloud Code plugin.\n\n2. From the IntelliJ Project Structure UI, navigate to your App Engine\n Standard module's dependencies tab.\n\n3. Remove all App Engine related libraries.\n\n4. In the same Project Structure UI, navigate to your App Engine\n module's **Google App Engine** facet.\n\n5. In the **Libraries** panel, select the App Engine dependencies you\n are using.\n\n This action will automatically retrieve these dependencies from Maven\n Central and add them to your module classpath.\n6. Run locally and deploy to verify your new configuration is working.\n\n7. At this point, you can safely delete your old App Engine SDK.\n\nGet support\n-----------\n\nTo submit feedback or report an issue in your IntelliJ IDE, go to **Tools** \\\u003e **Cloud Code** \\\u003e **Help / About** \\\u003e **Submit\nfeedback or report an issue** to report an issue on [GitHub](https://github.com/GoogleCloudPlatform/cloud-code-intellij/issues)."]]
