Eclipse JDT 3.2 -version lisäosien siirto-opas

Tässä oppaassa käsitellään Eclipse JDT 3.1 -version (tai aiemman version) lisäosien siirtoa Eclipse JDT 3.2 -versioon.

Yksi Eclipse 3.2 -version tavoitteista oli parantaa Eclipse-ympäristöä niin, että yhteensopivuus aiempiin versioihin säilyisi mahdollisimman hyvänä. Näin ollen Eclipse 3.1 -version ohjelmointirajapintojen perusteella kirjoitettujen lisäosien tulisi toimia 3.2-versiossa huolimatta ohjelmointirajapintojen muutoksista.

Yhteensopivuuden avainlaatuja ovat ohjelmointirajapintasopimuksen yhteensopivuus ja binaarinen yhteensopivuus. Ohjelmointirajapintasopimuksen yhteensopivuus merkitsee, että 3.1-version ohjelmointirajapintoja voi käyttää myös versiossa 3.2, joten toimivaa koodia ei tarvitse käydä uudelleen lävitse. Binaarinen yhteensopivuus merkitsee, että ohjelmointirajapintojen metodien allekirjoitukset jne. eivät ole muuttuneet niin, että aiemmin luotu käännetty ("binaarinen") koodi ei enää linkittyisi uusiin 3.2-version kirjastoihin eikä sitä voisi ajaa niillä.

Kaikesta yhteensopivuuden säilyttämiseksi tehdystä työstä huolimatta on muutamia yhteensopimattomia alueita. Tässä asiakirjassa kuvaillaan niitä alueita, joilla Eclipse muuttui yhteensopimattomaksi siirryttäessä versiosta 3.1 versioon 3.2, ja annetaan ohjeita 3.1-version lisäosien siirtoon 3.2-versioon.