Skip to main content
Jump to: navigation, search

Difference between revisions of "Lyo/AdaptorCodeGeneratorWorkshop/EclipseSetup"

(Installation)
(Replace absolute links with wiki links && Sirius dependency)
Line 20: Line 20:
 
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.  
 
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)
+
# 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?
 
# 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-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:  
 
#* [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 EE Developer Tools''
Line 33: Line 33:
 
### choose '''''Standard VM''''' as JRE Type  
 
### choose '''''Standard VM''''' as JRE Type  
 
### click '''''Next'''''.  
 
### click '''''Next'''''.  
### As '''''JRE home''''' choose the installation dir of your JDK 1.6
+
### As '''''JRE home''''' choose the installation dir of your JDK
 
### click '''''Finish'''''.
 
### click '''''Finish'''''.
 
## Back to the preferences screen
 
## Back to the preferences screen
Line 44: Line 44:
 
If you desire to work with the source code of the generator, the following additional steps are required:
 
If you desire to work with the source code of the generator, the following additional steps are required:
 
# Install the following plugins
 
# Install the following plugins
## Acceleo  
+
## 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).  
 
## 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
 
# Clone the OSLC Core repository git://git.eclipse.org/gitroot/lyo/org.eclipse.lyo.core.git

Revision as of 10:38, 16 May 2016

Lyo Code Generator Setup

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.)

  1. Select Help --> Install New Software...
  2. Set Work With: to the update site http://jadelkhoury.github.io/lyo.codegen/downloads/
  3. Select the Lyo Code Generator feature.
  4. 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.

  1. Unless already installed, you need to first install the JDK 8 (see the prerequisites).
  2. Install your preferred Eclipse distribution. Which distribution to use?
  3. 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).
    1. Select Window-->Preferences
    2. Select Java-->Installed JREs
    3. Click Add...
    4. In the new window that appears,
      1. choose Standard VM as JRE Type
      2. click Next.
      3. As JRE home choose the installation dir of your JDK
      4. click Finish.
    5. Back to the preferences screen
      1. select the old JRE
      2. click Remove
      3. check the newly added JDK and
      4. 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:

  1. Install the following plugins
    1. Acceleo
    2. Sirius Specifier Environment
    3. A suitable EMF editor available through one of the Eclipse plugins "EMF Facet SDK" or "EMF - Eclipse Modeling Framework SDK" (See Optional Installations above).
  2. Clone the OSLC Core repository git://git.eclipse.org/gitroot/lyo/org.eclipse.lyo.core.git
  3. View the Git repository in Eclipse
    1. Open the Git Repositories perspective in Eclipse
    2. Click the Add an existing local Git repository icon.
    3. Select the org.eclipse.lyo.core repository
    4. The repository should now show up in your Git Repositories view
  4. Import the necessary Eclipse projects from the Git repository
    1. In the Git Repositories view, right click the org.eclipse.lyo.core repository and select Import Projects
    2. Select the Import Existing Projects wizard and click next
    3. Select the adaptormodel & codegenerator projects.

Back to the top