Please note that the contents of this offline web site may be out of date. To access the most recent documentation visit the online version .
Note that links that point to online resources are green in color and will open in a new window.
We would love it if you could give us feedback about this material by filling this form (You have to be online to fill it)



Tutorial Setup

To complete this tutorial, you'll need the proper versions of Java and Maven.

Required Java version

We recommend using Java 7.

Downloading Java

If you don't have Java, follow these instructions to download the Java Development Kit (JDK) for Java version 7:

  1. Download and install it.

  2. Set your JAVA_HOME environment variable. If you are a bash user

    1. For a typical Linux installation, add a line similar to the following to your .bashrc file:

      export JAVA_HOME=/usr/local/tools/java/jdk1.7.0_45.jdk
      
    2. If you use Mac OSX and the default Terminal app, your shell session doesn't load .bashrc by default. So you may need to add a line similar to the following to your .bash_profile :

      [ -r ~/.bashrc ] && source ~/.bashrc
      
    3. If you use Mac OSX but don't use the default terminal app, for example, you use a terminal management app such as tmux, you may need to add a line similar to the following line to your .bashrc file:

      export JAVA_HOME=/Library/Java/JavaVirtualMachines/jdk1.7.0_45.jdk/Contents/Home
      

Required Maven version

This tutorial requires Apache Maven 3.1 or greater, so you'll need to download it if it isn't installed on your machine. To determine whether Maven is installed and which version you have, invoke the following command:

 mvn -v

This command should display a long string of information beginning with something like Apache Maven 3.1.0 .

If Maven isn't installed on your machine, you can download Maven from the Apache Maven website , and install it using the Apache Maven instructions.

The Google App Engine SDK and Maven

When you use Maven, you don't need to download the Google App Engine SDK. Maven does that for you. You'll also use Maven to test your app locally and upload (deploy) it to production App Engine.

Creating the Project >>

Authentication required

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

Signing you in...

Google Developers needs your permission to do that.