How to build

Dependencies

• Eclipse IDE for Eclipse Committers, see https://www.eclipse.org/downloads/packages/eclipse-ide-eclipse-committers/neon1
• Maven: just install the m2e plugin, see https://www.eclipse.org/m2e
• Tycho: do not need separate installation, will be fetched by Maven during the build automattically, see https://eclipse.org/tycho/

Get EasyShell plugin sources

• Clone EasyShell from https://github.com/anb0s/EasyShell.git to new directory EasyShell
• switch to master branch
• Import all projects to Eclipse and add them to new "Working Set" EasyShell
  • EasyShell: root project, needed only for readme, headless build etc.
  • de.anbos.eclipse.easyshell.feature: feature project
  • de.anbos.eclipse.easyshell.platform: platform definition
  • de.anbos.eclipse.easyshell.plugin: plugin with main sources
  • de.anbos.eclipse.easyshell.site: update site

Get EasyShell web-site (gh-pages)

• Clone EasyShell from https://github.com/anb0s/EasyShell.git to new directory EasyShell-gh-pages
• switch to gh-pages branch
• Import the project to Eclipse and add it to "Wortking Set" EasyShell
  • EasyShell-gh-pages: root project, needed for web- and update-site

Running and debugging in Eclipse

• select target platform you want to test EasyShell against:
  • go to project de.anbos.eclipse.easyshell.platform
  • open wanted platform definition file, e.g. for Eclipse 4.6 Neon use Eclipse-4.6.target
  • use Set as Target Platform and wait until the platform defition is loaded from Eclipse mirrors
• now there should be no build errors anymore
• use Run | Debug As | Eclipse Application and wait until the new Eclipse instance is opened
• use EasyShell, set breakpoint etc. :)

Building EasyShell plugin with update site for testing

• go to project EasyShell
• build
  • from Eclipse: run launch configuration EasyShell-Testing-Build
  • from commandline / headless / CI server: mvn clean verify with parameter site.dir=testing
• go to project de.anbos.eclipse.easyshell.site and use one of:
  • directory target\repository OR
  • zip file e.g. target\de.anbos.eclipse.easyshell.site-2.0.0-SNAPSHOT.zip OR
  • last version from updates\testing
• deploy
  • synchronize the directory updates\testing to project EasyShell-gh-pages directory testing
  • commit and push project EasyShell-gh-pages to GitHub and check the new version from site http://anb0s.github.io/EasyShell/testing

Building EasyShell plugin with update site for releasing

• go to project EasyShell
• build
  • from Eclipse: run launch configuration EasyShell-Release-Build
  • from commandline / headless / CI server: mvn clean verify with parameter site.dir=release
• go to project de.anbos.eclipse.easyshell.site and use one of:
  • directory target\repository OR
  • zip file e.g. target\de.anbos.eclipse.easyshell.site-2.0.0-SNAPSHOT.zip OR
  • last version from directory updates\release
• deploy
  • synchronize the directory updates\release to project EasyShell-gh-pages directory release
  • commit and push project EasyShell-gh-pages to GitHub and check the new version from site http://anb0s.github.io/EasyShell