W niniejszym podręczniku opisano migrację wtyczek ze środowiska Eclipse w wersji 2.1 lub wcześniejszej do środowiska Eclipse 3.0.
Jednym z założeń środowiska Eclipse w wersji 3.0 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 2.1 powinny działać także w wersji 3.0 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 2.1 pozostaje poprawne w odniesieniu do wersji 3.0, tak że nie zachodzi konieczność modyfikowania 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.0.
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 2.1 i 3.0, a także przedstawiono instrukcje dotyczące migracji wtyczek z wersji 2.1 do wersji 3.0.