Eclipse 3.1 -version lisäosien siirron opas

Tämä opas käsittelee Eclipse 3.0 -version (tai sitä edeltävän version) lisäosien siirtoa Eclipse 3.1 -versioon.

Eräs Eclipse 3.1 -version tavoitteista oli edistää Eclipse-ympäristöä siten, että se olisi kuitenkin samalla mahdollisimman pitkälle yhteensopiva aiempien versioiden kanssa. Toisin sanoen Eclipse 3.0 -sovellusohjelmaliittymille kirjoitettujen lisäosien tulisi toimia edelleen 3.1-versiossa huolimatta sovellusohjelmaliittymien muutoksista.

Tärkeimmät yhteensopivuuden lajit ovat sovellusohjelmaliittymäsopimuksen yhteensopivuus ja binaarinen yhteensopivuus. Sovellusohjelmaliittymäsopimuksen yhteensopivuus tarkoittaa sitä, että 3.0-sovellusohjelmaliittymien kelvollinen käyttö on edelleen kelvollista versiossa 3.1, joten toimivaa koodia ei tarvitse käydä uudelleen lävitse. Binaarinen yhteensopivuus tarkoittaa sitä, että sovellusohjelmaliittymän metodien allekirjoitusten yms. ei tarvitse muuttua tavoilla, joiden seurauksena olemassa oleva käännetty ("binaarinen") koodi ei enää linkittyisi ja olisi ajokelpoista uusien 3.1-kirjastojen kanssa.

Vaikka yhteensopivuusongelmia yritettiin välttää kaikin tavoin, muutamilla alueilla on yhteensopimattomuutta. Tässä asiakirjassa on kuvattu alueet, joilla Eclipse on muuttunut yhteensopimattomasti versioiden 3.0 ja 3.1 välillä. Lisäksi siinä on ohjeet 3.0-lisäosien siirrosta 3.1-versioon.