Jump to: navigation, search

Difference between revisions of "Riena/E4"

(clean up)
 
(43 intermediate revisions by 3 users not shown)
Line 1: Line 1:
This page is a start page that describes the current situation of Riena running on E4.
+
Riena supports the new E4 concepts to simplify the implementation of Riena applications in turn. Therefore there is a new branch '''rienaOnE4''' in the [http://git.eclipse.org/c/riena/org.eclipse.riena.git/ Riena Git Repository] where all Riena E4 development happens. (learn more about [[E4]])
This bug is also references by [[https://bugs.eclipse.org/bugs/show_bug.cgi?id=370445 Bug 370445]]
+
  
'''Setup Targetplatforms'''
+
E4 offers a compatibility layer for existing Eclipse 3.x applications. Riena does not make use of this compatibility layer, but brings native E4 support. Even so, Riena applications built on Eclipse 3.x basis will work with Riena on E4.
* Start an Eclipse IDE with an empty workspace
+
* Go to Target Platform in Preferences and setup two Target Platforms
+
** '''3.8.M5'''
+
** update site is http://download.eclipse.org/eclipse/updates/3.8milestones/S-3.8M5-201201251800
+
** switch off "Group by category" and sitch off "Include required Software"
+
** Select Equinox Target components
+
** Select Eclipse RCP and Eclipse RCP SDK
+
** click OK and wait for it to download and install (takes some minutes, I hadd 258 plugins in the target platform after that)
+
** '''4.2.M5''' as second target platform
+
** update site is http://download.eclipse.org/eclipse/updates/3.8milestones
+
** select Equinox Target components
+
** click ok and wait for it to resolve and download
+
** update site is http://download.eclipse.org/eclipse/updates/4.2milestones/S-4.2M5-201201271145
+
** Select Eclipse RCP / Eclipse RCP SDK and "Eclipse e4 Rich Client Platform" / "Eclipse e4 Rich Client Platform Developer Resources"
+
** Also select "EMF - Eclipse Modeling Framework Core Runtime"
+
** You need to switch on the "include required Software"
+
** click OK and wait for it to resolve and download
+
  
 +
The following guide will walk through the necessary steps to setup your environment in minutes.
  
'''Setup workspace'''
 
* Select 3.8 as your active target platform
 
* Clone the Riena Repo from Git using the URL git://git.eclipse.org/gitroot/riena/org.eclipse.riena.git
 
* open the org.eclipse.riena.releng projectSet.psf file and checkout the projects that are listed there into your workspace
 
* all the remaining "compile errors" are because there is no API baseline set, you can change the warning for that to ignore (in the Preferences) and you should have a workspace with no compile errors for 3.8
 
  
'''Start the Riena example based on 3.8'''
+
== Set up target platform for Riena apps ==
* Target Platform 3.8 is still the activated one (from the setup)
+
* Start the launcher "SWT Example Application", make sure you switch to the plugins tab and click "Add required plug-ins"
+
* If all goes well that should bring up a working Riena example client
+
* You can click in the navigation (left and top) and see the Riena navigation as it is supposed to work
+
  
''' Start the Riena example based on 4.2'''
+
Follow [[Riena/GettingStarted| this instruction]] to setup Riena for E4 and launch the example application.
* Switch the Target Platform to 4.2
+
 
* You get compile errors.
+
== Get Riena Source Code  ==
** Open SubApplicationView
+
 
** comment out the line in error (we use an internal Workbench method :-) and the if statement around it
+
*Clone the Riena Git Repository to any location in your file system
* Start SWT Example Application launcher as above (click on Add required plug-ins)
+
 
 +
<source lang="bash">
 +
git clone git://git.eclipse.org/gitroot/riena/org.eclipse.riena.git
 +
</source> ''For more information about using the Riena Git Repository checkout [[Riena/Git|Riena on Git]].''  
 +
 
 +
*Import the Git Repository in Eclipse
 +
*Checkout additional dependencies using the projectset in ''org.eclipse.riena.releng''
 +
 
 +
''If you have problems with the projectset checkout https://bugs.eclipse.org/bugs/show_bug.cgi?id=380375''
 +
 
 +
== Start Your Engines ==
 +
 
 +
*Open the dialog ''Run Configurations...''
 +
*Use the launch configuration ''SWT ExampleApplication '''E4''''' to start the Example Application  
 +
**If required, select ''Add Required Plug-Ins'' in the ''Plug-Ins'' tab
 +
 
 +
== TODOs ==
 +
*Verify that Riena works with pure E4 applications (E4 Example Client)
 +
*Use E4 dependency injection (DI) mechanism for the Riena DI implementation

Latest revision as of 11:25, 13 June 2013

Riena supports the new E4 concepts to simplify the implementation of Riena applications in turn. Therefore there is a new branch rienaOnE4 in the Riena Git Repository where all Riena E4 development happens. (learn more about E4)

E4 offers a compatibility layer for existing Eclipse 3.x applications. Riena does not make use of this compatibility layer, but brings native E4 support. Even so, Riena applications built on Eclipse 3.x basis will work with Riena on E4.

The following guide will walk through the necessary steps to setup your environment in minutes.


Set up target platform for Riena apps

Follow this instruction to setup Riena for E4 and launch the example application.

Get Riena Source Code

  • Clone the Riena Git Repository to any location in your file system
 git clone git://git.eclipse.org/gitroot/riena/org.eclipse.riena.git
For more information about using the Riena Git Repository checkout Riena on Git.
  • Import the Git Repository in Eclipse
  • Checkout additional dependencies using the projectset in org.eclipse.riena.releng

If you have problems with the projectset checkout https://bugs.eclipse.org/bugs/show_bug.cgi?id=380375

Start Your Engines

  • Open the dialog Run Configurations...
  • Use the launch configuration SWT ExampleApplication E4 to start the Example Application
    • If required, select Add Required Plug-Ins in the Plug-Ins tab

TODOs

  • Verify that Riena works with pure E4 applications (E4 Example Client)
  • Use E4 dependency injection (DI) mechanism for the Riena DI implementation