Installing the ULC Visual Editor

To install the ULC Visual Editor:

  • Download and install ULC if you do not have ULC 6.2. Get a license key for ULC.

  • Make sure that you have installed the appropriate Eclipse version. If not, it can be downloaded from http://www.eclipse.org.

  • Get an appropriate license key for the ULC Visual Editor version chosen by you.

  • Download and run the ULC Visual Editor installer.

  • During installation, the License Information dialog box displays. Copy and paste the license key you received by email into the License Information text box.

  • Select Typical to install Eclipse Visual Editor in addition to ULC Visual Editor.

  • The installer copies a link file called com.canoo.ulc.visualeditor.link in your $ECLIPSE_INSTALL_DIR/links. Therefore, it is necessary to correctly specify your Eclipse Home Directory during installation. Otherwise, you will need to manually copy the link file.

  • Start Eclipse and select Help > About Eclipse Platform and you should see the ULC Visual Editor icon.

  • Next, check the plug-ins details. To display the plug-ins in Eclipse, select Help > About Eclipse Platform > Plug-in Details and you should see the ULC Visual Editor and Eclipse Visual Editor related plugins as described in the ULC Visual Editor Release Notes.

  • To use ULC Visual Editor within your ULC projects in Eclipse you need to:
    • Add the ULC libraries to the class path of your ULC project. For details see the Online Help provided with the ULC Visual Editor. Select Help > Help Contents > ULC Visual Editor Help > Using the ULC Visual Editor in a ULC Project.
    • The online help includes a tutorial and useful tips on how to use the ULC Visual Editor.

Note: if you have already installed Eclipse, you may also use the Eclipse Update Site to install the ULC Visual Editor as follows:

  • Start Eclipse.
  • Select Help > Software Updates > Find and Install...
  • Select Search for new features to install.
  • Click New Remote Site....
  • Type ULC Update Site as name and http://update.canoo.com/eclipse as URL.
  • Expand the ULC Update Site node and select ULC Visual Editor. Note that installing ULC Visual Editor also requires you to install the following plugins:
    • at least Eclipse Visual Editor 1.2.0
    • Eclipse EMF 2.2.0
    • Eclipse GEF 3.2.0
  • Click Next.
  • Select ULC Visual Editor.
  • Click Accept to accept the license agreement.
  • Click Finish.
  • The Add ULC Visual Editor License dialog box displays. Copy and paste your ULC Visual Editor license key into the space provided. Click OK.
  • Click Install.
  • Click Yes to restart Eclipse.
    Note: You will need to restart Eclipse to complete the installation.

Using ULC Visual Editor with Eclipse 3.4

ULC VE 6.1 is based on Eclipse VE 1.2 which is the last official release of Eclipse VE for Eclipse 3.2. No new release of Eclipse VE was made for Eclipse 3.3 and Eclipse 3.4. Therefore no new release of ULC VE was made that is compatible with Eclipse 3.3 and 3.4.

However, there is an unofficial release of Eclipse VE 1.4 with which ULC VE is compatible. The following steps describe how you can install ULC VE in Eclipse 3.4.

  1. Install Eclipse 3.4.
  2. Start Eclipse and install VE 1.4 from the update site http://update.soyatec.org/Ganymede/ve/1.4/ as described here http://wiki.eclipse.org/VE/Update. Shutdown Eclipse after installing the Eclipse VE plug-in.
  3. Install ULC VE 6.1 using the installer as described in the section above. While installing choose Custom Configuration and choose NOT to install Eclipse VE (because ULC VE installer includes Eclipse VE version 1.2).
  4. While installing ULC VE, specify the Eclipse 3.4 installation dir so that the installer will copy a link file to ULC VE plugin in the eclipse/links dir.
  5. Start Eclipse and follow the steps described in Help > Help Contents > ULC Visual Editor Help