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