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)



Setup

To set up your environment:

  1. You must use Java 7. If you don't have Java 7, 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
      
  3. If you don't have Maven installed, download and install Maven.

Creating an App Engine app for deployment

Part of this tutorial covers deploying an app to production App Engine. To do this part of the tutorial, you'll need a Google Developers Console project to deploy to. You can use an existing project, or you can create a new one for the tutorial.

To create a new project for this tutorial:

  1. Make sure you are logged into the Google account you want to use for the project.

  2. Visit the Google Developers Console . You may need to accept one or more Terms of Service.

  3. Click Create Project .

  4. In the New Project dialog, assign some name for your project. It doesn't have to match the name you assign to your Maven project (described later). You can accept the project ID or enter your own value. Note the project ID, since you'll need this later.

  5. Click Create to create the project.

  6. Note the project ID, as you'll need it later. (Alternatively, you can revisit the project later in the console to determine its ID.)

  7. Click APIs & auth > Credentials > Create new Client ID .

  8. If this is a new project,Fill out the Create Client ID Form :

    1. Select Web application as the Application Type .
    2. Specify http://localhost:8080 in the textbox labeled AUTHORIZED JAVASCRIPT ORIGINS. (This is for local testing only. We'll change this to the proper deployment value later during deployment .
    3. Click Create Client ID .
    4. Note the client ID as you'll need it later. (Alternatively, you can revisit the project later in the console to determine its client ID.)

Creating a Simple Hello World Backend API >>

Authentication required

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

Signing you in...

Google Developers needs your permission to do that.