This guide walks you through creating and deploying your first web application. For more details, please see the User's Guide.
- Installing the plugin
- Creating your first Web Application
- Running your Web Application locally
- Deploying your Web Application
App Engine does not yet support Java 8. You can build with version 8 of the JDK locally if and only if you set the Compiler compliance level for your project to Java 1.7. You cannot deploy an application that requires Java 8 to App Engine.
You can install the Google Plugin for Eclipse using the software update feature of Eclipse. Be sure to use the plugin that corresponds to your version of Eclipse. Follow the installation instructions provided at the links below or, if you are familiar with installing Eclipse plugins, you can simply paste the appropriate plugin link directly into Eclipse.
|Eclipse version||Installation instructions||Direct plugin link|
|Eclipse 4.5 (Mars)||Plugin for Eclipse 4.5 (Mars)||https://dl.google.com/eclipse/plugin/4.5|
|Eclipse 4.4 (Luna)||Plugin for Eclipse 4.4 (Luna)||https://dl.google.com/eclipse/plugin/4.4|
If you are looking for older versions of the plugin, click here.
If you are having trouble installing from the update sites (due to firewall issues, for instance), 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.,
You can specify a project ID or choose not to
(see Setting Project 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 need to create an App Engine project (not to be confused with the Eclipse project) in the Google Developers Console. If you already have an App Engine project, then you can skip this step.
Once you have an App Engine project ID, right-click on your Eclipse project, and select Google > App Engine Settings... from the context menu. Enter your project ID into the Project 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.
http://project-id.appspot.com/ to see your application.