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 installs the CDO development workspace, not just the SDK used by an application. The setup provisions an Eclipse installation and target platform, checks out/imports the CDO projects, and configures the workspace for developing those projects. It is not necessary when an application only needs CDO bundles; see Preparing the Workspace for that case.

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

1. Download and install a Java Development Kit (JDK) if you don't have one already. The current CDO development setup requires Java 21 or later. 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 provision the Eclipse IDE, the CDO source projects, the target platform, and the dependencies declared by the development setup. It does not merely install the CDO SDK into an existing application's target platform. This may take a while depending on your internet connection speed. Once the installation is complete, the installer will launch the new IDE. The setup configures automatic update behavior for the provisioned installation. Please refer to the Eclipse Installer documentation for details.