1.6.1 (April 5, 2018)
The google-cloud-java bill of materials is now included and used in the pom.xml files for new App Engine projects.
The App Engine SDK library (com.google.appengine:appengine-sdk-1.0-api)
is no longer included in the App Engine standard runtime definition.
To use classes from this jar, you must explicitly include this library in
your project. Select your project in the Package Explorer
and from the context menu select
Build Path > Add Libraries > Google Cloud Platform Libraries > App Engine API
and press Finish.
If you have an existing Maven project that depends on this library,
<scope>provided</scope> from the appengine-sdk-1.0-api
dependency in your pom.xml. The App Engine SDK jar will be removed from the
server runtime in the future.
1.6.0 (March 12, 2018)
Cloud Tools for Eclipse can now automatically download and maintain the Google Cloud SDK if the SDK is not found locally. You can learn more about this feature in the Managing the SDK for Your Project guide, including how you can update the SDK management preference.
The Eclipse status bar now displays the Google Cloud Platform service status.
Cloud Tools for Eclipse no longer supports Eclipse 4.5 Mars. Eclipse 4.6 Neon is now the minimum required version.
Cloud Tools for Eclipse marks the App Engine standard Java 7 runtime as deprecated.
Fixed a bug that local servers cannot be stopped in certain situations.
Fixed an issue that JARs downloaded while creating an App Engine project are sometimes corrupted.
1.5.1 (January 31, 2018)
New projects now use the latest available release versions of the Maven App Engine plugin and the Google Cloud Libraries for Java.
Fixed a bug that sometimes caused local servers to hang on launch.
1.5.0 (December 7, 2017)
YEdit and Dockerfile Editor are now optional installs, alongside the core Cloud Tools for Eclipse.
Service keys can be added to the local run for access to cloud services.
You can add and remove Cloud Libraries for Java from Eclipse projects.
Converted projects now default to Java 8 and the java8 runtime.
Deployment is more reliable for users with access to many hundreds of GCP projects.
1.4.1 (October 30, 2017)
App Engine standard environment
projects that depend on classes from
appengine-api-1.0-sdk.jar should no longer encounter
NoClassDefFoundErrors when running
on the local server.
When adding a Google library to a project for which no GA release version exists, Eclipse now picks the most recent beta or alpha version.
The "Google APIs" library has been renamed "Google Cloud Client Libraries for Java" to more accurately describe its contents.
1.4.0 (October 19, 2017)
Maven projects that package a runnable JAR—for example, Spring Boot or Spark Java applications—can be deployed to the App Engine flexible environment Java runtime.
Individual WAR files and runnable JAR archives can be deployed to the App Engine flexible environment, whether created by Eclipse or not.
All google-cloud-java libraries can be added to Java 8 Eclipse projects and Java 7 non-App Engine projects. The subset of these libraries that work in the App Engine Standard Java 7 runtime can be added to Java 7 App Engine projects.
Google managed library jars are now added to a single Google APIs container, rather than separate library containers.
Java 8 and Servlet 3.1 are now the default environment in the new project wizards. New projects should start with Java 8.
In native projects the App Engine SDK (com.google.appengine:appengine-sdk-1.0-api) is now included in the App Engine standard runtime definition, as it is in the server runtime.
The App Engine
standard runtime no longer includes JSTL (
jstl:jstl) to allow alternative
implementations. If you need to add JSTL to an existing project, you can
download the Apache
Standard Tag Library jar from Maven Central and place it
in your project's WEB-INF/lib directory.
App Engine standard environment
projects that depend on classes from
appengine-api-1.0-sdk.jar may encounter
NoClassDefFoundErrors when running
on the local server. Deployment and production environments are
To work around this in a Maven project, remove
<scope>provided</scope> from the
dependency element in
In a non-Maven project, copy the
WEB-INF/lib folder and refresh the project. You can
this jar from Maven Central.
Adding the Endpoints library to your project will add a dependency on the Servlet API 2.5, even in Java 8 projects that already depend on the Servlet API 3.1.
If your existing projects have the old style Google API library container, you'll need to upgrade them to the single "Google APIs" container. Select the project and use the context menu to select Configure > Update Project for Cloud Tools for Eclipse.
1.3.1 (September 13, 2017)
New project templates use HTML 5, Servlet 3.1, UTF-8 encoding, and Endpoints 2.0 where appropriate.
The Google Cloud Dataflow new project wizard appears on the toolbar button and works with the latest archetypes and SDK versions.
1.3.0 (August 7, 2017)
Google Cloud Dataflow is now supported.
You can filter GCP projects by name or project ID in the Project selector dialogs.
App Engine Standard Maven projects are now recognized when imported into Eclipse.
Maven based projects no longer use a separate wizard or archetypes. Maven is now added by selecting a checkbox in the New App Engine Standard Project wizard.
1.2.0 (June 12, 2017)
The App Engine flexible environment Java 8 runtime is now supported. You can create and deploy new flex projects. You can import and convert existing Java servlet projects for use in the flexible environment. Apps can be run locally by installing the Eclipse Jetty Integration.
Conversion of GPE projects that use the API manager results in fewer (hopefully zero) build errors.
1.1.0 (May 17, 2017)
Java 8 is supported by the local server. To enable this set the Java facet version
to 1.8 in the Eclipse project properties and
to appengine-web.xml. You can deploy a Java 8 Eclipse
project to the App Engine standard environment
if and only if the Google Cloud project you're deploying to is whitelisted
for Java 8 support.
Login now shows profile pictures.
Resolved several issues that could lead to NullPointerExceptions.
1.0.3 (April 12, 2017)
Autocomplete in appengine-web.xml.
You can run multiple local servers at the same time on different ports.
The correct admin server URL is displayed in the Eclipse console.
1.0.2 (April 4, 2017)
cron.xml, datastore-indexes.xml, dispatch.xml, dos.xml, and/or queue.xml can now be deployed from within the IDE.
New Submit issue or feedback... menu item for in-app bug reporting.
webapp folders are not configured as Java packages when converting an existing project.
Installing Cloud Tools for Eclipse no longer uninstalls the Android Developer Tools.
Pre-quick fix versions of XML files now appear in Eclipse's local history.
1.0.1 (March 16, 2017)
You can now add libraries to an Eclipse project after new project creation.
The deploy dialog includes a refresh button.
The JSTL jar is now added by default.
Applying a quick fix to an appengine-web.xml file with unsaved changes does not overwrite those changes.
If a project has build errors, Run As > App Engine prompts before running the server.
1.0.0 (March 1, 2017)
This is the same as Beta 16, only served from a new stable URL.
1.0 Beta 16 RC 1 (February 23, 2017)
Run As > App Engine waits for a modified file to be saved before it launches the local server.
When running a local server, the console says that the admin server can be found at http://localhost:59027/_ah/admin. This is incorrect. The admin server is found at http://localhost:8000/.
Applying a quick fix to an appengine-web.xml file with unsaved changes will overwrite those changes. Please save all changes before applying a quick fix.
If a project has build errors, Run As > App Engine does not prompt before running the server.
1.0 Beta 15 (February 16, 2017)
The deployed App Engine application is automatically opened in a web browser.
When available, names are displayed in the accounts panel along with email addresses.
You can choose from a list of available GCP projects when deploying, rather than having to type a project ID.
Warn user when appengine-web.xml contains an `application` element.
Run As > App Engine does not wait for a modified file to be saved before it launches the local server.
No more deadlocks (we hope) when creating new projects in milestone 5 of Eclipse Oxygen or Eclipse Neon 4.6.3 beta.
1.0 Beta 11 (February 6, 2017)
Recognize when Maven central is unreachable and warn the user, rather than creating an unbuildable project.
The latest milestone 5 of Eclipse Oxygen and beta of Neon 4.6.3 can deadlock when creating new projects. This does not occur in Eclipse 4.5 Mars or Neon 4.6.2 and earlier.
1.0 Beta 10 (January 30, 2017)
One click conversion of existing App Engine Eclipse projects, including Maven and GPE projects, to Cloud Tools for Eclipse projects.
The legacy Google Plugin for Eclipse is once again automatically uninstalled when Cloud Tools for Eclipse is installed.
Creating a new App Engine project when you can't connect to Maven Central — for example, because Wi-Fi is turned off — results in an unbuildable project.
1.0 Beta 9 (January 18, 2017)
Toolbar dropdown menu for performing App Engine tasks including generating new projects, running locally, and deploying.
Added a favicon.ico to the generated App Engine native project.
Projects can launch as long as you've selected a file from the project in the Package or Project Explorer. You no longer need to select the entire project.
Cannot detect the version of the Cloud SDK installed by various Linux package managers. If this causes problems, you can download a zip of the Cloud SDK and point Cloud Tools for Eclipse to that.
The legacy Google Plugin for Eclipse is not automatically uninstalled when Cloud Tools for Eclipse is installed. You should manually uninstall it before installing Cloud Tools for Eclipse.
1.0 Beta 8 (January 9, 2017)
Fixed several race conditions.
More complete autodetection of existing Cloud SDK installation on Linux.
Service elements in the non-Maven new project wizard.
1.0 Beta 7 (December 20, 2016)
Redesigned, simplified dialogs and new project wizards.
Context menu item for one-click run on local server.
Simplified import of existing GPE and other Eclipse servlet projects.
1.0 Beta 6 (December 9, 2016)
Cloud SDK minimum version is now 133.
GPE must be uninstalled before installing Cloud Tools for Eclipse.
Customized help in the new project wizards.
1.0 Beta 5 (December 7, 2016)
Look for the Cloud SDK in the LOCALAPPDATA directory on Windows.
Warn user when the Cloud SDK is too old (currently 130 or earlier).
New App Engine icons.
Progress monitors in the new project wizards more accurately track progress.
1.0 Beta 4 (November 23, 2016)
The plugin is now signed with the Google private key.
Now runs on any flavor of Eclipse 4.5 or later. Eclipse for Java EE is no longer required.
1.0 Beta 1 (November 3, 2016)
New App Engine Project Wizards.
Local run and debug in an App Engine emulator.
Deployment to App Engine Standard environment.
The plugin is not yet signed. You will see a warning when installing from the update site.