Google App Engine SDK for Python

Note: The App Engine SDK is under active development; please keep this in mind as you explore its capabilities. See the SDK Release Notes for information on the most recent changes to the App Engine SDK. If you discover any issues, please feel free to notify us via our Issue Tracker.

To install on Linux:

1. Unzip the App Engine SDK file you downloaded (google_appengine_1.9.22.zip), for example:

   unzip google_appengine_1.9.22.zip 

   There is no App Engine installation script that you need to run after unzipping the files.

2. Add the google_appengine directory to your PATH:

   export PATH=$PATH:/path/to/google_appengine/

3. Make sure Python 2.7 is installed on your machine using the following command:

   /usr/bin/env python -V

   The output should look like this: Python 2.7.<number>. If Python 2.7 isn't installed, install it now using the installation instructions for your Linux distribution.

To install the SDK on Mac OS X:

1. In the Finder, click Go > Applications to open the Applications folder.
2. Double click the App Engine SDK file you downloaded (GoogleAppEngineLauncher-1.9.22.dmg) to open it, then drag the GoogleAppEngineLauncher icon over to the Applications folder.
3. Double-click GoogleAppEngineLauncher in the Application folder.
4. When prompted to Make command symlinks, click OK. The symlinks allow you to run important SDK command-line tools in any terminal window.

   Important: The GoogleAppEngineLauncher is a convenient UI-based tool for running and deploying App Engine apps, but it does not provide all the features you'll need. You will need to use the command-line equivalent, appcfg.py, for many of the features you'll want to use.

5. Notice that the installation process above unpacks the contents of the App Engine SDK at the location:

   /usr/local/google_appengine

6. The App Engine SDK requires Python 2.7, which is installed by default on Mac OS X 10.6 (Lion) or later. Verify your Mac's Python installation using the following command:

   /usr/bin/env python -V

   If the output looks like Python 2.7.<number> then you already have the correct Python version installed. Otherwise you can download and install Python 2.7 from the Python web site.

To install the SDK on Windows:

1. Double-click the SDK file you downloaded (GoogleAppEngine-1.9.22.msi) and follow the prompts to install the SDK.
2. You will need Python 2.7 to use the App Engine SDK, because the Development Server is a Python application. Download Python 2.7.X (don't use a higher version) from the Python web site.

For more information on the SDK for Python:

• Python Runtime Environment
• Getting Started Guide