Preparation by participants

In order to get started quickly on the day of the course, we kindly ask you to make sure you have the following things in place:

A. You have a Google Account

B. You have a Google AppEngine Account

C. You have Eclipse installed on your laptop (* see below)

D. You have the Google Eclipse Plugin installed (* see below)

(*) We ask that participants bring laptops to the course.  You will be working in pairs throughout the course.

We ask that you to install the software that is required to work through this course so you can easily continue working on it after the workshop. See below for details.

Here are the four things you need to set up:

A. Create a Google Account

If you don’t already have a Google account (e.g. a Gmail account), please make sure that you create one. You need one in order to set up an AppEngine account.

There are two ways of getting a Google account: Either create an account based on one of your existing e-mail addresses or create a Google Gmail account. The following explains how you can do either of these:

Create an account based on an existing e-mail address

For this you can use any existing e-mail address you already have. Just to go this site and follow the instructions:

Create a Gmail account

The second option is to create a Gmail account, which you can also directly use as a Google Account. For this just visit this site and follow the instructions:

B. Set Up Your Google AppEngine Account

In the course you will work with Google AppEngine. For this you need to set up your Google account to be ready to use with AppEngine. AppEngine requires you to verify yourself by sending you an SMS. To do this, go the the AppEngine site:

If you are not yet logged in with your Google account, you will be asked to do so. If this is the first time you use AppEngine, you will be greeted with the following message:
Please click the “Create an Application” button and you will be shown the SMS verification page:

Here we need you to enter your cell phone number to which an activation code is sent. Your number will not be used for anything else and is just used to verify your account. You need to do this only once. Afterwards you can create up to 10 AppEngine apps with your accounts for free.

C. Install Eclipse On Your Laptop

Next we need you to install the most recent version of Eclipse on your Laptop. We know that you might have another favourite IDE  and in theory you can do all the exercises with other IDEs as well.  But, as we will later install some Eclipse specific plugins that will make your life a lot easier, we would like you to have Eclipse ready for the course so everybody has the same environment. We recommend you install the J2EE edition, as it includes some features that can be helpful when doing web development, like HTML/CSS/JavaScript editors, that are not present in the standard version. Here are the different download sites, depending on the Operating system of your laptop:

When you download Eclipse you get an archive than you just need to extract. You will end up with a directory called eclipse in which you will find the whole application. It doesn’t matter much where you put it. On Windows e.g. you could put it into you C:\Program Files\ directory.

In order to run Eclipse, simply start the executable inside the eclipse directory. On Windows this is eclipse.exe, on OSX it’s just called Eclipse and on Linux eclipse. You can create a shortcut on your desktop or your start menu in order to avoid searching for it in the future. On OSX, when you run Eclipse, you can right click on the application icon and select “Keep in dock”.

D. Install the Google Eclipse plugin

Now that you have Eclipse installed, there is only one more thing to do: Install the Google Eclipse plugin. This plugin will allow you to easily deal with the Google Web Toolkit and Google AppEngine projects and they already contain the SDKs for both. To install it, go to this site and follow the instructions:  
Although the instructions shown are from a Mac, they should be similar or equal to what you would see on a Windows or Linux machine.

Once you restarted Eclipse after the installation you should see the following icons in the Eclipse toolbar that show you that you have installed the plugin correctly:

The plugin should have also downloaded both the Google Web Toolkit and AppEngine SDK, so you are all set now!

If you want to confirm that everything is set up properly now, follow the instructions on this site to set up a small project:

You can skip the “Install the Plugin” part and go directly to “Create a Web Application”. There you will create a small “Hello World” style app (it’s actually created automatically for you). It shows you how to start a development server on your machine quickly and how you can test the application in the browser. The first time you do this you will also be asked to download and install the development plugin, so you can debug your web app inside Eclipse.

Thanks for doing all the preparation to help us concentrate on the most important things during the workshop!