|
|
(3 intermediate revisions by the same user not shown) |
Line 1: |
Line 1: |
− | == Eclipse Setup when working with source code ==
| + | This page has moved to Lyo Designer's new home under the [https://github.com/eclipse/lyo.designer/wiki/Working-from-Source-Code Eclipse Foundation's Github] |
− | If you desire to work with the source code of the modelling tool, the following once-only installation and configuration of your Eclipse environment are required:
| + | |
− | | + | |
− | # Make sure your environment is setup for OSLC4J code generation as instructed under [[Lyo/creating_OSLC4J_project | creating OSLC4J Project]]
| + | |
− | # Install the following additional Eclipse packages
| + | |
− | ## 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/modelling_and_generation/working_from_source_code#Optional_Installations | Optional Installations]] below).
| + | |
− | ## Eclipse Plugin Development Environment
| + | |
− | # 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.
| + | |
− | # Clone the OSLC Tools repository ''git://git.eclipse.org/gitroot/lyo/org.eclipse.lyo.tools.git ''
| + | |
− | ## Open the '''Git Repositories''' perspective in Eclipse
| + | |
− | ## Click the "Clone a Git Repository and add the clone to this view" icon.
| + | |
− | ## Set the URI to ''git://git.eclipse.org/gitroot/lyo/org.eclipse.lyo.tools.git''
| + | |
− | ## …
| + | |
− | ## The repository should now appear 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.tools'' repository and select '''Import Projects'''
| + | |
− | ## Select the '''Import Existing Projects''' wizard and click '''next'''
| + | |
− | ## Select and import the following 11 projects:
| + | |
− | ##* org.eclipse.lyo.tools.adaptormodel.[edit, editor, model, tests]
| + | |
− | ##* org.eclipse.lyo.tools.toolchain.[edit, editor, model, tests]
| + | |
− | ##* org.eclipse.lyo.tools.toolchain.design
| + | |
− | ##* org.eclipse.lyo.tools.codegenerator.[feature, ui]
| + | |
− | ##** Compile errors in any of the plugins? Right-click the project and select ''Plug-in Tools-->Update Classpath ...''
| + | |
− | # Create a new "Eclipse Application" configuration called '''Tool Chain Design'''
| + | |
− | ## Select '''Run > Run Configurations …'''
| + | |
− | ## Select '''Eclipse Application'''
| + | |
− | ## Press '''New''' button to create a new configuration
| + | |
− | ## In the new dialog,
| + | |
− | ### Set '''name''' to ''Tool Chain Design''
| + | |
− | ### In Arguments tab, change '''VM argument''' value to ''-Xms256m -Xmx768m -XX:MaxPermSize=256m'' (last option became obsolete in Java 8)
| + | |
− | | + | |
− | == 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''
| + | |
− | | + | |
− | = Create a Toolchain Modelling Project =
| + | |
− | To create the toolchain modelling project:
| + | |
− | | + | |
− | # Run the ''Tool Chain Design'' configuration in order to run a new Eclipse workspace with the required plugins
| + | |
− | ## Select '''Run > Run Configurations …'''
| + | |
− | ## Select the ''Tool Chain Design'' configuration
| + | |
− | ## Press '''Run'''
| + | |
− | # In the new ''Tool Chain Design'' Eclipse workspace, switch to the '''Sirius''' perspective
| + | |
− | # Proceed with the modelling and generation as instructed in the [[Lyo/ToolchainModellingAndCodeGenerationWorkshop#Create_a_Toolchain_Modelling_Project | Toolchain Modelling And Code Generation Workshop]]
| + | |