Skip to main content

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.

Jump to: navigation, search

Difference between revisions of "Lyo/AdaptorCodeGeneratorWorkshop/EclipseSetup"

m
 
(9 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.
+
 
+
== 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 Tips 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 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'''''.
+
 
+
== 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 [https://wiki.eclipse.org/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 ''adaptor_model'' & ''codegenerator'' projects.
+

Latest revision as of 04: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