Skip to main content
Jump to: navigation, search

Difference between revisions of "Riena/Getting Started"

m ( moved page Riena/GettingStarted to Riena/Getting Started: added space for better readability)
(20 intermediate revisions by the same user not shown)
Line 1: Line 1:
| __TOC__
For a Riena-based application to compile, a certain set of bundles (plug-ins) must be available at compile time. This set of bundles is known as [ target platform]. Follow the steps below to set up the target platform for Riena applications.
== Set up target platform for Riena apps ==
* Download [ Eclipse for RCP and RAP Developers] and start with a blank workspace.
* Download the [ RienaSetup] project and import it into your workspace.
* In the imported project, open the file "" and set the target platform. If you want to use Riena on an Eclipse 3.x or [[RAP]] basis, select the appropriate target platform.
* Open the "Plug-Ins" view and import as source project:
** org.eclipse.riena.example.client
** org.eclipse.riena.sample.snippets (not relevant for Riena on RAP)
* In the project "RienaSetup", select the launch configuration "SWT ExampleApplication E4" and add required plug-ins, then Run it. For Riena on 3.x or RAP, use the appropriate launch configuration.
* Now explore the code and plugin.xml in the example project
* Some specific techniques are demonstrated in the snippets project.
== Manual target platform setup ==
* Download Eclipse IDE 3.8.x for your platform and start with a blank workspace. [ Eclipse 3.x downloads]
* Create a new target platform under Window => Preferences => Target Platform => Add => Nothing: Start with an empty target platform => Next
* Provide a name like Riena 4.0.0
* Click Add => Software Site
* Select the repository:
* Uncheck "Group by Category" otherwise you can't see all components.
* Uncheck "Include required software" and select following components:
** Eclipse RCP
** Eclipse RCP Plug-in Developer Resources
** Eclipse RCP SDK
** Equinox Target Components
* Go back to Add => Software Site
* Select
* Uncheck "Group by Category" and select following components:
** Riena Core Target Components
** Riena Target Components
** Riena Samples Target Components
The result should look like this:
[[Image:Riena Targetplatform RCP.png]]
* Activate the platform.
* Done.
'''Next Step'''
Now you are ready to start writing Riena applications. To get a feeling of the Riena framework, take a look at Riena's [[Riena Example Applications and Code Templates|Example Applications and Code Templates]].
== Set up Riena Toolbox  ==
For more details about the Riena Toolbox, look here
==Build your own Riena-Targetplatform==
Riena provides a tycho-build to build a targetplatform from cvs head. Follows these steps:
* Install  [ ant]
* Install  [ maven 3]
'''Start the build:'''
* Checkout the bundle from cvs (
* Open a shell and go to the directory
* Checkout the sources by executing: ant -f checkout.xml -DCHECKOUT_DIR=checkout -DTARGET_DIR=target
* Go to target/
* Execute: mvn clean install -P all-modules -Dmaven.test.skip=true
At the moment Tycho can't handle the package import to javax.servlet, so we had to replace this with a dependencie. We accomplished this by patching the MANIFEST.MF from the bundle org.eclipse.communication.core after the checkout.
There may be other issues with the result of this build or the buildprocess itself, so be aware that this is not yet production ready.
{{Riena/Setting up the IDE}}

Latest revision as of 13:21, 27 November 2014

Setting up the IDE

  • Install a Eclipse for Commiters. Download from Eclipse

Clone with SSH

  • Generate a new SSH-Key pair.
  • Go to your github account and paste your key there.
  • Goto Window->Preferences->...->SSH2 and add your private key there
  • Clone the Riena
  • Clone the Riena

Clone with HTTPS

Next Step

Next you need to install the Riena runtime. This is done by setting Riena as the Target Platform. The Target Platform is the foundation for your Riena based application.

Back to the top