W niniejszym podręczniku opisano sposób migrowania wtyczek ze środowiska Eclipse JDT w wersji 3.1 lub wcześniejszej do środowiska Eclipse JDT 3.2.
Jednym z celów środowiska Eclipse 3.2 było dalsze rozwinięcie tej platformy przy jednoczesnym zachowaniu kompatybilności z wcześniejszymi wersjami w możliwie największym stopniu. Oznacza to, że wtyczki zaprojektowane z myślą o interfejsach API środowiska Eclipse 3.1 powinny działać także w wersji 3.2 mimo modyfikacji interfejsów API.
Najważniejsze rodzaje kompatybilności to kompatybilność binarna oraz kompatybilność kontraktowa interfejsów API. Kompatybilność kontraktowa oznacza, że poprawne użycie interfejsów API w wersji 3.1 pozostaje poprawne w odniesieniu do wersji 3.2, także nie trzeba modyfikować działającego kodu. Kompatybilność binarna oznacza, że sygnatury metod interfejsów API i tym podobne elementy nie uległy takim zmianom, które mogłyby spowodować, że istniejący skompilowany kod (kod "binarny") nie mógłby być konsolidowany i wykonywany z nowymi bibliotekami w wersji 3.2.
Choć dołożono wszelkich starań w celu zachowania kompatybilności, istnieje kilka obszarów, na których było to niemożliwe. W tym dokumencie są opisane obszary, w których środowisko Eclipse uległo zmianom powodującym niekompatybilności między wersją 3.1 i 3.2, i podano instrukcje migrowania wtyczek z wersji 3.1 do wersji 3.2.