Skip to main content
Jump to: navigation, search

Difference between revisions of "Lyo/AdaptorCodeGeneratorWorkshop/EclipseSetup"

(Replace absolute links with wiki links && Sirius dependency)
 
(6 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 Lyo Code Generator is known to work on Eclipse Kepler and Luna.
+
 
+
The easiest way to install the generator is via the update-site http://jadelkhoury.github.io/lyo.codegen/downloads/. (This URL is intended to be accessed via the Eclipse update functionality, and not via a web browser.)
+
 
+
# 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.
+
 
+
== Optional Installations ==
+
The generator plugin contains a built-in simple 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''
+
 
+
== General Setup for OSLC4J development ==
+
The following instructions are not directly related to the Lyo Code Generator, but to OSLC4J development in general. While the generator should work with any other setup, such a setup is known to work for the generator.
+
 
+
# Unless already installed, you need to first install the JDK 8 (see the [[Lyo/prereqs|prerequisites]]).
+
# 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 [[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
+
### click '''''Finish'''''.
+
## Back to the preferences screen
+
### select the old JRE
+
### click '''''Remove'''''
+
### check the newly added JDK and
+
### click '''''OK'''''.
+
 
+
== 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
+
## Sirius Specifier Environment
+
## A suitable EMF editor available through one of the Eclipse plugins ''"EMF Facet SDK"'' or ''"EMF - Eclipse Modeling Framework SDK"'' (See [[Lyo/AdaptorCodeGeneratorWorkshop/EclipseSetup#Optional_Installations | 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 ''adaptormodel'' & ''codegenerator'' projects.
+

Latest revision as of 03:24, 28 October 2016

News: This workshop is now integrated into the 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.

Back to the top