Developer Guide

Setup

• Download Eclipse Installer and run it in advanced mode
• Product
  • Select Eclipse DSL Tools
  • Product Version: 2020-12
• 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: 2020-12
  • 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)

Run

Application

• Run the Elysium launch configuration

Tests

• Run the Elysium Tests launch configuration

Debug

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

Build

Run build.sh

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
  • In a dedicated Eclipse instance, Check for updates
  • Try all the features
• Commit and push update site project
• Tag the commit
• Bump versions with mvn org.eclipse.tycho:tycho-versions-plugin:set-version -DnewVersion=<new version>