W niniejszym podręczniku opisano sposób migrowania modułów dodatkowych ze środowiska Eclipse w wersji 3.0 lub wcześniejszej do środowiska Eclipse 3.1.
Jednym z celów środowiska Eclipse w wersji 3.1 było dalsze rozwinięcie tej platformy przy jednoczesnym zachowaniu kompatybilności z wcześniejszymi wersjami w możliwie jak największym stopniu. Oznacza to, że moduły dodatkowe 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 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.0 pozostaje poprawne w odniesieniu do wersji 3.1, tak że nie zachodzi konieczność modyfikowania działającego kodu. Kompatybilność binarna oznacza, że sygnatury metod interfejsów API i podobne elementy nie uległy zmianom uniemożliwiającym konsolidowanie i wykonywanie istniejącego skompilowanego kodu (kodu "binarnego") przy użyciu nowych bibliotek w wersji 3.1.
Choć dołożono wszelkich starań w celu zachowania kompatybilności, istnieje kilka obszarów, na których było to niemożliwe. W tej sekcji opisano obszary, w których środowisko Eclipse uległo zmianom powodującym zaistnienie niekompatybilności między wersją 3.0 a 3.1 oraz przedstawiono instrukcje dotyczące migrowania modułów dodatkowych z wersji 3.0 do wersji 3.1.