Tento průvodce pokrývá migraci modulů plug-in pro Eclipse verze 3.0 (nebo starší) do Eclipse 3.1.
Jedním z cílů Eclipse verze 3.1 bylo posunout platformu Eclipse kupředu, ale zachovat kompatibilitu s předchozími verzemi v maximálním možném rozsahu. To znamená, že moduly plug-in napsané proti rozhraním API Eclipse verze 3.0 by měly nadále fungovat ve verzi 3.1, navzdory změnám v rozhraních API.
Klíčovými druhy kompatibility jsou kompatibilita kontraktu API a binární kompatibilita. Kompatibilita kontraktu API znamená, že platné použití rozhraní API verze 3.0 zůstává platné ve verzi 3.1, takže není potřeba přezkoumávat fungující kód. Binární kompatibilita znamená, že podpisy metod rozhraní API atd. se nezměnily způsobem, který by stávajícímu přeloženému ("binárnímu") kódu zabránil v propojení a běhu s novými knihovnami veze 3.1.
Ačkoliv byla vyvinuta maximální snaha zachovat funkčnost, existuje několik oblastí nekompatibility. Tento dokument popisuje oblasti, kde se platforma Eclipse mezi verzemi 3.0 a 3.1 změnila nekompatibilním způsobem, a dává pokyny pro migraci modulů plug-in z verze 3.0 na verzi 3.1.