W niniejszym podręczniku opisano migrację wtyczek ze środowiska Eclipse w wersji 3.1 lub wcześniejszej do środowiska Eclipse 3.2.
Jednym z założeń środowiska Eclipse w wersji 3.2 było dalsze rozwijanie tej platformy przy jednoczesnym zachowaniu jak największej zgodności z wcześniejszymi wersjami. Oznacza to, że wtyczki zaprojektowane pod kątem interfejsów API środowiska Eclipse 3.1 powinny działać także w wersji 3.2 pomimo zmian wprowadzonych w zakresie tych interfejsów.
Najważniejsze rodzaje zgodności to zgodność binarna oraz zgodność 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. Zgodność binarna oznacza, że sygnatury metod interfejsów API i podobne elementy nie uległy zmianom, które mogłyby uniemożliwić konsolidowanie i wykonywanie istniejącego, skompilowanego kodu (kodu "binarnego") z nowymi bibliotekami w wersji 3.2.
Chociaż dołożono wszelkich starań w celu zachowania zgodności, istnieje kilka obszarów, w których było to niemożliwe. W tym dokumencie opisano obszary, w których środowisko Eclipse uległo zmianom powodującym niezgodność wersji 3.1 i 3.2, a także przedstawiono instrukcje dotyczące migracji wtyczek z wersji 3.1 do wersji 3.2.