UMLX requires (minimum versions)
Note that the EMFT OCL download is incomplete and requires ANTLR 2.7.2 to be downloaded and antlr.jar copied to eclipse/plugins/antlr_2.7.2/lib/antlr.jar.
Note that as of version 3.1, GEF uses the SWT polyline support that requires GDI+, which is not present on earlier versions of Windows, so you may need to get GDI+ (as a free download) from Microsoft.
UMLX 0.0.3 is built with Java 1.5.0_06, Eclipse 3.2M5a, EMF 2.2.0M5, EMFT OCL 1.0.0.M5, GEF 3.2M5. (EMF 2.2.0M4 introduced some minor but subtle signature changes, which weren't copnsistently built into OCL til 1.0.0.M5, so there is little chance of earlier versions building sucessfully.)
It is assumed that you have already successfully installed at least Java and Eclipse.
Maintenance of the UMLX sources also requires VE 1.2M1.
Execution of the UMLX OCL tests requires two NPE fixes in OCLPlugin.java. These are expected to be incorporated in the OCL 1.0.0 release.
EMF 2.2.0M5 may be downloaded piecemeal from its Update Site, but it perhaps easier just to download emf-sdo-xsd-SDK-2.1.0.zip and then copy all of the features and plugins to the corresponding folders in your Eclipse installation.
GEF 3.1 may be downloaded from GEF-ALL-3.1.zip and all of its features and plugins copied to the corresponding folders in your Eclipse installation.
Within Eclipse, start up the Update Manager Install wizard by invoking: Help->Software Updates->Find and Install...
In the Feature Updates page select "Search for new features to install" and click Next.
Then in the Update Sites to Visit page, use New Remote Site... to define the UMLX Update Site as
http://download.eclipse.org/technology/gmt/umlx/updates/
for the main Eclipse download site in Canada. You may visit
http://www.eclipse.org/downloads/download.php?file=/technology/gmt/umlx/updates&format=plain
for a list of Mirrors.
Click OK
Ensure that the UMLX Update Site is selected, and then Click Finish to proceed to the Updates Wizard.
Select the desired UMLX release version and content.
Accept the license terms – they're the standard Eclipse ones and click Next to get to the Installation page.
If you are happy to load UMLX in the same folder as Eclipse you may click Next immediately. However you may find it convenient to use separate locations for each Eclipse layered product and release, so that you can more easily see what you have and change it. You may therefore want to invoke Add Location... before proceeding.
When the feature has been downloaded, click Install to complete installation. Then when the plug-ins have been installed, hit Yes to restart.
UMLX adds no views, natures or perspectives so nothing appears to change.
You may verify that UMLX is installed by using Help->About Eclipse SDK.
You may read the UMLX User Guide and follow the tutorial by invoking Help->Help Contents.
You may create a new, or a copy of an example UMLX diagram by invoking New->File->Examples... UMLX Examples.
The UMLX feature includes a source plug-in. The source may be made visible within Eclipse by (using the Navigator menu) Import...->External Plug-ins and Fragments.
The amount of disk space used and visibility of the source may be controlled by selecting, binary, binary linked, or source projects. Next.
Select *umlx* and Add, then Finish.
Alternatively the sources may be downloaded from CVS.
Use Window->Open Perspective->Other..., CVS Repository Exploring, then click OK to open the CVS Repository perspective.
Within the CVS Repository Explorer, invoke New->Repository Location...
to define a
repository entry with provide read-only access to the Eclipse
Technology projects.
(If you are behind a firewall
you should use Window->Preferences..., Team->CVS->SSH2
Connection Method|Proxy to enable a proxy connection through your
firewall).
Then select all org.eclipse.gmt.umlx folders
(using a left click to select the top one and shift left click the bottom one) then use invoke Check Out from the right button menu.
When you return to the Package Explorer, you should find the projects exist and are probably building.
Each project defines its own preferences, so there should be no problems provided you have Java 5 available. There should be no errors or warnings.
You may invoke Run As...->JUnit test on the org.eclipse.umlx.tests plug-in to test the kernel functionality. Expect no errors or failures.
Edward D. Willink
21 March 2006