Installing a RAP Target

By default, the Eclipse IDE compiles all projects in the workspace against the running
platform, which is the IDE itself.
But since RAP applications must be compiled against the RAP runtime, the workspace must be
configured to do so.
This is done by setting the RAP runtime as the target platform.

After the installation finished you are prepared to work with RAP.
For your first steps you may try out some RAP Examples
and/or write a Hello World Application.

Alternative: Install Target Manually

You can also install a target manually, e.g. if you want to develop against a different
version of RAP or combine RAP with other bundles.
To select a target platform you can either use the Target Platform preferences page
(Window > Preferences > Plug-in Development > Target Platform)
or create a target definition file.
The latter is preferable, as target definition files can be checked in into your source code
repository and shared among team members.

First, you may want to create a project to host your target definition files.
A plain project will do (File > New > Project > General >
Project).

In this new project, create a new target definition:
File > New > Other > Plug-In Development > Target Definition.
Chose a name like rap-custom.target and press Finish.

The target editor will open and show the contents of this target definition.
Now, you must add the RAP runtime from a p2 repository (a “software site”).
Press Add, select Software Site.
Another dialog will show up, named Add Software Site.

Again press Add and enter the URL of the RAP repository.
You find these URLs on the RAP download page.
For RAP 2.3, the URL is http://download.eclipse.org/rt/rap/2.3.
You can also install RAP directly from a downloaded zip archive.
In this case, press Archive… and select the zip file.

Select the category Remote Application Platform (RAP).
This category contains four features.
For a minimal RAP target, you'll need at least RAP Runtime and
RAP Basic Target Requirements.
If you want to include source code and demos, select all four features.

Activate the target platform by clicking the link
Set as Target Platform in the upper right corner of the target
definition editor.