Notice: this Wiki will be going read only early in 2024 and edits will no longer be possible. Please see: https://gitlab.eclipse.org/eclipsefdn/helpdesk/-/wikis/Wiki-shutdown-plan for the plan.
Difference between revisions of "RAP/EMF Integration"
(→Runtime) |
|||
| (35 intermediate revisions by 4 users not shown) | |||
| Line 1: | Line 1: | ||
| − | |||
[[Image:Emf rap.png|right]] | [[Image:Emf rap.png|right]] | ||
| − | == | + | == EMF Runtime == |
| − | + | The non-UI part of EMF works with RAP out of the box. With the aid of the following bundles, EMF models can be created and accessed. | |
| + | * <code>org.eclipse.emf.common</code> | ||
| + | * <code>org.eclipse.emf.ecore</code> | ||
| + | Even though these bundles express an optional dependency on <code>org.eclipse.core.resources</code>, this dependency isn't required at runtime. As of the Indigo release, these base features (along with a couple of others) are built independently of the rest of the core and are included in a "EMF Base Framework" feature. | ||
| − | + | == EMF UI and Edit Framework == | |
| − | + | Since 2.6 M6, EMF provides branches of it's UI/Edit framework for use with RAP (details are documented in [https://bugs.eclipse.org/bugs/show_bug.cgi?id=213988 bug 213988]). The necessary bundles are available from the EMF software repository and can be used together with the RAP runtime (> 1.3 M6). | |
| − | The bundles used | + | |
| − | + | ||
| − | + | ||
| − | + | The following sections ouline the basic steps to run EMF on RAP. The Ecore and Genmodel of the Library Example used throughout this page can be [http://wiki.eclipse.org/images/0/0b/Emfrapexample.zip downloaded here] | |
| − | EMF | + | |
| − | == | + | === Prepare the IDE === |
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | In order to develop applications for EMF and RAP, you will need to install two features into your IDE: | |
| − | + | * The tools to work with EMF models, which are available from [http://www.eclipse.org/modeling/emf/updates here] (chose versions >= 2.6 M6) | |
| + | * The tooling for RAP, that can be obtained from [http://eclipse.org/rap/downloads/index.php here] (chose versions >= 1.3 M6) | ||
| − | == | + | === Assemble the Runtime Target === |
| − | + | ||
| − | + | ||
| − | + | The minimal runtime consists of EMF for RAP and the RAP runtime itself. To set up the target platform, the most conventient way is assemble it directly from the Helios software repository: | |
| − | The | + | * Helios Repository: <code><nowiki>http://download.eclipse.org/releases/helios</nowiki></code> |
| + | The following features are interesting for you: | ||
| + | * Rich Ajax Platform (RAP) Target Components | ||
| + | * EMF RAP Target Components | ||
| + | Both of them are contained in the EclipseRT category. Note also that, as of the Indigo release, the "EMF Base Framework" feature must also be installed from the Modeling category. | ||
| + | {{warning|EMF for RAP and the RAP runtime must not be installed into the IDE, it will break the IDE.}} | ||
| − | == | + | [[Image:Rapemftarget.png]] |
| − | + | ||
| − | + | Please make sure to '''uncheck''' the "Include required software" option when adding the features from the repositories. | |
| − | + | ||
| + | === Configuring EMF and RAP as Runtime === | ||
| + | |||
| + | Open up the Properties view on your .genmodel file and set the "Rich Ajax Application" from the "Editor" category to true. | ||
| + | |||
| + | [[Image:Rapemfproperties.png]] | ||
| + | |||
| + | After that you can generate your edit and editor code. | ||
| + | |||
| + | === Launch the application === | ||
| + | |||
| + | You can now launch the application via it's generated <code>org.eclipse.core.runtime.applications</code> extension. Just use the ''LibraryEditorAdvisorApplication'' entry point. | ||
| + | |||
| + | [[Image:Rapemflaunch.png]] | ||
| + | |||
| + | [[Category:RAP]] | ||
| + | [[Category:Modeling]] | ||
| + | [[Category:EMF]] | ||
Revision as of 11:55, 13 June 2012
Contents
EMF Runtime
The non-UI part of EMF works with RAP out of the box. With the aid of the following bundles, EMF models can be created and accessed.
-
org.eclipse.emf.common -
org.eclipse.emf.ecore
Even though these bundles express an optional dependency on org.eclipse.core.resources, this dependency isn't required at runtime. As of the Indigo release, these base features (along with a couple of others) are built independently of the rest of the core and are included in a "EMF Base Framework" feature.
EMF UI and Edit Framework
Since 2.6 M6, EMF provides branches of it's UI/Edit framework for use with RAP (details are documented in bug 213988). The necessary bundles are available from the EMF software repository and can be used together with the RAP runtime (> 1.3 M6).
The following sections ouline the basic steps to run EMF on RAP. The Ecore and Genmodel of the Library Example used throughout this page can be downloaded here
Prepare the IDE
In order to develop applications for EMF and RAP, you will need to install two features into your IDE:
- The tools to work with EMF models, which are available from here (chose versions >= 2.6 M6)
- The tooling for RAP, that can be obtained from here (chose versions >= 1.3 M6)
Assemble the Runtime Target
The minimal runtime consists of EMF for RAP and the RAP runtime itself. To set up the target platform, the most conventient way is assemble it directly from the Helios software repository:
- Helios Repository:
http://download.eclipse.org/releases/helios
The following features are interesting for you:
- Rich Ajax Platform (RAP) Target Components
- EMF RAP Target Components
Both of them are contained in the EclipseRT category. Note also that, as of the Indigo release, the "EMF Base Framework" feature must also be installed from the Modeling category.
Please make sure to uncheck the "Include required software" option when adding the features from the repositories.
Configuring EMF and RAP as Runtime
Open up the Properties view on your .genmodel file and set the "Rich Ajax Application" from the "Editor" category to true.
After that you can generate your edit and editor code.
Launch the application
You can now launch the application via it's generated org.eclipse.core.runtime.applications extension. Just use the LibraryEditorAdvisorApplication entry point.
