Developer Guide

Jump to bottom Edit New page

Dénes Harmath edited this page Feb 1, 2021 · 10 revisions

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>