Upgrading from Version 1.3.x to Version 1.4.x

Upgrading from version 1.3.x to version 1.4.x is disruptive, because the monolitic plug-in of version 1.3.x has been split up into several smaller plug-ins in version 1.4.x. The split up of the plug-in has side effects on IDs of extension points in the plug-in manifests. The change in IDs makes pre-1.4.x extension points invalid.

Follow the upgrade instructions below to make sure that Jython projects created with version 1.3.x or older can still be used in version 1.4.x. Not following this upgrade procedure will result in projects that are not recognized as Jython projects anymore. On top of that, Eclipse will flag errors about missing builders, which might be very confusing.

  1. Open the Eclipse workspace which includes version 1.3.x (or older) of the Jython Development Tools.
    Select the Jython perspective.
  2. Close all module editors
    Be sure that no Jython files remain open.
  3. Delete as many unused projects as possible.
    By deleting projects, you will have less upgrade work. When deleting a project without deleting its contents, Eclipse does not delete the .project file and the contents still refers to a pre 1.4.x Jython builder. Remove it manually, otherwise it will be used when you create a new project.
  4. Remove the Jython nature of all Jython projects.
    In the Navigator, select the Jython projects one by one, and select "Jython > Remove Jython Nature" from the context (right mouse button) menu.
    After this step, all Jython projects have lost their Jython settings, that is their System Path and Class Path.
  5. Close the Jython perspectives.
    Close the Jython perspective and the Jython Browsing perspective.
  6. Disable Jython feature 1.3.x
    This step is required because otherwise version 1.4.x and version 1.3.x will be installed in the same workspace.

    Select Help > Software Updates > Manage Configuration ... from the menu bar. When the window labeled "Product Configuration" appears, find "Jython Feature 1.3.x" (1.3.9 in the picture below) and press "Disable" in the righthand side of the window.

    Press "Yes" if you are asked to restart Eclipse.

  7. Install JyDT version 1.4.x.
    Follow the installation instructions. Install the latest version of feature "Jython Development Tools (JyDT)".
  8. Configure the preferences.
    The upgrade has cleared the preferences. Open the Jython preferences and enter the desired settings. If you will set up the Jython library as a Jython project (see organizing projects), do not specify the "Jython Library" in the Jython > Installation tab.
  9. Add the Jython nature to all projects.
    In the Navigator, select the projects one by one, and select "Add Jython Nature" from the context menu. For each, select "Project > Properties" from the menu bar or "Properties" from the context menu. Specify the System Path, the Class Path and the Referenced Projects.
    Version 1.4.x supports referenced Jython projects, so that specifying libraries might not be the best way of organizing your projects anymore. Refer to organizing projects for tips to set up your projects.
  10. Open the Jython Browsing perspective.
    All projects have been built in the previous step, so that you can start browsing right away.
  11. Done.