1

!"#$%&&'"( %"* +,""'"( $-. /00(&. 122 3"('".

4" 5'"*06#


This uocument uesciibes the installation of the uoogle App Engine Softwaie
Bevelopment Kit (SBK) on a Niciosoft Winuows anu iunning a simple "hello woilu"
application.

The App Engine SBK allows you to iun uoogle App Engine Applications on youi local
computei. It simulates the iun-time enviionment of the uoogle App Engine
infiastiuctuie.

78.9+.:,'#'$.#; 7<$-0" =>?>@

If you uon't alieauy have Python 2.S.4 installeu in youi computei, uownloau anu
Install Python 2.S.4 fiom:

http://www.python.org/download/releases/2.5.4/

A06"&0%* %"* !"#$%&&

You can uownloau the uoogle App Engine SBK by going to:

http://code.google.com/appengine/downloads.html

anu uownloau the appiopiiate install package.



Bownloau the Winuows installei - the simplest thing is to uownloau it to youi
Besktop oi anothei foluei that you iemembei.

2


Bouble Click on the /00(&.122&'B%$'0"3"('". installei.



Click thiough the installation wizaiu, anu it shoulu install the App Engine. If you uo
not have Python 2.S, it will install Python 2.S as well.

0nce the install is complete you can uiscaiu the uownloaueu installei




S
C%D'"( <0,8 E'8#$ 122&'B%$'0"

Now you neeu to cieate a simple application. We coulu use the "+" option to have
the launchei make us an application - but insteau we will uo it by hanu to get a
bettei sense of what is going on.

Nake a foluei foi youi uoogle App Engine applications. I am going to make the
Foluei on my Besktop calleu "%22#" - the path to this foluei is:

F;GA0B,H."$# %"* I.$$'"(#GB#.JGA.#D$02G%22#

Anu then make a sub-foluei in within %22# calleu "%.9KL9$8'J'%&" - the path to this
foluei woulu be:

F;G A0B,H."$# %"* I.$$'"(# GB#.JGA.#D$02G%22#G%.9KL9$8'J'%&

0sing a text euitoi such as }Euit (www.jeuit.oig), cieate a file calleu %22><%H& in the
%.9KL9$8'J'%& foluei with the following contents:

application: ae-01-trivial
version: 1
runtime: python
api_version: 1

handlers:
- url: /.*
script: index.py

M0$.; Please uo not copy anu paste these lines into youi text euitoi - you might enu
up with stiange chaiacteis - simply type them into youi euitoi.

Then cieate a file in the %.9KL9$8'J'%& foluei calleu '"*.N>2< with thiee lines in it:

print 'Content-Type: text/plain'
print ' '
print 'Hello there Chuck'

Then stait the /00(&.1223"('".O%,"B-.8 piogiam that can be founu unuei
122&'B%$'0"#. 0se the E'&. 9P 1** 3N'#$'"( 122&'B%$'0" commanu anu navigate
into the %22# uiiectoiy anu select the %.9KL9$8'J'%& foluei. 0nce you have auueu
the application, select it so that you can contiol the application using the launchei.

4


0nce you have selecteu youi application anu piess +,". Aftei a few moments youi
application will stait anu the launchei will show a little gieen icon next to youi
application. Then piess Q806#. to open a biowsei pointing at youi application
which is iunning at -$$2;RR&0B%&-0#$;SKSKR

Paste -$$2;RR&0B%&-0#$;SKSK into youi biowsei anu you shoulu see youi
application as follows:



}ust foi fun, euit the '"*.N>2< to change the name "Chuck" to youi own name anu
piess Refiesh in the biowsei to veiify youi upuates.

5%$B-'"( $-. O0(

You can watch the inteinal log of the actions that the web seivei is peifoiming when
you aie inteiacting with youi application in the biowsei. Select youi application in
the Launchei anu piess the O0(# button to biing up a log winuow:

S


Each time you piess +.T8.#- in youi biowsei - you can see it ietiieving the output
with a /3U iequest.

A.%&'"( 5'$- 38808#

With two files to euit, theie aie two geneial categoiies of eiiois that you may
encountei. If you make a mistake on the %22><%H& file, the App Engine will not stait
anu youi launchei will show a yellow icon neai youi application:



To get moie uetail on what is going wiong, take a look at the log foi the application:

6


In this instance - the mistake is mis-inuenting the last line in the %22><%H& (line 8).

If you make a syntax eiioi in the '"*.N>2< file, a Python tiace back eiioi will appeai
in youi biowsei.



The eiioi you neeu to see is likely to be the last few lines of the output - in this case
I maue a Python syntax eiioi on line one of oui one-line application.

Refeience: http:en.wikipeuia.oigwikiStack_tiace

When you make a mistake in the %22><%H& file - you must the fix the mistake anu
attempt to stait the application again.

7
If you make a mistake in a file like i"*.N>2<, you can simply fix the file anu piess
iefiesh in youi biowsei - theie is no neeu to iestait the seivei.

I-,$$'"( A06" $-. I.8J.8

To shut uown the seivei, use the Launchei, select youi application anu piess the
I$02 button.


This mateiials is Copyiight All Rights Reseiveu - Chailes Seveiance

Comments anu questions to csevumich.euu www.ui-chuck.com