|
|
(11 intermediate revisions by 2 users not shown) |
Line 1: |
Line 1: |
− | = Lyo Code Generator Setup =
| + | #REDIRECT [[Lyo/modelling_and_generation/installation | Modelling and Generation Installation]] |
− | | + | '''''News''''': This workshop is now integrated into the [[Lyo/ToolchainModellingAndCodeGenerationWorkshop | Graphical Toolchain Modelling and Code Generation Workshop]]. The new modelling approach supports the modelling of a complete toolchain (including interactions between OSLC servers and clients), as well as a single server and/or client. |
− | == Installation ==
| + | |
− | The easiest way to install the Lyo Code Generator is via the update-site http://jadelkhoury.github.io/lyo.codegen/downloads/.
| + | |
− | | + | |
− | The code generator is known to work on Eclipse Kepler and Luna.
| + | |
− | | + | |
− | # Select '''''Help --> Install New Software...'''''
| + | |
− | # Set '''''Work With:''''' to the update site http://jadelkhoury.github.io/lyo.codegen/downloads/
| + | |
− | # Select the '''''Lyo Code Generator''''' feature.
| + | |
− | # Proceed with the installation steps.
| + | |
− | #* '''Note''': You will receive a warning that the software contains unsigned content. Press ''OK'' to proceed.
| + | |
− | | + | |
− | === General Tips for OSLC4J development ===
| + | |
− | | + | |
− | # Unless already installed, you need to first install a JDK (at least version 7 is necessary)
| + | |
− | # Install your preferred Eclipse distribution. Which distribution to use?
| + | |
− | #* [https://www.eclipse.org/downloads/packages/eclipse-ide-java-ee-developers/lunasr2 Eclipse IDE for Java EE Developers] seems to cover the necessary [https://wiki.eclipse.org/Lyo/prereqs prerequisites for Building Lyo Projects].
| + | |
− | #* [https://www.eclipse.org/downloads/packages/eclipse-ide-java-developers/lunasr2 Eclipse IDE for Java Developers] can be used, together with the following 2 additional plugins:
| + | |
− | #** ''Eclipse Java EE Developer Tools''
| + | |
− | #** ''Eclipse Java Web Developer Tools''
| + | |
− | # Once Eclipse is installed, you need to make sure the '''JAVA_HOME''' environment variable is set to the installed JDK (instead of the default JRE).
| + | |
− | ## Select '''''Window-->Preferences'''''
| + | |
− | ## Select '''''Java-->Installed JREs'''''
| + | |
− | ## Click '''''Add...'''''
| + | |
− | ## In the new window that appears,
| + | |
− | ### choose '''''Standard VM''''' as JRE Type
| + | |
− | ### click '''''Next'''''.
| + | |
− | ### As '''''JRE home''''' choose the installation dir of your JDK 1.6
| + | |
− | ### click '''''Finish'''''.
| + | |
− | ## Back to the preferences screen
| + | |
− | ### select the old JRE
| + | |
− | ### click '''''Remove'''''
| + | |
− | ### check the newly added JDK and
| + | |
− | ### click '''''OK'''''.
| + | |
− | | + | |
− | == Optional Installations ==
| + | |
− | The generator plugin contains a built-in EMF editor to create and manipulate the OSLC adaptor model. Standard EMF editors can equally be used as well. Example standard plugins that can be installed (using Eclipse's '''''Help --> Install new software''''' dialog) are:
| + | |
− | * '''EMF Facet SDK''' – providing the editor ''EMF Facet Model Browser''
| + | |
− | * '''EMF - Eclipse Modeling Framework SDK''' – providing the editor ''Sample Reflective Ecore Model Editor''
| + | |
− | | + | |
− | | + | |
− | == Working with the source code ==
| + | |
− | If you desire to work with the source code of the generator, the following additional steps are required:
| + | |
− | # Install the following plugins
| + | |
− | ## Acceleo
| + | |
− | ## A suitable EMF editor available through one of the Eclipse plugins ''"EMF Facet SDK"'' or ''"EMF - Eclipse Modeling Framework SDK"'' (See the optional installations above).
| + | |
− | # Clone the OSLC Core repository git://git.eclipse.org/gitroot/lyo/org.eclipse.lyo.core.git
| + | |
− | # View the Git repository in Eclipse
| + | |
− | ## Open the Git Repositories perspective in Eclipse
| + | |
− | ## Click the '''''Add an existing local Git repository''''' icon.
| + | |
− | ## Select the ''org.eclipse.lyo.core'' repository
| + | |
− | ## The repository should now show up in your Git Repositories view
| + | |
− | # Import the necessary Eclipse projects from the Git repository
| + | |
− | ## In the Git Repositories view, right click the org.eclipse.lyo.core repository and select '''''Import Projects'''''
| + | |
− | ## Select the '''''Import Existing Projects''''' wizard and click '''''next'''''
| + | |
− | ## Select the ''adaptor_model'' & ''codegenerator'' projects.
| + | |