| <?xml version="1.0" encoding="UTF-8" ?> |
| <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" |
| "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> |
| <html xmlns="http://www.w3.org/1999/xhtml"> |
| <head> |
| <meta name="copyright" content="Copyright (c) 2012, 2022 EclipseSource. This page is made available under license. For full details see the LEGAL in the documentation book that contains this page."/> |
| <meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/> |
| <title>Installing a RAP Target</title> |
| <link rel="stylesheet" href="../../../PRODUCT_PLUGIN/book.css" type="text/css"/> |
| </head> |
| <body> |
| |
| <h1>Installing a RAP Target</h1> |
| |
| <p> |
| 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 <em>target platform</em>. |
| </p> |
| |
| <h2 id="target-install">Using the RAP Tools to install the latest target platform</h2> |
| <p> |
| On the Eclipse welcome screen (<em class="UILabel">Help > Welcome</em>), |
| go to <em class="UILabel">Overview > Remote Application Platform</em>. |
| Choose <em class="UILabel">Install Target Platform</em> on the following page. |
| In the upcoming dialog confirm the default values, which starts the target |
| installation process. |
| </p> |
| <p> |
| After the installation finished you are prepared to work with RAP. |
| For your first steps you may try out some <a href="examples.html">RAP Examples</a> |
| and/or write a <a href="hello-world.html">Hello World</a> Application. |
| </p> |
| |
| <h2>Alternative: Install Target Manually</h2> |
| <p> |
| 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 |
| (<em class="UILabel">Window > Preferences > Plug-in Development > Target Platform</em>) |
| or create a <em>target definition file</em>. |
| The latter is preferable, as target definition files can be checked in into your source code |
| repository and shared among team members. |
| </p> |
| <ol> |
| <li> |
| First, you may want to create a project to host your target definition files. |
| A plain project will do (<em class="UILabel">File > New > Project > General > |
| Project</em>). |
| </li> |
| <li> |
| In this new project, create a new target definition: |
| <em class="UILabel">File > New > Other > Plug-In Development > Target Definition</em>. |
| Chose a name like <em>rap-custom.target</em> and press <em class="UILabel">Finish</em>. |
| </li> |
| <li> |
| 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 <em class="UILabel">Add</em>, select <em class="UILabel">Software Site</em>. |
| Another dialog will show up, named <em class="UILabel">Add Software Site</em>. |
| </li> |
| <li> |
| Again press <em class="UILabel">Add</em> and enter the URL of the RAP repository. |
| You find these URLs on the RAP <a href="http://eclipse.org/rap/downloads/">download page</a>. |
| For RAP 3.1, the URL is <em>http://download.eclipse.org/rt/rap/3.1</em>. |
| You can also install RAP directly from a downloaded zip archive. |
| In this case, press <em class="UILabel">Archive…</em> and select the zip file. |
| </li> |
| <li> |
| Select the category <em>Remote Application Platform (RAP)</em>. |
| This category contains four features. |
| For a minimal RAP target, you'll need at least <em>RAP Runtime</em> and |
| <em>RAP Basic Target Requirements</em>. |
| If you want to include source code and demos, select all four features. |
| </li> |
| <li> |
| Activate the target platform by clicking the link |
| <em class="UILabel">Set as Target Platform</em> in the upper right corner of the target |
| definition editor. |
| </li> |
| </ol> |
| |
| </body> |
| </html> |