Migra a Cloud Code para IntelliJ

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 complementos nuevos 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 de 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:

  1. 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.

    Captura de pantalla que muestra la notificación que indica que el complemento entra en conflicto.
 Haz clic en “Hacer clic aquí” para inhabilitar el complemento.

  2. 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.

    Captura de pantalla en la que se muestra si deseas inhabilitar el complemento de App Engine y reiniciar el IDE.

  3. Cuando recibas la notificación de que tu proyecto tiene un formato antiguo, haz clic en Convertir (Convert) para convertirlo al nuevo.

  4. Debes borrar el servidor existente de App Engine y las instancias de Cloud, y volver a crearlos con la nueva gcloud CLI.

    1. Navega a Configuración (Settings) -> Compilación, Ejecución, Implementación (Build, Execution, Deployment) -> Servidores de la aplicación (Application Servers).

    2. Selecciona tus instancias de Desarrollo de App Engine y haz clic en Borrar (-).

    3. Haz clic en el símbolo de Agregar (+) y selecciona Google App Engine Dev Server (Servidor de desarrollo de Google App Engine).

      Captura de pantalla en la que se muestran una lista de servidores de apps y el ícono para borrarlos y agregarlos

    4. Navega a Configuración (Settings) -> Compilación, Ejecución, Implementación (Build, Execution, Deployment) -> Nubes (Clouds).

    5. Selecciona las instancias de la nube de Google App Engine y haz clic en Borrar (-).

    6. Haz clic en el símbolo de Agregar (+) para configurar un objetivo de implementación en la nube de App Engine.

      Captura de pantalla en la que se muestran una lista de instancias en la nube y los íconos para borrarlas y agregarlas

  5. 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.

  6. 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.

  7. 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á.

Captura de pantalla en la que se muestra una lista de bibliotecas externas

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:

  1. 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.

  2. 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.

  3. Quita todas las bibliotecas relacionadas de App Engine.

    Captura de pantalla en la que se muestran una lista de bibliotecas externas y los íconos para borrarlas

  4. En la misma IU de la estructura del proyecto, navega a la faceta de Google App Engine del módulo de App Engine.

  5. En el panel Libraries (Bibliotecas), selecciona las dependencias de App Engine que usas.

    Captura de pantalla en la que se muestra una lista de las bibliotecas disponibles para seleccionar

    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.

  6. Ejecuta y luego implementa de forma local para verificar que tu configuración nueva funcione.

  7. En este punto, ya puedes borrar con seguridad tu SDK de App Engine antiguo.

Obtener asistencia

Para enviar comentarios o informar un problema en tu IDE de IntelliJ, ve aTools >Cloud Code >Help / About >Envía comentarios o informa un problema para informar un problema en GitHub o hacer una pregunta en Stack Overflow.