Dieses Handbuch behandelt die Migration von Eclipse 3.0-Plug-ins (oder früher) auf Eclipse 3.1.
Ein Ziel für Eclipse 3.1 stellte die Weiterentwicklung von Eclipse dar, während die Kompatibilität mit früheren Versionen im größtmöglichen Umfang beibehalten werden sollte, d. h. gegen Eclipse 3.0-APIs geschriebene Plug-ins sollten trotz API-Änderungen weiterhin in 3.1 verwendet werden können.
Die wichtigsten Arten der Kompatibilität sind die API-Vertragskompatibilität sowie Binärkompatibilität. API-Vertragskompatibilität bedeutet, dass die gültige Benutzung von 3.0-APIs auch für 3.1 gültig bleibt, sodass keine Umstellung des Arbeitscodes erforderlich ist. Binärkompatibilität bedeutet, dass die API-Methodensignatur etc. nicht in einer Art geändert wird, durch die ein vorhandener kompilierter ("binärer") Code keine Verbindung aufbauen und nicht mit den neuen 3.1-Bibliotheken verwendet werden kann.
Auch wenn wir uns bemüht haben, eine Unterbrechung zu verhindern, gibt es einige wenige inkompatible Bereiche. In diesem Dokument werden die Bereiche beschrieben, in denen Eclipse in einer inkompatiblen Weise von 3.0 auf 3.1 geändert wurde. Außerdem enthält es Anweisungen für die Migration von 3.0-Plug-ins auf 3.1.