Migrating from the Google Plugin for Eclipse

The Google Plugin for Eclipse will not be supported beyond Eclipse 4.6 (Neon) and will be deprecated in early 2018.

This document describes how to migrate a project that uses the Google Plugin for Eclipse to the supported tooling.

App Engine Standard

Cloud Tools for Eclipse supports development for the App Engine environment. To migrate your existing GPE project to Cloud Tools for Eclipse:

1. If you're using Eclipse 4.5 or earlier, upgrade to Eclipse 4.6 or later.

2. Install Cloud Tools for Eclipse. This process will uninstall GPE.

3. Open the Project Explorer in Eclipse.

4. Right click the project you want to convert and select Configure > Convert to App Engine Project.

Apps Script

You can edit your Apps Script projects directly in your web browser using the Google Drive script editor.

All of your Apps Script projects are already available in Google Drive, without additional export or conversion.

GWT

Install the GWT Eclipse plugin.

You may see build errors in your GWT projects. To resolve them:

1. Select the Project in the Project Explorer.

2. Open the context menu.

3. Select Configure > Enable GWT SDM builder.

App Engine + GWT

App Engine code runs on the server, and GWT code runs on the client, though it's compiled and served from the server. Ideally you should divide these into separate projects: an App Engine Eclipse project and a GWT Eclipse project.

Once you've done that, you can follow the App Engine standard migration steps and the GWT project migration steps, as described above.

Android

Android Studio is the official IDE for Android development.

You can convert your existing Eclipse Android projects into Android Studio projects with Gradle-based build files using the procedures to migrate from Eclipse.

Cloud Endpoints

GPE supported Cloud Endpoints v1. You may wish to upgrade to Cloud Endpoints v2. There's nothing IDE specific about this upgrade.

No IDE, Eclipse included, currently provides integrated support for Cloud Endpoints v2. You can work with Cloud Endpoints v2 projects in Eclipse, as you would with any other Java project. However, there are no Endpoints specific code inspections, code generators, new project wizards, editors, or deployment tools.

If you wish to continue using Cloud Endpoints v1, you can likewise import your backend project into Eclipse as you would any other Java project. The simplest approach for working with Endpoints v1 without GPE is to leverage the com.google.appengine:appengine-maven-plugin and the Eclipse m2e integration.

If your project is not already built with maven, you need to add a pom.xml file:

1. If necessary, install the m2e plugin.

2. Select the project in the Project Explorer.

3. From the context menu, select Configure > Convert to Maven Project. This conversion adds a pom.xml file to the project and sets the project to use the Maven builder.

4. Add the following dependencies to that pom.xml:

    <dependencies>
      <dependency>
        <groupId>com.google.appengine</groupId>
        <artifactId>appengine-endpoints</artifactId>
        <version>1.9.51</version>
      </dependency>
      <dependency>
        <groupId>org.eclipse.persistence</groupId>
        <artifactId>javax.persistence</artifactId>
        <version>2.1.0</version>
      </dependency>
      <dependency>
        <groupId>javax.inject</groupId>
        <artifactId>javax.inject</artifactId>
        <version>1</version>
      </dependency>
      <dependency>
        <groupId>javax.servlet</groupId>
        <artifactId>javax.servlet-api</artifactId>
        <version>3.1.0</version>
      </dependency>
      <dependency>
        <groupId>com.google.code.findbugs</groupId>
        <artifactId>jsr305</artifactId>
        <version>3.0.2</version>
      </dependency>
      <dependency>
        <groupId>com.google.appengine.orm</groupId>
        <artifactId>datanucleus-appengine</artifactId>
        <version>2.1.2</version>
      </dependency>
    </dependencies>
   

   If your application depends on other libraries, add those dependencies too.

5. Add this plugin to the plugins section:

    <plugin>
        <groupId>com.google.cloud.tools</groupId>
        <artifactId>endpoints-framework-maven-plugin</artifactId>
        <version>1.0.0</version>
    </plugin>
   

6. Once your pom.xml is set up, use the endpoints-framework:discoveryDocs goal to generate discovery docs:

    $ mvn endpoints-framework:discoveryDocs
   

7. Use the endpoints-framework:clientLibs goal to generate client libraries:

    $ mvn endpoints-framework:clientLibs
   

You can map these goals to Eclipse Maven Build run configurations for easy access from the Run menu.

Android + Cloud Endpoints

Android Studio supports Cloud Endpoints.

DataNucleus (JPA & JDO)

Cloud Tools for Eclipse does not auto enhance entity classes.

You can install the DataNucleus Eclipse plugin for this functionality or use Maven.