Notice: This Wiki is now read only and edits are no longer possible. Please see: https://gitlab.eclipse.org/eclipsefdn/helpdesk/-/wikis/Wiki-shutdown-plan for the plan.
Riena/Getting Started
{{#eclipseproject:rt.riena}}
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 a target platform. Follow the steps outlined in either of the following two sections to set up the target platform for Riena applications (based on Riena 4.0.0). Windows users can just download the complete targetplatform, unzip it and activate it under Window => Preferences => Plugin Development => Target Platform.
Set up target platform for Riena apps
- Download Eclipse IDE 3.8.x for your platform and start with a blank workspace. Eclipse 3.x downloads
- Download the RienaSetup project and import it into your workspace.
- In the imported project, open the file "Riena_4.0.0.0-3x.target" and set the target Platform
- Open the "Plug-Ins" view and import "org.eclipse.riena.example.client" as source project.
- Select launch configuration "SWT ExampleApplication" and add required plug-ins, then Run it.
- Now explore the code and plugin.xml in the example 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 Indigo Repository: http://download.eclipse.org/eclipse/updates/3.8
- Uncheck "Group by Category" otherwise you can't see all 3 RCP Target 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 http://download.eclipse.org/rt/riena/4.0.0.0b/update
- 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:
- 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 Example Applications and Code Templates.
Set up target platform for Riena on RAP apps
For a Riena on RAP-based application to compile, a certain set of bundles (plug-ins) must be available at compile time. This set of bundles is known as a target platform. Follow the steps outlined in either of the following two sections to set up the target platform for Riena on RAP applications (based on Riena 3.0.0).
Setup
- Download Eclipse IDE 3.7.x for your platform and start with a blank workspace.
- Create a new target platform under Window => Preferences => Target Platform => Add => Nothing: Start with an empty target platform => Next
- Provide a name like Riena 3.0.0
- Click Add => Software Site
- Select the Indigo Repository: http://download.eclipse.org/releases/indigo/
- Uncheck "Group by Category" otherwise you can't see all 3 RCP Target Components.
- Uncheck "Include required software".
- Select "Equinox Target Components", "Rich Ajax Platform (RAP) Target Components"
- Go back to "Add => Software Site
- Select http://download.eclipse.org/rt/riena/3.0.0.0/rap/
- Select "Riena Target Components" from here: . The result should look like this:
- Activate the platform.
- Done.
Next Step
Now you are ready to start writing Riena applications (ensure that in such a launch configuration the bundle org.eclipse.riena.ui.swt.rap is selected as required bundle). To get a feeling of the Riena framework, take a look at Riena's Example Applications and Code Templates. Make sure that you click on "Add Required bundles" before you start any of the examples that come with Riena.
Set up Riena Toolbox
For more details about the Riena Toolbox, look here http://wiki.eclipse.org/Riena/Toolbox.
Build your own Riena-Targetplatform
Riena provides a tycho-build to build a targetplatform from cvs head. Follows these steps:
Prerequisites:
Start the build:
- Checkout the bundle org.eclipse.riena.build.tycho from cvs (:pserver:anonymous@dev.eclipse.org:/cvsroot/rt)
- Open a shell and go to the directory org.eclipse.riena.build.tycho
- Checkout the sources by executing: ant -f checkout.xml -DCHECKOUT_DIR=checkout -DTARGET_DIR=target
- Go to target/org.eclipse.riena.build.tycho
- 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.