This document is intended to introduce an interested developer on how to get acquainted with the ECF codebase, filing bugs at Bugzilla, and setting up a workspace with proper execution environments.
Installing an Appropriate Foundation 1.1 Execution Environment (Windows/Linux)
- Go to IBM's WEME evaluation platforms website.
- Select the appropriate Foundation 1.1 download based on your operating system (Linux or Windows XP).
- Go through the motions of signing up/logging into an IBM account and then download the .exe or .bin file.
- Install the downloaded file. On Windows, simply double-click on the executable as you would as usual. On Linux, make sure that the .bin file is executable (invoke a
chmod +xon it as necessary). You may not have permissions to write to the default folder it sets itself to, so change it as necessary.
- Dig inside the installed folder until you find the
weme-win-x86-ppro11_18.104.22.16860727-102926.zipzip file (the name will be slightly different on Linux).
- Extract the file to somewhere of your convenience. On Linux, you may need to enter the
binfolder and invoke
chmod +xon the
*.sofiles and the J9 binaries (such as
- Follow the J9 JRE setup instructions specified here. If you do not find the plug-in after you have reinstalled Eclipse, try again with the
- Now configure your execution environments by going to Window - Preferences - Java - Execution Environments.
- Select CDC-1.1/Foundation-1.1 from the left column, you should see your newly installed VM being a [perfect match], click on the checkbox, and then click 'OK'.
- That's it!
Setting a Foundation 1.1 Runtime for a Project
- Click on your project and access it's properties bringing up its context menu by right-clicking, 'Properties' should be at or near the bottom.
- Access the 'Java Build Path' section and click on the 'Libraries' tab.
- Click on your existing JRE System Library and remove it.
- Click on 'Add Library...', a dialog window should appear.
- Select 'JRE System Library', and then go 'Next'. Select the 'Execution Environment' radio button, and then select CDC-1.1/Foundation-1.1 from the combo control, now click 'Finish'.
You can set a plug-in's EE by opening up the
MANIFEST.MF file and setting it it in the 'Overview' tab.