Primeiros passos: como configurar o ambiente de desenvolvimento

Saiba como configurar o ambiente de criação para desenvolvimento e implantação do aplicativo no Google App Engine padrão. Os ambientes de desenvolvimento e criação compatíveis com Java são IntelliJ IDEA, Eclipse, Apache Maven e Gradle.

Neste guia, mostraremos como:

  • instalar a ferramenta de linha de comando do SDK do Google Cloud;
  • instalar e configurar os plug-ins do App Engine para Eclipse, IntelliJ, Gradle e Maven;
  • criar um novo projeto do App Engine.

Como instalar os SDKs necessários

  1. Instale o Java SE 8 Development Kit (JDK), caso ainda não tenha feito isso.

  2. Instale a versão mais recente do Google Cloud SDK.

    Instalar o Google Cloud SDK

  3. Instale o componente Java do App Engine:

    gcloud components install app-engine-java
    
  4. Autorize sua conta de usuário:

    gcloud auth application-default login
    
  5. Como alternativa, é possível criar uma conta de serviço executando gcloud auth activate-service-account --key-file=your_key.json. Para mais informações, consulte Como autorizar ferramentas do Cloud SDK.

Como configurar o ambiente de desenvolvimento

Eclipse

Antes de começar:

  1. Install Eclipse IDE for Java EE Developers, version 4.8 or later:

    Download Eclipse

  2. If you have the Google Plugin for Eclipse installed, complete the migrating from GPE procedures.

Instalar o plug-in:

  1. Drag the install button into your running Eclipse workspace:

    Drag to your running Eclipse workspace.

    Or from inside Eclipse, select Help > Eclipse Marketplace... and search for Google Cloud Tools for Eclipse.

  2. Restart Eclipse when prompted.

IntelliJ

Antes de começar:

  1. Certifique-se de que o software abaixo esteja instalado em seu sistema local:

Instalar o plug-in:

  1. No IDEA, abra File > Settings. Como opção, no Mac OS X, abra IntelliJ IDEA > Preferences.
  2. Selecione Plugins no painel de navegação e pesquise Código Cloud.
  3. Clique em Install.
  4. Escolha Restart para reiniciar seu ambiente de desenvolvimento integrado (IDE, na sigla em inglês).
  5. Configure o JDK do projeto:
    1. Abra File > Project Structure. Como opção, no Mac OS X, abra IntelliJ IDEA > Project Structure.
    2. Escolha Project Settings > Project.
    3. Caso o JDK do projeto esteja ausente, clique em New… e escolha um JDK.

Gradle

  1. Instale o Gradle versão 3.4.1 ou posterior

  2. Instale o Git

Maven

  1. Faça o download do Maven 3.5 no site do Maven.

  2. Instale o Maven 3.5 na máquina local.

Como criar um novo projeto do App Engine

Eclipse

  1. Click the Google Cloud Platform toolbar button .

  2. Select Create New Project > Google App Engine Standard Java Project.

  3. Enter a Project name and (optionally) a Java package.

  4. To create a Maven-based App Engine project, check Create as Maven Project and enter a Maven Group ID and Artifact ID of your choosing to set the coordinates for this project. The Group ID is often the same as the package name, but does not have to be. The Artifact ID is often the same as or similar to the project name, but does not have to be.

  5. Click Next.

  6. Select any libraries you need in the project.

  7. Click Finish.

The wizard generates a native Eclipse project, with a simple servlet, that you can run and deploy from the IDE.

IntelliJ

  1. Selecione Arquivo > Novo > Projeto para exibir a caixa de diálogo Novo projeto.

  2. Escolha Java no painel à esquerda.

  3. Na seção Bibliotecas e frameworks adicionais, marque a caixa Google App Engine para seu ambiente.

  4. Selecione as outras bibliotecas que você quer adicionar ao classpath do seu aplicativo. A API Servlet é selecionada por padrão.

  5. Clique em Avançar.

  6. Digite o Nome do projeto.

  7. Digite um Local do projeto, se você não quiser manter o padrão.

  8. Atualize os campos na seção Mais configurações, se você não quiser manter os padrões.

  9. Clique em Concluir.

Gradle

  1. Crie um novo diretório.

  2. Inicialize o novo projeto no diretório criado:

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

    O Gradle criará uma estrutura de diretório com duas classes vazias que serão removidas no comando final rm.

  3. Para adicionar as tarefas Gradle do App Engine, os repositórios do Maven, o plug-in do Gradle do App Engine, as dependências e a configuração da tarefa, adicione o elemento abaixo ao arquivo build.gradle:

    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 criar um aplicativo do App Engine:

  1. Crie um novo diretório.

  2. Inicialize o novo projeto no diretório criado:

     mvn archetype:generate -Dappengine-version=1.9.59 -Djava8=true -DCloudSDK_Tooling=true -Dapplication-id=your-app-id -Dfilter=com.google.appengine.archetypes:
    
    1. Configure -Dappengine-version com a versão mais recente do SDK do App Engine para Java e application-id com o código do projeto do GCP.

    2. Configure -Djava8=true para implantar o projeto no tempo de execução do Java 8.

    3. Configure -DCloudSDK_Tooling=true para usar as ferramentas do Cloud SDK.

  3. Quando solicitado a escolher um arquétipo, escolha o valor 2 para o arquétipo da estrutura do App Engine. Isso cria um projeto vazio que contém a estrutura de diretórios e os arquivos obrigatórios.

  4. Quando a versão for solicitada, pressione ENTER para selecionar a versão mais recente padrão.

  5. Quando for exibida a solicitação Define value for property 'groupId', forneça o namespace que você quer para o aplicativo. Por exemplo, com.mycompany.myapp.

  6. Quando for exibida a solicitação Define value for property 'artifactId', forneça o nome do projeto. Por exemplo, myapp.

  7. Quando for exibida a solicitação Define value for property 'version', aceite o valor padrão.

  8. Quando for exibida a solicitação Define value for property 'package', forneça o nome do pacote preferido ou aceite o padrão. Os arquivos do Java gerados terão o nome do pacote que você especificar aqui.

  9. Quando solicitado a confirmar as opções escolhidas, aceite o valor padrão (Y).

  10. Aguarde a conclusão da geração do projeto. Em seguida, altere os diretórios para o novo diretório do projeto. Por exemplo myapp/.

  11. Adicione o plug-in baseado no SDK do Cloud ao arquivo pom.xml do projeto.

    <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. Especifique o código do projeto do Google Cloud Platform e o serviço e a versão na configuração do plug-in.

A seguir

Agora que o ambiente de desenvolvimento está configurado, você pode começar a desenvolver e implantar aplicativos Java no App Engine.