Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
En este documento, se describe cómo migrar tu proyecto de App Engine basado en IntelliJ a Cloud Code para IntelliJ.
Antes de comenzar
Si tu proyecto se basa en Maven o Gradle y usa los complementos antiguos basados en el SDK de App Engine (p.ej., com.google.appengine.appengine-maven-plugin y com.google.appengine:gradle-appengine-plugin), primero debes migrar a los nuevos complementos de Maven y Gradle basados en gcloud CLI.
El complemento nuevo no admite mejoras de Datanucleus. Si dependes de esta función, deberás configurar la optimización de Datanucleus (JDO y JPA) de forma manual para que el proyecto se migre a Cloud Code.
Debes usar Objectify como la capa de ORM cuando leas o escribas en Datastore.
Instala el complemento nuevo
Si aún no lo hiciste, instala el complemento de la siguiente manera:
Asegúrate de tener la versión del IDE compatible, IDE de JetBrains versión 2022.3+ (como IntelliJ Ultimate/Community, PyCharm Professional/Community, WebStorm y GoLand) en la PATH de tu máquina.
Abre IntelliJ IDEA (o cualquier IDE de JetBrains admitido).
Abre la ventana del mercado de complementos; para ello, ve a Archivo > Configuración > Complementos. En Mac OS X, usa IntelliJ IDEA > Preferencias > Complementos.
Busca el complemento “Cloud Code” y, luego, instálalo.
Es posible que debas reiniciar el IDE para activar el complemento.
Configura IntelliJ y el proyecto
Después de instalar el complemento, debes seguir estos pasos a fin de configurar IntelliJ y tu proyecto para usar el complemento nuevo:
Cuando recibas la notificación de que el complemento nuevo genera conflictos con la integración existente de App Engine, haz clic en el vínculo del mensaje.
En el siguiente mensaje de inhabilitación de complementos, selecciona “Inhabilitar y reiniciar” (Disable and Restart) para inhabilitar el complemento de App Engine y reiniciar el IDE para que se apliquen los cambios de configuración del complemento.
Cuando recibas la notificación de que el proyecto tiene un formato antiguo, haz clic en Convert (Convertir) para convertirlo al formato nuevo.
Deberías borrar el servidor existente de App Engine y las instancias de Cloud, y volver a crearlos con la nueva gcloud CLI.
Navega a Configuración (Settings) -> Compilación, Ejecución, Implementación (Build, Execution, Deployment) -> Servidores de la aplicación (Application Servers).
Selecciona tus instancias de Desarrollo de App Engine y haz clic en Borrar (-).
Haz clic en el símbolo de Agregar (+) y selecciona Google App Engine Dev Server (Servidor de desarrollo de Google App Engine).
Selecciona las instancias de la nube de Google App Engine y haz clic en Borrar (-).
Haz clic en el símbolo de Agregar (+) para configurar un objetivo de implementación en la nube de App Engine.
Si tienes alguna configuración de ejecución en el servidor local de App Engine, debes actualizarla para que use el servidor de aplicaciones recién configurado.
Navega a Herramientas > Cloud Code > App Engine para ver la lista de acciones disponibles a fin de implementar y ejecutar tu aplicación, o consulta la documentación para obtener más información.
Para proyectos basados en Maven o Gradle, asegúrate de que usas la versión más reciente de los complementos de App Engine para Gradle y Maven.
Configura proyectos específicos de IntelliJ
Actualiza tus dependencias de App Engine solo para los proyectos específicos de IntelliJ (p. ej., proyectos cuyos ajustes se configuraron de forma manual con la faceta antigua de App Engine y que no se sincronizaron con Gradle o Maven).
Tus dependencias de App Engine están configuradas como "External Libraries" (Bibliotecas externas) y las proporciona la instalación antigua del SDK de App Engine. Si borras la instalación del SDK de App Engine, la aplicación no se compilará.
Para quitar esta dependencia del SDK antiguo de App Engine, configura las dependencias de la API de App Engine mediante la función de importación de la biblioteca Facet de App Engine de la siguiente manera:
Los usuarios de la antigua característica de mejora JDO/JPA de Datanucleus del complemento deben portar sus aplicaciones a Maven o Gradle, ya que la mejora de Datanucleus no es compatible con el complemento de Cloud Code.
En la IU de la estructura del proyecto de IntelliJ, navega a la pestaña de dependencias estándar del módulo de App Engine.
Quita todas las bibliotecas relacionadas de App Engine.
En la misma IU de la estructura del proyecto, navega a la faceta de Google App Engine del módulo de App Engine.
En el panel Libraries (Bibliotecas), selecciona las dependencias de App Engine que usas.
Con esta acción, se recuperarán de forma automática estas dependencias de Maven Central y se agregarán a la ruta de clase del módulo.
Ejecuta y luego implementa de forma local para verificar que tu configuración nueva funcione.
En este punto, ya puedes borrar con seguridad tu SDK de App Engine antiguo.
Obtenga asistencia
Para enviar comentarios o informar un problema en tu IDE de IntelliJ, ve a Tools > Cloud Code > Help / About > Submit feedback or report an issue para informar un problema en GitHub.
[[["Fácil de comprender","easyToUnderstand","thumb-up"],["Resolvió mi problema","solvedMyProblem","thumb-up"],["Otro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Información o código de muestra incorrectos","incorrectInformationOrSampleCode","thumb-down"],["Faltan la información o los ejemplos que necesito","missingTheInformationSamplesINeed","thumb-down"],["Problema de traducción","translationIssue","thumb-down"],["Otro","otherDown","thumb-down"]],["Última actualización: 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)."]]
