https://wiki.eclipse.org/api.php?action=feedcontributions&user=Fabian.seiberling.compeople.de&feedformat=atomEclipsepedia - User contributions [en]2024-03-28T23:59:29ZUser contributionsMediaWiki 1.26.4https://wiki.eclipse.org/index.php?title=Template:Riena/Setting_up_the_IDE&diff=375244Template:Riena/Setting up the IDE2014-12-16T09:25:46Z<p>Fabian.seiberling.compeople.de: /* Riena Toolbox */</p>
<hr />
<div>== Setting up the IDE ==<br />
To get started with Riena, it's recommended to set up Eclipse with the Riena Toolbox installed.<br />
<br />
=== Eclipse ===<br />
Download [https://eclipse.org/downloads/packages/eclipse-rcp-and-rap-developers/lunar Eclipse for RCP and RAP Developers] and start with a blank workspace.<br />
<br />
=== Riena Toolbox ===<br />
Start Eclipse and install the Riena Toolbox:<br />
* Open the Eclipse Install dialog from the main menu (''Help'' > ''Install New Software...'').<br />
* Select all components from http://download.eclipse.org/rt/riena/toolbox/20120424<br />
** '''IMPORTANT''': Uncheck "Contact all update sites during install to find required software"<br />
* Complete the installation (Eclipse will ask you to restart)<br />
<br />
== Next Step ==<br />
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.<br />
*[[Riena/Target Platform|Installing the Target Platform based on Eclipse 4.x (standard)]]<br />
*[[Riena/Target Platform 3x|Installing the Target Platform based on Eclipse 3.x]]<br />
*[[Riena/Target Platform RAP|Installing the Target Platform based on RAP (web)]]<br />
<br />
Note: The Target Platform version is not related to the IDE version you are using.</div>Fabian.seiberling.compeople.dehttps://wiki.eclipse.org/index.php?title=Riena/Examples&diff=375066Riena/Examples2014-12-12T10:08:08Z<p>Fabian.seiberling.compeople.de: Added RAP (Example & Mail Client)</p>
<hr />
<div>{{#eclipseproject:rt.riena}}<br />
<br />
{| <br />
| __TOC__<br />
|}<br />
<br />
== Try the Riena Snippets ==<br />
The [[Riena_Snippets|Riena Snippets]] page contains a growing collection of self-contained code examples that show you how to use '''ridgets''' ("Riena widgets") and what you can do with them. For a description what Ridgets are, look here http://wiki.eclipse.org/Riena/Custom_Ridgets<br />
<br />
<br />
== Try the communication ping pong example ==<br />
# Import the 4 plugins <tt>*.communication.sample.pingpong.*</tt> from the target platform. (See [[#Import a Riena plugin]])<br />
# In the Run Dialog you can select which of the two components to run (under 'OSGi Framework').<br />
#* Select the Bundles <tt>org.eclipse.equinox.console</tt> and <tt>org.apache.felix.gogo.shell</tt> and press the 'Add required Bundles' button for both of them before you start them!<br />
## First, start the '''Riena Sample PingPong Server'''.<br />
##* The server starts on port 8080, make sure it's not taken.<br />
## Then start the '''Riena Sample PingPong Client'''.<br />
# On success your client will print a message on the console: <tt>PingPong::Client:: [Pong] says = Thx. I got the ping!</tt><br />
# Switch to the server console; it should show a message like this: <tt>PingPong::Server:: [Ping] says = I ping you and you pong me</tt><br />
<br />
<div id="Import a Riena plugin"><br />
{{warning2|text= Import a Riena plugin'''<br />
# File -> Import -> Plug-in Development -> Plug-ins and Fragments -> Next.<br />
# Select "Projects with source folders" under "Import As" (since it's more fun with source code) -> Next.<br />
# In the "Plug-ins and Fragments Found" Listbox, select the requested plugins and click Add and then Finish.}}<br />
</div><br />
<br />
== Try the unit tests ==<br />
# Import the project <tt>org.eclipse.riena.tests</tt> from the target platform. (See [[#Import a Riena plugin]])<br />
# There are classes like <tt>AllTests</tt> on various levels that you can run as Junit Plugin Tests.<br />
# You can also run individual tests as JUnit Plugin Tests.<br />
<br />
; Currently there are more than 3000 tests<br />
: They should all work. Some of them fail if you click or move the mouse while the tests are running (e.g. focus or UI tests).<br />
; Launch Error on starting tests<br />
: This sometimes happens when you launch a test as JUnit Plugin Test for the first time. => You will need to modify the launch configuration for this class:<br />
:# In the "Main" tab, change the field "Run an application" to "[No Application] - Headless Mode".<br />
:# In the "Plug-ins" tab:<br />
:## Launch with: choose "plug-ins selected below only".<br />
:## "Deselect All"<br />
:## Check/select the bundle containing the test you want to run.<br />
:## "Add Required Plug-ins"<br />
:# Apply. Run.<br />
; Classes ending with <tt>*ITest</tt> require a server.<br />
: That's the Riena App Sample Server (explained in the next step).<br />
<br />
== Install the Riena Sample App Server ==<br />
Simple server with customer search web service:<br />
# Stop any previously started client or server.<br />
# Import the 4 projects <tt>org.eclipse.riena.sample.app.server</tt>, <tt>org.eclipse.riena.sample.app.common</tt>, <tt>org.eclipse.riena.security.services</tt> and <tt>org.eclipse.riena.security.simpleservices</tt> from the target platform. (See [[#Import a Riena plugin]])<br />
# Start '''Riena App Server''' from the Run Dialog:<br />
#* Select the Bundles <tt>org.eclipse.equinox.console</tt> and <tt>org.apache.felix.gogo.shell</tt> and press the 'Add required Bundles' button before you start it!<br />
#* This server starts on port 8080, make sure that port is not taken.<br />
# That should bring up a simple app server with a secured customer search web service.<br />
<br />
== Run the Riena Example Client ==<br />
# Import the project <tt>org.eclipse.riena.example.client</tt> from the target platform. (See [[#Import a Riena plugin]])<br />
# In the "Run Dialog -> Eclipse Application", there are five new entries. Depending on the target platform you have to select the right run configuration.<br />
## For the target platform '''3.x''':<br />
### Select the '''SWT ExampleApplication''' or '''SWT ExampleApplication (with alternative LnF)''' configuration.<br />
### Add the plug-ins <tt>org.eclipse.riena.navigation.ui.swt.rcp</tt> and <tt>org.eclipse.riena.ui.swt.3x</tt> and press the 'Add required Plug-ins' button before you start them!<br />
###* Both launchers start the same application based on the same code, but using two distinct Riena Themes (different colors, fonts etc.).<br />
## For the target platform '''4.x''':<br />
### Select the '''SWT ExampleApplication E4'''<br />
### Add the plug-ins <tt>org.eclipse.riena.navigation.ui.swt.rcp</tt> and <tt>org.eclipse.riena.ui.swt.e4</tt> and press the 'Add required Plug-ins' button before you start it!<br />
## For the target platform '''RAP''':<br />
### Open the plugin.xml in the root folder of the project.<br />
### Comment in the extension for RAP at the end of the file. (Line 1721 - 1726)<br />
### Run the '''Riena Example Client on RAP''' launcher.<br />
<br />
== Run the Riena Example Mail Client ==<br />
# Import the project <tt>org.eclipse.riena.sample.app.client.mail</tt> from the target platform. (See [[#Import a Riena plugin]])<br />
# Start '''Mail Sample (Riena UI)''' from the Run Dialog:<br />
## For the target platform '''3.x''':<br />
### Select at the Main tab <tt>Run an application</tt> and '''org.eclipse.riena.sample.app.client.mail.mailapp'''<br />
### Add the plug-ins <tt>org.eclipse.riena.navigation.ui.swt.rcp</tt> and <tt>org.eclipse.riena.ui.swt.3x</tt> and press the 'Add required Plug-ins' button before you start them!<br />
## For the target platform '''4.x''':<br />
### Coming soon<br />
## For the target platform '''RAP''':<br />
### Open the plugin.xml in the root folder of the project.<br />
### Add the extension: <code> <extension point="org.eclipse.rap.ui.entrypoint"> <entrypoint id="example.application.entrypoint" applicationId="org.eclipse.riena.sample.app.client.mail.mailapp" path="/rap" /> </extension> </code><br />
### Select the '''RAP Mail Sample (Riena UI)'''<br />
### Add the bundles <tt>org.eclipse.riena.navigation.ui.swt.rap</tt> and <tt>org.eclipse.riena.ui.swt.rap</tt> and press the 'Add required Plug-ins' button before you start it!<br />
<br />
== Run the Riena Demo ==<br />
# Import the 4 projects <tt>org.eclipse.riena.demo.*</tt> from the target platform. (See [[#Import a Riena plugin]])<br />
# Select the '''Riena Demo Server''' launcher<br />
# Add the Bundles <tt>org.eclipse.equinox.console</tt> and <tt>org.apache.felix.gogo.shell</tt> and press the 'Add required Plug-ins' button before you start them!<br />
# Select the '''Riena Demo Client''' launcher<br />
## For the target platform '''3.x''':<br />
### Select at the Main tab <tt>Run an application</tt> and '''org.eclipse.riena.demo.client.application'''<br />
### Add the plug-ins <tt>org.eclipse.riena.navigation.ui.swt.rcp</tt> and <tt>org.eclipse.riena.ui.swt.3x</tt> and press the 'Add required Plug-ins' button before you start them!<br />
## For the target platform '''4.x''':<br />
### Select at the Main tab <tt>Run a product</tt> and '''org.eclipse.riena.e4.launcher.product'''<br />
### Add the plug-ins <tt>org.eclipse.riena.navigation.ui.swt.rcp</tt> and <tt>org.eclipse.riena.ui.swt.e4</tt> and press the 'Add required Plug-ins' button before you start them!<br />
###* The missing icons will throw some Exceptions<br />
<br />
<br />
== Next Step ==<br />
Get started with the [[Riena/BaseConcepts|Base concepts of Riena]].</div>Fabian.seiberling.compeople.dehttps://wiki.eclipse.org/index.php?title=Riena/Examples&diff=375006Riena/Examples2014-12-11T15:28:43Z<p>Fabian.seiberling.compeople.de: Changed anchors '' to "</p>
<hr />
<div>{{#eclipseproject:rt.riena}}<br />
<br />
{| <br />
| __TOC__<br />
|}<br />
<br />
== Try the Riena Snippets ==<br />
The [[Riena_Snippets|Riena Snippets]] page contains a growing collection of self-contained code examples that show you how to use '''ridgets''' ("Riena widgets") and what you can do with them. For a description what Ridgets are, look here http://wiki.eclipse.org/Riena/Custom_Ridgets<br />
<br />
<br />
== Try the communication ping pong example ==<br />
# Import the 4 plugins <tt>*.communication.sample.pingpong.*</tt> from the target platform. (See [[#Import a Riena plugin]])<br />
# In the Run Dialog you can select which of the two components to run (under 'OSGi Framework').<br />
#* Select the Bundles <tt>org.eclipse.equinox.console</tt> and <tt>org.apache.felix.gogo.shell</tt> and press the 'Add required Bundles' button for both of them before you start them!<br />
## First, start the '''Riena Sample PingPong Server'''.<br />
##* The server starts on port 8080, make sure it's not taken.<br />
## Then start the '''Riena Sample PingPong Client'''.<br />
# On success your client will print a message on the console: <tt>PingPong::Client:: [Pong] says = Thx. I got the ping!</tt><br />
# Switch to the server console; it should show a message like this: <tt>PingPong::Server:: [Ping] says = I ping you and you pong me</tt><br />
<br />
<div id="Import a Riena plugin"><br />
{{warning2|text= Import a Riena plugin'''<br />
# File -> Import -> Plug-in Development -> Plug-ins and Fragments -> Next.<br />
# Select "Projects with source folders" under "Import As" (since it's more fun with source code) -> Next.<br />
# In the "Plug-ins and Fragments Found" Listbox, select the requested plugins and click Add and then Finish.}}<br />
</div><br />
<br />
== Try the unit tests ==<br />
# Import the project <tt>org.eclipse.riena.tests</tt> from the target platform. (See [[#Import a Riena plugin]])<br />
# There are classes like <tt>AllTests</tt> on various levels that you can run as Junit Plugin Tests.<br />
# You can also run individual tests as JUnit Plugin Tests.<br />
<br />
; Currently there are more than 3000 tests<br />
: They should all work. Some of them fail if you click or move the mouse while the tests are running (e.g. focus or UI tests).<br />
; Launch Error on starting tests<br />
: This sometimes happens when you launch a test as JUnit Plugin Test for the first time. => You will need to modify the launch configuration for this class:<br />
:# In the "Main" tab, change the field "Run an application" to "[No Application] - Headless Mode".<br />
:# In the "Plug-ins" tab:<br />
:## Launch with: choose "plug-ins selected below only".<br />
:## "Deselect All"<br />
:## Check/select the bundle containing the test you want to run.<br />
:## "Add Required Plug-ins"<br />
:# Apply. Run.<br />
; Classes ending with <tt>*ITest</tt> require a server.<br />
: That's the Riena App Sample Server (explained in the next step).<br />
<br />
== Install the Riena Sample App Server ==<br />
Simple server with customer search web service:<br />
# Stop any previously started client or server.<br />
# Import the 4 projects <tt>org.eclipse.riena.sample.app.server</tt>, <tt>org.eclipse.riena.sample.app.common</tt>, <tt>org.eclipse.riena.security.services</tt> and <tt>org.eclipse.riena.security.simpleservices</tt> from the target platform. (See [[#Import a Riena plugin]])<br />
# Start '''Riena App Server''' from the Run Dialog:<br />
#* Select the Bundles <tt>org.eclipse.equinox.console</tt> and <tt>org.apache.felix.gogo.shell</tt> and press the 'Add required Bundles' button before you start it!<br />
#* This server starts on port 8080, make sure that port is not taken.<br />
# That should bring up a simple app server with a secured customer search web service.<br />
<br />
== Run the Riena Example Client ==<br />
# Import the project <tt>org.eclipse.riena.example.client</tt> from the target platform. (See [[#Import a Riena plugin]])<br />
# In the "Run Dialog -> Eclipse Application", there are five new entries. Depending on the target platform you have to select the right run configuration.<br />
## For the target platform '''3.x''':<br />
### Select the '''SWT ExampleApplication''' or '''SWT ExampleApplication (with alternative LnF)''' configuration.<br />
### Add the plug-ins <tt>org.eclipse.riena.navigation.ui.swt.rcp</tt> and <tt>org.eclipse.riena.ui.swt.3x</tt> and press the 'Add required Plug-ins' button before you start them!<br />
###* Both launchers start the same application based on the same code, but using two distinct Riena Themes (different colors, fonts etc.).<br />
## For the target platform '''4.x''':<br />
### Select the '''SWT ExampleApplication E4'''<br />
### Add the plug-ins <tt>org.eclipse.riena.navigation.ui.swt.rcp</tt> and <tt>org.eclipse.riena.ui.swt.e4</tt> and press the 'Add required Plug-ins' button before you start it!<br />
<br />
== Run the Riena Example Mail Client ==<br />
# Import the project <tt>org.eclipse.riena.sample.app.client.mail</tt> from the target platform. (See [[#Import a Riena plugin]])<br />
# Start '''Mail Sample (Riena UI)''' from the Run Dialog:<br />
## For the target platform '''3.x''':<br />
### Select at the Main tab <tt>Run an application</tt> and '''org.eclipse.riena.sample.app.client.mail.mailapp'''<br />
### Add the plug-ins <tt>org.eclipse.riena.navigation.ui.swt.rcp</tt> and <tt>org.eclipse.riena.ui.swt.3x</tt> and press the 'Add required Plug-ins' button before you start them!<br />
## For the target platform '''4.x''':<br />
### Coming soon<br />
<br />
== Run the Riena Demo ==<br />
# Import the 4 projects <tt>org.eclipse.riena.demo.*</tt> from the target platform. (See [[#Import a Riena plugin]])<br />
# Select the '''Riena Demo Server''' launcher<br />
# Add the Bundles <tt>org.eclipse.equinox.console</tt> and <tt>org.apache.felix.gogo.shell</tt> and press the 'Add required Plug-ins' button before you start them!<br />
# Select the '''Riena Demo Client''' launcher<br />
## For the target platform '''3.x''':<br />
### Select at the Main tab <tt>Run an application</tt> and '''org.eclipse.riena.demo.client.application'''<br />
### Add the plug-ins <tt>org.eclipse.riena.navigation.ui.swt.rcp</tt> and <tt>org.eclipse.riena.ui.swt.3x</tt> and press the 'Add required Plug-ins' button before you start them!<br />
## For the target platform '''4.x''':<br />
### Select at the Main tab <tt>Run a product</tt> and '''org.eclipse.riena.e4.launcher.product'''<br />
### Add the plug-ins <tt>org.eclipse.riena.navigation.ui.swt.rcp</tt> and <tt>org.eclipse.riena.ui.swt.e4</tt> and press the 'Add required Plug-ins' button before you start them!<br />
###* The missing icons will throw some Exceptions<br />
<br />
<br />
== Next Step ==<br />
Get started with the [[Riena/BaseConcepts|Base concepts of Riena]].</div>Fabian.seiberling.compeople.dehttps://wiki.eclipse.org/index.php?title=Riena/Examples&diff=375005Riena/Examples2014-12-11T15:24:23Z<p>Fabian.seiberling.compeople.de: </p>
<hr />
<div>{{#eclipseproject:rt.riena}}<br />
<br />
{| <br />
| __TOC__<br />
|}<br />
<br />
== Try the Riena Snippets ==<br />
The [[Riena_Snippets|Riena Snippets]] page contains a growing collection of self-contained code examples that show you how to use '''ridgets''' ("Riena widgets") and what you can do with them. For a description what Ridgets are, look here http://wiki.eclipse.org/Riena/Custom_Ridgets<br />
<br />
<br />
== Try the communication ping pong example ==<br />
# Import the 4 plugins <tt>*.communication.sample.pingpong.*</tt> from the target platform. (See [[#Import a Riena plugin]])<br />
# In the Run Dialog you can select which of the two components to run (under 'OSGi Framework').<br />
#* Select the Bundles <tt>org.eclipse.equinox.console</tt> and <tt>org.apache.felix.gogo.shell</tt> and press the 'Add required Bundles' button for both of them before you start them!<br />
## First, start the '''Riena Sample PingPong Server'''.<br />
##* The server starts on port 8080, make sure it's not taken.<br />
## Then start the '''Riena Sample PingPong Client'''.<br />
# On success your client will print a message on the console: <tt>PingPong::Client:: [Pong] says = Thx. I got the ping!</tt><br />
# Switch to the server console; it should show a message like this: <tt>PingPong::Server:: [Ping] says = I ping you and you pong me</tt><br />
<br />
<div id="'Import a Riena plugin"></div><br />
{{warning2|text= Import a Riena plugin'''<br />
# File -> Import -> Plug-in Development -> Plug-ins and Fragments -> Next.<br />
# Select "Projects with source folders" under "Import As" (since it's more fun with source code) -> Next.<br />
# In the "Plug-ins and Fragments Found" Listbox, select the requested plugins and click Add and then Finish.}}<br />
<br />
<br />
== Try the unit tests ==<br />
# Import the project <tt>org.eclipse.riena.tests</tt> from the target platform. (See [[#Import a Riena plugin]])<br />
# There are classes like <tt>AllTests</tt> on various levels that you can run as Junit Plugin Tests.<br />
# You can also run individual tests as JUnit Plugin Tests.<br />
<br />
; Currently there are more than 3000 tests<br />
: They should all work. Some of them fail if you click or move the mouse while the tests are running (e.g. focus or UI tests).<br />
; Launch Error on starting tests<br />
: This sometimes happens when you launch a test as JUnit Plugin Test for the first time. => You will need to modify the launch configuration for this class:<br />
:# In the "Main" tab, change the field "Run an application" to "[No Application] - Headless Mode".<br />
:# In the "Plug-ins" tab:<br />
:## Launch with: choose "plug-ins selected below only".<br />
:## "Deselect All"<br />
:## Check/select the bundle containing the test you want to run.<br />
:## "Add Required Plug-ins"<br />
:# Apply. Run.<br />
; Classes ending with <tt>*ITest</tt> require a server.<br />
: That's the Riena App Sample Server (explained in the next step).<br />
<br />
== Install the Riena Sample App Server ==<br />
Simple server with customer search web service:<br />
# Stop any previously started client or server.<br />
# Import the 4 projects <tt>org.eclipse.riena.sample.app.server</tt>, <tt>org.eclipse.riena.sample.app.common</tt>, <tt>org.eclipse.riena.security.services</tt> and <tt>org.eclipse.riena.security.simpleservices</tt> from the target platform. (See [[#Import a Riena plugin]])<br />
# Start '''Riena App Server''' from the Run Dialog:<br />
#* Select the Bundles <tt>org.eclipse.equinox.console</tt> and <tt>org.apache.felix.gogo.shell</tt> and press the 'Add required Bundles' button before you start it!<br />
#* This server starts on port 8080, make sure that port is not taken.<br />
# That should bring up a simple app server with a secured customer search web service.<br />
<br />
== Run the Riena Example Client ==<br />
# Import the project <tt>org.eclipse.riena.example.client</tt> from the target platform. (See [[#Import a Riena plugin]])<br />
# In the "Run Dialog -> Eclipse Application", there are five new entries. Depending on the target platform you have to select the right run configuration.<br />
## For the target platform '''3.x''':<br />
### Select the '''SWT ExampleApplication''' or '''SWT ExampleApplication (with alternative LnF)''' configuration.<br />
### Add the plug-ins <tt>org.eclipse.riena.navigation.ui.swt.rcp</tt> and <tt>org.eclipse.riena.ui.swt.3x</tt> and press the 'Add required Plug-ins' button before you start them!<br />
###* Both launchers start the same application based on the same code, but using two distinct Riena Themes (different colors, fonts etc.).<br />
## For the target platform '''4.x''':<br />
### Select the '''SWT ExampleApplication E4'''<br />
### Add the plug-ins <tt>org.eclipse.riena.navigation.ui.swt.rcp</tt> and <tt>org.eclipse.riena.ui.swt.e4</tt> and press the 'Add required Plug-ins' button before you start it!<br />
<br />
== Run the Riena Example Mail Client ==<br />
# Import the project <tt>org.eclipse.riena.sample.app.client.mail</tt> from the target platform. (See [[#Import a Riena plugin]])<br />
# Start '''Mail Sample (Riena UI)''' from the Run Dialog:<br />
## For the target platform '''3.x''':<br />
### Select at the Main tab <tt>Run an application</tt> and '''org.eclipse.riena.sample.app.client.mail.mailapp'''<br />
### Add the plug-ins <tt>org.eclipse.riena.navigation.ui.swt.rcp</tt> and <tt>org.eclipse.riena.ui.swt.3x</tt> and press the 'Add required Plug-ins' button before you start them!<br />
## For the target platform '''4.x''':<br />
### Coming soon<br />
<br />
== Run the Riena Demo ==<br />
# Import the 4 projects <tt>org.eclipse.riena.demo.*</tt> from the target platform. (See [[#Import a Riena plugin]])<br />
# Select the '''Riena Demo Server''' launcher<br />
# Add the Bundles <tt>org.eclipse.equinox.console</tt> and <tt>org.apache.felix.gogo.shell</tt> and press the 'Add required Plug-ins' button before you start them!<br />
# Select the '''Riena Demo Client''' launcher<br />
## For the target platform '''3.x''':<br />
### Select at the Main tab <tt>Run an application</tt> and '''org.eclipse.riena.demo.client.application'''<br />
### Add the plug-ins <tt>org.eclipse.riena.navigation.ui.swt.rcp</tt> and <tt>org.eclipse.riena.ui.swt.3x</tt> and press the 'Add required Plug-ins' button before you start them!<br />
## For the target platform '''4.x''':<br />
### Select at the Main tab <tt>Run a product</tt> and '''org.eclipse.riena.e4.launcher.product'''<br />
### Add the plug-ins <tt>org.eclipse.riena.navigation.ui.swt.rcp</tt> and <tt>org.eclipse.riena.ui.swt.e4</tt> and press the 'Add required Plug-ins' button before you start them!<br />
###* The missing icons will throw some Exceptions<br />
<br />
<br />
== Next Step ==<br />
Get started with the [[Riena/BaseConcepts|Base concepts of Riena]].</div>Fabian.seiberling.compeople.dehttps://wiki.eclipse.org/index.php?title=Riena/Examples&diff=375002Riena/Examples2014-12-11T14:53:09Z<p>Fabian.seiberling.compeople.de: </p>
<hr />
<div>{{#eclipseproject:rt.riena}}<br />
<br />
{| <br />
| __TOC__<br />
|}<br />
<br />
== Try the Riena Snippets ==<br />
The [[Riena_Snippets|Riena Snippets]] page contains a growing collection of self-contained code examples that show you how to use '''ridgets''' ("Riena widgets") and what you can do with them. For a description what Ridgets are, look here http://wiki.eclipse.org/Riena/Custom_Ridgets<br />
<br />
== Import a Riena plugin ==<br />
# File -> Import -> Plug-in Development -> Plug-ins and Fragments -> Next.<br />
# Select "Projects with source folders" under "Import As" (since it's more fun with source code) -> Next.<br />
# In the "Plug-ins and Fragments Found" Listbox, select the requested plugins and click Add and then Finish.<br />
<br />
== Try the communication ping pong example ==<br />
# Import the 4 plugins <tt>*.communication.sample.pingpong.*</tt> from the target platform. (See [[#Import a Riena plugin]])<br />
# In the Run Dialog, under <tt>OSGi Framework</tt>, you can select which of the two components to run.<br />
#* '''Riena Sample PingPong Client'''<br />
#* '''Riena Sample PingPong Server'''<br />
# Select the Bundles <tt>org.eclipse.equinox.console</tt> and <tt>org.apache.felix.gogo.shell</tt> and press the 'Add required Bundles' button for both of them before you start them!<br />
## First, start the '''Riena Sample PingPong Server'''.<br />
##* The server starts on port 8080, make sure it's not taken.<br />
## Then start the '''Riena Sample PingPong Client'''.<br />
# On success your client will print a message on the console: <tt>PingPong::Client:: [Pong] says = Thx. I got the ping!</tt><br />
# Switch to the server console; it should show a message like this: <tt>PingPong::Server:: [Ping] says = I ping you and you pong me</tt><br />
<br />
== Try the unit tests ==<br />
# Import the project <tt>org.eclipse.riena.tests</tt> from the target platform. (See [[#Import a Riena plugin]])<br />
# There are classes like <tt>AllTests</tt> on various levels that you can run as Junit Plugin Tests.<br />
# You can also run individual tests as JUnit Plugin Tests.<br />
<br />
; Currently there are more than 3000 tests<br />
: They should all work. Some of them fail if you click or move the mouse while the tests are running (e.g. focus or UI tests).<br />
; Launch Error on starting tests<br />
: This sometimes happens when you launch a test as JUnit Plugin Test for the first time. => You will need to modify the launch configuration for this class:<br />
:# In the "Main" tab, change the field "Run an application" to "[No Application] - Headless Mode".<br />
:# In the "Plug-ins" tab:<br />
:## Launch with: choose "plug-ins selected below only".<br />
:## "Deselect All"<br />
:## Check/select the bundle containing the test you want to run.<br />
:## "Add Required Plug-ins"<br />
:# Apply. Run.<br />
; Classes ending with <tt>*ITest</tt> require a server.<br />
: That's the Riena App Sample Server (explained in the next step).<br />
<br />
== Install the Riena Sample App Server ==<br />
Simple server with customer search web service:<br />
# Stop any previously started client or server.<br />
# Import the 4 projects <tt>org.eclipse.riena.sample.app.server</tt>, <tt>org.eclipse.riena.sample.app.common</tt>, <tt>org.eclipse.riena.security.services</tt> and <tt>org.eclipse.riena.security.simpleservices</tt> from the target platform. (See [[#Import a Riena plugin]])<br />
# Start '''Riena App Server''' from the Run Dialog:<br />
#* Select the Bundles <tt>org.eclipse.equinox.console</tt> and <tt>org.apache.felix.gogo.shell</tt> and press the 'Add required Bundles' button before you start it!<br />
#* This server starts on port 8080, make sure that port is not taken.<br />
# That should bring up a simple app server with a secured customer search web service.<br />
<br />
== Run the Riena Example Client ==<br />
# Import the project <tt>org.eclipse.riena.example.client</tt> from the target platform. (See [[#Import a Riena plugin]])<br />
# In the "Run Dialog -> Eclipse Application", there are five new entries. Depending on the target platform you have to select the right run configuration.<br />
## For the target platform '''3.x''':<br />
### Select the '''SWT ExampleApplication''' or '''SWT ExampleApplication (with alternative LnF)''' configuration.<br />
### Add the plug-ins <tt>org.eclipse.riena.navigation.ui.swt.rcp</tt> and <tt>org.eclipse.riena.ui.swt.3x</tt> and press the 'Add required Plug-ins' button before you start them!<br />
###* Both launchers start the same application based on the same code, but using two distinct Riena Themes (different colors, fonts etc.).<br />
## For the target platform '''4.x''':<br />
### Select the '''SWT ExampleApplication E4'''<br />
### Add the plug-ins <tt>org.eclipse.riena.navigation.ui.swt.rcp</tt> and <tt>org.eclipse.riena.ui.swt.e4</tt> and press the 'Add required Plug-ins' button before you start it!<br />
<br />
== Run the Riena Example Mail Client ==<br />
# Import the project <tt>org.eclipse.riena.sample.app.client.mail</tt> from the target platform. (See [[#Import a Riena plugin]])<br />
# Start '''Mail Sample (Riena UI)''' from the Run Dialog:<br />
## For the target platform '''3.x''':<br />
### Select at the Main tab <tt>Run an application</tt> and '''org.eclipse.riena.sample.app.client.mail.mailapp'''<br />
### Add the plug-ins <tt>org.eclipse.riena.navigation.ui.swt.rcp</tt> and <tt>org.eclipse.riena.ui.swt.3x</tt> and press the 'Add required Plug-ins' button before you start them!<br />
## For the target platform '''4.x''':<br />
### Coming soon<br />
<br />
== Run the Riena Demo ==<br />
# Import the 4 projects <tt>org.eclipse.riena.demo.*</tt> from the target platform. (See [[#Import a Riena plugin]])<br />
# Select the '''Riena Demo Server''' launcher<br />
# Add the Bundles <tt>org.eclipse.equinox.console</tt> and <tt>org.apache.felix.gogo.shell</tt> and press the 'Add required Plug-ins' button before you start them!<br />
# Select the '''Riena Demo Client''' launcher<br />
## For the target platform '''3.x''':<br />
### Select at the Main tab <tt>Run an application</tt> and '''org.eclipse.riena.demo.client.application'''<br />
### Add the plug-ins <tt>org.eclipse.riena.navigation.ui.swt.rcp</tt> and <tt>org.eclipse.riena.ui.swt.3x</tt> and press the 'Add required Plug-ins' button before you start them!<br />
## For the target platform '''4.x''':<br />
### Select at the Main tab <tt>Run a product</tt> and '''org.eclipse.riena.e4.launcher.product'''<br />
### Add the plug-ins <tt>org.eclipse.riena.navigation.ui.swt.rcp</tt> and <tt>org.eclipse.riena.ui.swt.e4</tt> and press the 'Add required Plug-ins' button before you start them!<br />
###* The missing icons will throw some Exceptions<br />
<br />
<br />
== Next Step ==<br />
Get started with the [[Riena/BaseConcepts|Base concepts of Riena]].</div>Fabian.seiberling.compeople.de