Copyright 2008 Google Inc. All rights reserved.

App Engine SDK - Development tools for Google App Engine CONTENTS ======== * * * * * * Installing on Mac OSX Installing on Windows Installing on Linux and other platforms Running the SDK Using the SDK Using the App Engine Launcher

INSTALLING ON Mac OSX ===================== 1) Download and install Python 2.5 from http://www.python.org/download/ 2) Download the SDK installer from http://code.google.com/appengine/downloads 3) Install the SDK by double-clicking on the GoogleAppEngine.dmg file and running the installer. INSTALLING ON WINDOWS ===================== 1) Download and install Python 2.5 from http://www.python.org/download/ 2) Download the SDK installer from http://code.google.com/appengine/downloads 3) Install the SDK by double-clicking on the GoogleAppEngine.msi file and running the installer. INSTALLING ON LINUX AND OTHER PLATFORMS =============================== 1) Download and install Python 2.5 from http://www.python.org/download/ 2) Download the SDK zip file from http://code.google.com/appengine/downloads 3) Unpack the zip file. RUNNING THE SDK ========================= You can run the SDK with the following command: dev_appserver.py [options] <application root> Application root must be the path to the application to run in this server. Must contain a valid app.yaml or app.yml file. Options: --address=ADDRESS, -a ADDRESS Address to which this server should bind. (Default localhost). --clear_datastore, -c Clear the Datastore on startup. (Default false) --debug, -d Use debug logging. (Default false) --help, -h View this helpful message. --port=PORT, -p PORT Port for the server to run on. (Default 8080) --allow_skipped_files --auth_domain Allow access to files matched by app.yaml's skipped_files (default False) Authorization domain that this app runs in.

(Default gmail.com) Run the dev_appserver with backends support (multiprocess mode). --blobstore_path=DIR Path to directory to use for storing Blobstore file stub data. --clear_prospective_search Clear the Prospective Search subscription index (Default false). --datastore_path=DS_FILE Path to file to use for storing Datastore file stub data. (Default /tmp/dev_appserver.datastore) --debug_imports Enables debug logging for module imports, showing search paths used for finding modules and any errors encountered during the import process. --default_partition Default partition to use in the APPLICATION_ID. (Default dev) --disable_static_caching Never allow the browser to cache static files. (Default enable if expiration set in app.yaml) --disable_task_running When supplied, tasks will not be automatically run after submission and must be run manually in the local admin console. --enable_sendmail Enable sendmail when SMTP not configured. (Default false) --high_replication Use the high replication datastore consistency model. (Default false). --history_path=PATH Path to use for storing Datastore history. (Default /tmp/dev_appserver.datastore.history) --multiprocess_min_port When running in multiprocess mode, specifies the lowest port value to use when choosing ports. If set to 0, select random ports. (Default 9000) --require_indexes Disallows queries that require composite indexes not defined in index.yaml. --show_mail_body Log the body of emails in mail stub. (Default false) --skip_sdk_update_check Skip checking for SDK updates. If false, fall back to opt_in setting specified in .appcfg_nag (Default false) --smtp_host=HOSTNAME SMTP host to send test mail to. Leaving this unset will disable SMTP mail sending. (Default '') --smtp_port=PORT SMTP port to send test mail to. (Default 25) --smtp_user=USER SMTP user to connect as. Stub will only attempt to login if this field is non-empty. (Default ''). --smtp_password=PASSWORD Password for SMTP server. (Default '') --task_retry_seconds How long to wait in seconds before retrying a task after it fails during execution. (Default '30') --use_sqlite Use the new, SQLite based datastore stub. (Default false) --backends

USING THE SDK ======================= For instructions on getting started with Google App Engine, please see the Google App Engine Getting Started Guide

http://code.google.com/appengine/docs/gettingstarted USING THE APP ENGINE LAUNCHER ============================= The Windows and Mac OSX Python SDKs include an additional development tool called the App Engine Launcher. This tool provides a simple graphical interface to create projects, run them locally, and deploy them to Google's App Engine servers. It can be used in place of the dev_appserver and appcfg command-line tools. The Windows SDK can optionally install a desktop short-cut during installation. If you are missing the short-cut, you can find the launcher in the launcher subdirectory of your App Engine installation. The default location is C:\Program Files\Google\google_appengine\launcher\GoogleAppEngineLauncher.exe In Mac OSX, the Launcher is installed by dragging it out of the .dmg to a location specified by the user. The Launcher contains the SDK inside of it. A typical drag-install destination for the Launcher and SDK is /Applications/GoogleAppEngineLauncher.app