Migration Toolkit for Applications (MTA) Eclipse Plugin
Windup is a command-line Application Migration and Modernization assessment tool.
Provides Eclipse integration with the Migration Toolkit for Applications (MTA) project.
Before you can install the Windup plugin, you'll need to have Eclipse installed.
Building the project generates a zip archive containing an Eclipse update site under site/target/. You can install the features into Eclipse from the archive via "Help > Install New Software > Add... > Archive...".
The easiest way to get started with the code is to create your own fork, and then clone your fork:
$ git clone [email protected]:<you>/windup-eclipse-plugin.git
$ cd windup-eclipse-plugin
$ git remote add upstream git://github.com/windup/windup-eclipse-plugin.git
At any time, you can pull changes from the upstream and merge them onto your master:
$ git checkout master # switches to the 'master' branch
$ git pull upstream master # fetches all 'upstream' changes and merges 'upstream/master' onto your 'master' branch
$ git push origin # pushes all the updates to your fork, which should be in-sync with 'upstream'
The general idea is to keep your 'master' branch in-sync with the 'upstream/master'.
Setup your local environment with Maven 3.2.x+. See the Maven local settings.xml for set up of jboss.org repository.
This project depends on jbosstools-base and jbosstools-forge. The build will also pull in a snapshot build of Windup. To avoid needing to build the jbosstools projects before building windup-eclipse-plugin, be sure you have added the JBoss repositories to your Maven settings as shown here.
This command will then run the build:
$ mvn clean verify
Since we depend on a snapshot build of windup-distribution, you occasionally may need to run:
$ mvn -U clean verify
If you just want to check if things compile/build you can run:
$ mvn clean verify -DskipTests=true
But do not push changes without having the new and existing unit tests pass!
The Windup engine is resource intensive. I found I have had to increase the memory settings when launching Eclipse from the debugger to keep from running out of memory.
When debugging am currently using:
-Xms1024m -Xmx1536m -XX:MaxPermSize=512M
These settings will need to be optimized at some point.
These are the steps to release a new version of the plugin
- Update the version of the plugin to the release version
$ mvn org.eclipse.tycho:tycho-versions-plugin:set-version -DnewVersion=2.0.0
- Build the plugin
$ mvn clean verify
- Perform an installation test of the plugin
- Test the plugin UI contributions
- Commit the release version change
- Create a new Github release https://github.com/windup/windup-eclipse-plugin/releases/new
- Update the version of the plugin to the next SNAPSHOT
$ mvn org.eclipse.tycho:tycho-versions-plugin:set-version -DnewVersion=2.1.0-SNAPSHOT
- Commit the snapshot version change
- Continue development on next release