Tento průvodce se věnuje migraci modulů plug-in platformy Eclipse JDT verze 3.1 (nebo dřívější) do Eclipse JDT verze 3.2.
Jedním z cílů verze 3.2 platformy Eclipse bylo posunout technická řešení této platformy vpřed při zachování maximální kompatibility s předchozími verzemi. To znamená, že moduly plug-in napsané pro rozhraní API platformy Eclipse 3.1 by měly pracovat ve verzi 3.2 i přes úpravy 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.1 zůstává platné i pro verzi 3.2 a že tedy není zapotřebí přezkoumávat pracují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.2.
Ačkoliv byla vyvinuta maximální snaha zachovat funkčnost, existuje několik oblastí nekompatibility. Tento dokument popisuje oblasti, ve kterých došlo mezi verzemi 3.1 a 3.2 platformy Eclipse ke změnám ovlivňujícím vzájemnou kompatibilitu, a poskytuje pokyny pro migraci modulů plug-in z verze 3.1 na verzi 3.2.