App Engine has an excellent site with online documentation and tutorials. Before coming to the boot camp, you will need to go online to download and install the software you will need on your laptop to do App Engine development. Unfortunately, several of these downloads are large and installation programs can take quite some time.
Allow several hours to complete these Setup Instructions
Be Sure to do this BEFORE coming to the Boot Camp.
Note: I've tested and written these instructions for Windows. I believe they work and apply equally for Macinstosh installations - let me know if you run into significant differences, and I'll document them here.
- Sign up for an App Engine Account - https://appengine.google.com/
I recommend you use a gmail account rather than another Google Apps for domains account - I've had some problems when using the latter.
- Install Python if you don't have it on your machine already.
I recommend getting 2.6.4. Google documents that 2.5.2 is the version of python used on the hosted platform, but I've found that some of the tools they provide DON'T WORK with 2.5.2 on the local machine (due to older SSL library)! The differences between 2.5 and 2.6 are minor - with some libraries having some differences. But in practice, I don't think you'll run into incompatibilities.
- Add ";c:\Python26;c:\Python26\Scripts" to your PATH variable
- Add ";.PY;.PYW" to your PATHEXT environment variable
- Install SetupTools and
(you can skip this step if you want to download Django directly from the link below)
- Install Django 1.1:
> easy_install django
- Download Django 1.1 tarball
- Unpack to \src\django-1.1
- c:\src\django-1.1> setup install
- Install the App Engine SDK for Python
- Install PIL - Simple Imaging Library (optional)
Only needed if you plan on doing on-server image manipulation (e.g., thumbnailing)
- Install the Eclipse IDE
- Install Java Runtime
- Download "Eclipse IDE for Java Developers"
- Unzip to c:\Program Files\eclipse
- Create desktop shortcut to c:\Program Files\eclipse\eclipse.exe
- Configure Eclipse
- Run Eclipse
- Install PyDev
- Help/Install New Software
- Enter http://pydev.org/
Check the PyDev box
Click Next Twice
Accept license and Finish (restart Eclipse if prompted)
- Select New...
- Enter "Python26" and "c:\Python26\python.exe"
- Find more detailed instructions here (but for an older Eclipse version)
- Install Web Tools (optional, but nice to have)
- Help/Install New Software
- Install Mercurial Source Control Client - http://mercurial.selenic.com/
- Checkout/Clone the source code for the tutorials to your c:\src\aebootcamp:
Once these steps are complete - you should be able to run a local (development server) version of App Engine. To test your installation, go to Hello WebApp