Podręcznik migracji modułów dodatkowych do środowiska Eclipse 3.0

W niniejszym podręczniku opisano sposób migrowania modułów dodatkowych ze środowiska Eclipse w wersji 2.1 lub wcześniejszej do środowiska Eclipse 3.0.

Jednym z celów środowiska Eclipse w wersji 3.0 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 moduły dodatkowe 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 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 2.1 pozostaje poprawne w odniesieniu do wersji 3.0, tak że nie zachodzi konieczność modyfikowania 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.0.

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 opisano obszary, na których środowisko Eclipse uległo zmianom powodującym zaistnienie niekompatybilności między wersją 2.1 i 3.0, i przedstawiono instrukcje dotyczące migrowania modułów dodatkowych z wersji 2.1 do wersji 3.0.