Google Plugin for Eclipse

Quick Start

This guide will walk you through creating and deploying your first web application. For more details, please see the User's Guide.

Installing the Plugin

These instructions assume that you have already installed some flavor of Eclipse. If you have not, Eclipse can be downloaded from http://www.eclipse.org/downloads/.

Note: As an alternative to installing from the update site, you can install the Google Plugin for Eclipse by downloading and installing an archive of the update site.

Update sites

If you are already familiar with installing Eclipse plugins, you can just use the update site URL below for your version of Eclipse.

Eclipse 4.3 (Kepler)

https://dl.google.com/eclipse/plugin/4.3


Eclipse 3.8/4.2 (Juno)

https://dl.google.com/eclipse/plugin/4.2


Eclipse 3.7 (Indigo)

https://dl.google.com/eclipse/plugin/3.7


Detailed instructions for installing the Plugin, GWT SDK, and Google App Engine SDK

If you are new to Eclipse, the following detailed installation instructions should be useful. They describe how to install the Google Plugin for Eclipse and optionally the Google Web Toolkit SDK and Google App Engine SDK.

Google Plugin for Eclipse 4.3 (Kepler).

Google Plugin for Eclipse 3.8/4.2 (Juno).

Google Plugin for Eclipse 3.7 (Indigo).

Note: If you are having trouble installing from the update sites, please see this FAQ entry. If you are looking for older versions of the plugin, click here.

Note: As an alternative to installing from the update site, you can install the Google Plugin for Eclipse by downloading and installing an archive of the update site.

Creating your first Web Application

To create your first Web Application, select File > New > Web Application Project from the Eclipse menu.

In the New Web Application Project wizard, enter a name for your project and a java package name, e.g., com.example.mywebapp. You can specifiy an app id or choose not to (see Setting App ID in New Web Application Project wizard for more details). Click Finish.

Note: Using Java keywords as a project name (e.g. "New" and "Class") will result in various build errors. Avoid these where possible.

Congratulations, you now have an App Engine and GWT-enabled web application!

Running your Web Application locally

Right-click on your web application project and select Debug As > Web Application from the popup menu. You are testing your application using the Java Development Server.

This action creates an Eclipse Web Application launch configuration for you and launches it. The web application launch configuration will start a server, whose URL will appear in the Development Mode view at the bottom of the Eclipse window. Select the URL and click Copy in the context menu, and then open it in your web browser to load the application.

At this point, you can set breakpoints, inspect variables and modify code as you would normally expect from a Java Eclipse debugging session.

Deploying your Web Application

To deploy your web application, you will need to create an application from the App Engine Administration Console, at the following URL: https://appengine.google.com/. If you already have one, then you can skip this step.

Once you have an application ID, just right-click on your project, and select Google > App Engine Settings... from the context menu. Enter your application ID into the Application ID text box. Click OK.

Right-click on your project and select Google > Deploy to App Engine. If you haven't already signed in using your Google account, you will be prompted to do so. See Sign In for more details.

Click Deploy.

Go to http://application-id.appspot.com/ to see your application.

Authentication required

You need to be signed in with Google+ to do that.

Signing you in...

Google Developers needs your permission to do that.