Developer Guide

Setup

• Download Eclipse Installer and run it in advanced mode
• Product
  • Select Eclipse DSL Tools
  • Product Version: Mars
• Projects
  • Add project to catalog Github.com with resource URI https://raw.githubusercontent.com/thSoft/elysium/master/Elysium.setup
  • Double-click project Elysium
• Variables
  • Target Platform: Mars
  • LilyPond executable location: full path of LilyPond binary on your system
• Note: if Git cloning fails with this error message, you are using an outdated version of the installer. Update it, download the latest version or rename the executable (the name must not contain "installer", "setup" etc.; otherwise Windows User Account Control kicks in and messes up the installation process)
• In the installed Eclipse:
  • Wait for the setup to finish
  • Run GenerateLilyPond.mwe2 as MWE2 workflow

Run

Application

• Run the Elysium launch configuration

Tests

• Run the Elysium Tests launch configuration
  • Some of the integration tests are known to fail until #93 is resolved

Debug

• To visualize the semantic & node model, use the Semantic/Node Model Outline views (more info)

Contribute

• Follow the GitHub instructions for collaboration
• If there are compile errors after a merge, restart Eclipse to have the Oomph setup run again
• If LilyPond.xtext or GenerateLilyPond.mwe2 changed, regenerate the language infrastructure

Release

• Export > Deployable features
  • select all features
  • Destination > Directory: directory of update site project
  • Options > Categorize repository: select category.xml
• Test the local update site
• Commit and push update site project
• Tag the commit
• Bump versions