Introducción: configura tu entorno de desarrollo

Aprende a configurar tu entorno de compilación para el desarrollo y la implementación de aplicaciones en Google App Engine Standard. Los entornos de desarrollo y compilación compatibles son IntelliJ IDEA, Eclipse, Apache Maven y Gradle.

En esta guía, se mostrará cómo realizar las siguientes tareas:

  • Instalar la herramienta de línea de comandos del SDK de Google Cloud
  • Instalar y configurar los complementos de App Engine para Eclipse, IntelliJ, Gradle y Maven.
  • Crear un proyecto nuevo de App Engine

Instala los SDK obligatorios

  1. Si todavía no instalaste el SDK de Java SE 8, instala el kit de desarrollo de Java SE 8 (JDK).

  2. Instala la última versión del SDK de Google Cloud.

    Instalar el SDK de Google Cloud

  3. Instala el componente Java de App Engine:

    gcloud components install app-engine-java
    
  4. Autoriza tu cuenta de usuario:

    gcloud auth application-default login
    
  5. De manera opcional, ejecuta gcloud auth activate-service-account --key-file=your_key.json para crear una cuenta de servicio. Para obtener más información, consulta Autorización de las herramientas del SDK de Cloud.

Configura tu entorno de desarrollo

Eclipse

Antes de comenzar:

  1. Instala el IDE de Eclipse para desarrolladores de Java EE, versión 4.7 o posterior.

    Descargar Eclipse

  2. Si instalaste Google Plugin for Eclipse, completa el procedimiento de migración desde GPE.

Instala el complemento:

  1. Arrastra el botón de instalación a tu lugar de trabajo de Eclipse en ejecución:

    Arrastra a tu lugar de trabajo de Eclipse en ejecución.

    O bien, desde Eclipse, selecciona Help (Ayuda) > Eclipse Marketplace… y busca Google Cloud Tools for Eclipse.

  2. Reinicia Eclipse cuando se te solicite hacerlo.

IntelliJ

Antes de comenzar:

  1. Accede a tu Cuenta de Google.

    Si todavía no tienes una cuenta, regístrate para obtener una nueva.

  2. En GCP Console, en la página de selección de proyecto, selecciona o crea un proyecto de GCP.

    Ir a la página de selección de proyecto

  3. Comprueba que la facturación esté habilitada en tu proyecto.

    Descubre cómo puedes habilitar la facturación

  4. Asegúrate de tener instalado el siguiente software en tu sistema local:

Instala el complemento:

  1. En IDEA, abre File (Archivo) > Settings (Configuración). O bien, en macOS, abre IntelliJ IDEA > Preferences (Preferencias).
  2. Selecciona Plugins (Complementos) en el panel de navegación y busca Cloud Code.
  3. Haz clic en Install (Instalar).
  4. Selecciona Restart (Reiniciar) para reiniciar el IDE.
  5. Configura el JDK del proyecto:
    1. Abre File (Archivo) > Project Structure (Estructura del proyecto). O bien, en macOS, abre IntelliJ IDEA > Project Structure (Estructura del proyecto).
    2. Selecciona Project Settings (Configuración del proyecto) > Project (Proyecto).
    3. Si falta el JDK del proyecto, haz clic en New… (Nuevo…) y selecciona un JDK.

Gradle

  1. Instala Gradle v3.4.1 o una versión más reciente.

  2. Instala Git.

Maven

  1. Descarga Maven 3.5 del sitio web de Maven.

  2. Instala Maven 3.5 en tu equipo local.

Crea un proyecto nuevo de App Engine

Eclipse

  1. Haz clic en el botón Google Cloud Platform  de la barra de herramientas.

  2. Selecciona Create New Project (Crear proyecto nuevo) > Google App Engine Standard Java Project (Proyecto de Java para el entorno estándar de Google App Engine).

  3. Ingresa un nombre de proyecto y, de manera opcional, un paquete de Java.

  4. Para crear un proyecto de App Engine basado en Maven, marca Create as Maven Project (Crear como proyecto de Maven) y, luego, ingresa un ID de grupo y un ID de artefacto.

  5. Selecciona las bibliotecas que necesites para el proyecto: Objectify, la API de App Engine o Google Cloud Endpoints.

  6. Haz clic en Finish (Finalizar).

El asistente genera un proyecto nativo de Eclipse con un servlet sencillo que puedes implementar y ejecutar en el IDE.

IntelliJ

  1. Selecciona File (Archivo) > New (Nuevo) > Project (Proyecto) para abrir el cuadro de diálogo New Project (Proyecto nuevo).

  2. Selecciona Java en el panel izquierdo.

  3. En la sección Additional Libraries and Frameworks (Bibliotecas y marcos de trabajo adicionales), marca la casilla Google App Engine para tu entorno.

  4. Selecciona las bibliotecas adicionales que desees agregar a la ruta de clase de tu aplicación. La API de Servlet se seleccionará de forma predeterminada.

  5. Haz clic en Next (Siguiente).

  6. Ingresa un nombre de proyecto.

  7. Ingresa una ubicación del proyecto si no quieres mantener la configuración predeterminada.

  8. Actualiza los campos de la sección More Settings (Más opciones de configuración) si deseas cambiar los valores predeterminados.

  9. Haz clic en Finish (Finalizar).

Gradle

  1. Crea un directorio nuevo.

  2. Inicializa el proyecto nuevo en el directorio creado:

    gradle init --type java-library;
    mkdir -p src/main/webapp/WEB-INF;
    rm src/main/java/Library.java src/test/java/LibraryTest.java
    

    Gradle creará una estructura de directorio con dos clases vacías que se quitan en el comando final rm.

  3. Agrega el siguiente comando a tu archivo build.gradle para agregar las tareas y el complemento de App Engine Gradle, los repositorios de Maven, las dependencias y la configuración de las tareas.

    buildscript {      // Configuration for building
      repositories {
        jcenter()      // Bintray's repository - a fast Maven Central mirror & more
        mavenCentral()
      }
      dependencies {
        classpath 'com.google.cloud.tools:appengine-gradle-plugin:1.+' // Latest 1.x.x release
        classpath 'org.akhikhl.gretty:gretty:+'
      }
    }
    
    repositories {   // repositories for JARs you access in your code
      maven {
        url 'https://maven-central.storage.googleapis.com'             // Google's mirror of Maven Central
      }
    
    //maven {
    //  url 'https://oss.sonatype.org/content/repositories/snapshots' // SNAPSHOT repository if needed
    //}
    
      jcenter()
      mavenCentral()
    }
    
    apply plugin: 'java'
    apply plugin: 'war'
    apply plugin: 'org.akhikhl.gretty'
    apply plugin: 'com.google.cloud.tools.appengine'
    
    dependencies {
      providedCompile 'javax.servlet:javax.servlet-api:3.1.0'
      providedCompile 'com.google.appengine:appengine:+'
    // Add your dependencies here.
    
    }
    
    gretty {
        httpPort = 8080
        contextPath = '/'
        servletContainer = 'jetty9'  // What App Engine Flexible uses
    }
    
    appengine {
    
      deploy {   // deploy configuration
        stopPreviousVersion = true  // default - stop the current version
        promote = true              // default - & make this the current version
      }
    
    }
    
    group = 'com.example.appengine'   // Generated output GroupId
    version = '1.0-SNAPSHOT'          // Version in generated output
    
    sourceCompatibility = 1.8
    targetCompatibility = 1.8

Maven

Para crear una aplicación de App Engine, sigue estos pasos:

  1. Crea un directorio nuevo.

  2. Inicializa el proyecto nuevo en el directorio creado:

     mvn archetype:generate -Dappengine-version=1.9.59 -Djava8=true -DCloudSDK_Tooling=true -Dapplication-id=your-app-id -Dfilter=com.google.appengine.archetypes:
    
    1. Configura -Dappengine-version en la versión más reciente del SDK de App Engine para Java y application-id en el ID de tu proyecto de GCP.

    2. Configura -Djava8=true para implementar el proyecto en el entorno de ejecución de Java 8.

    3. Configura -DCloudSDK_Tooling=true para usar las herramientas del SDK de Cloud.

  3. Cuando se solicite elegir un arquetipo, elige el valor 2 para el arquetipo de App Engine. Esto crea un proyecto vacío que contiene la estructura de directorio y los archivos requeridos.

  4. Cuando se solicite la versión, presiona INTRO para seleccionar la versión predeterminada más reciente.

  5. Cuando debas configurar Define value for property 'groupId', proporciona el espacio de nombres que desees para tu aplicación, por ejemplo, com.mycompany.myapp.

  6. Cuando debas configurar Define value for property 'artifactId', ingresa el nombre del proyecto, por ejemplo, myapp.

  7. Cuando debas configurar Define value for property 'version', acepta el valor predeterminado.

  8. Cuando debas configurar Define value for property 'package', proporciona tu nombre de paquete preferido (o acepta el predeterminado). Los archivos de Java generados tendrán el nombre de paquete que especifiques aquí.

  9. Cuando se solicite confirmar tus elecciones, acepta el valor predeterminado (Y).

  10. Espera a que el proyecto se termine de generar y, luego, cambia los directorios al directorio del proyecto nuevo, por ejemplo, myapp/.

  11. Agrega el complemento basado en el SDK de Cloud al archivo pom.xml de tu proyecto.

    <build>
        <plugins>
           [...]
              <plugin>
                <groupId>com.google.cloud.tools</groupId>
                <artifactId>appengine-maven-plugin</artifactId>
                <version>1.3.1</version>
                <configuration>
                    <project>your-project-ID-goes-here</project>
                    <version>1</version>
                </configuration>
              </plugin>
           [...]
        </plugins>
    </build>
    
  12. Especifica el ID del proyecto de Google Cloud Platform de destino, y el servicio y la versión en la configuración del complemento.

Qué sigue

Ahora que tu entorno de desarrollo está configurado, puedes comenzar a implementar y desarrollar aplicaciones Java en App Engine.

¿Te ha resultado útil esta página? Enviar comentarios:

Enviar comentarios sobre...

Entorno estándar de App Engine para Java 8