Installing the Sources

Author: Eike Stepper

For developing applications on top of CDO it is normally sufficient to have the CDO SDK installed in your Eclipse target platform, which is described in section Preparing the Workspace.

However, if you want to work on CDO itself or want to analyze the commit history of CDO, you need to have the CDO sources available in your workspace. This chapter guides you through the trivial process of installing a development environment for the CDO sources.

The installation is fully automated and will be performed by the Eclipse Installer. Here are the four steps you need to follow:

1. Download and install a Java Development Kit (JDK) if you don't have one already. Version 21 or greater is required. You can get it from Adoptium or any other JDK provider of your choice.
2. Download and run the Eclipse Installer. You can use an existing Eclipse Installer installation if you have one.
3. Drag this link and drop it on the installer's title area. Alternatively, copy the location of the that link and apply it to the Eclipse Installer either via the menu in the upper right in simple mode or via the left-most toolbar button to the upper right in advanced mode.
4. Review and/or edit the variable values that the installer presents.
5. Click the Next/Finish buttons until the installation starts.

The installer will download and install the required Eclipse IDE packages, CDO, and all its dependencies. This may take a while depending on your internet connection speed. Once the installation is complete, the installer will launch the new IDE. Each time the IDE is started, it will check for updates and perform them automatically. Please refer to the Eclipse Installer documentation for details.