Lisäosaprojektin luonti

Eclipse-lisäosien koontiin voi käyttää mitä tahansa Java-IDE-kehitysympäristöä, mutta Eclipse SDK -ympäristön työkalut on tarkoitettu erityisesti lisäosien kehitykseen. Seuraavassa käydään läpi lisäosan luonnin vaiheet Eclipse SDK -ympäristössä, koska se on yleisin lisäosien luontiin käytetty ympäristö. Jos et tunne vielä Eclipse-työympäristöä ja Java-IDE-kehitysympäristöä, Java-kehityksen käyttäjän oppaasta tai lisäosien kehitysympäristön oppaasta löytyy tarkempia selityksiä koonnin vaiheille. Aluksi keskitytään koodiin, ei työkaluun. Koonnin aloittamisvaiheessa pitää kuitenkin ottaa huomioon joitakin IDE-kehitysympäristöön liittyviä asioita.

Lisäosaprojektin luonti

Luo ensin työn sisältävä projekti. Lisäosien kehitysympäristön koodinmuodostustoimintoja voi hyödyntää tässä mallipohjana. Näin voidaan Java-koodin kirjoittamista varten määrittää projekti ja luoda lisäosan oletus-manifest-tiedostot (joista lisää myöhemmin) sekä luokka, joka sisältää näkymän.

  1. Avaa ohjattu toiminto Uusi projekti ( Tiedosto > Uusi > Projekti) ja valitse Lisäosaprojekti luokasta vaihtoehto Lisäosien kehitys ja napsauta Seuraava-painiketta.
  2. Lisäosaprojekti-sivulla määritä projektin nimeksi com.example.helloworld ja valitse ruutu Luo Java projekti (tämän pitäisi olla oletusarvo). Jätä tämän sivun muut asetukset oletusarvoisiksi ja napsauta Seuraava-painiketta, jolloin hyväksyt lisäosan projektin oletusrakenteen.
  3. Tarkista, mitkä ovat oletusasetukset Lisäosan sisältö-sivulla. Ohjattu toiminto määrittää, että lisäosan tunnus on com.example.helloworld. Ohjattu toiminto myös luo lisäosaa varten lisäosaluokan ja mahdollistaa sen, että voit antaa sille lisätietoa käyttöliittymään lisäämisestä. Oletusasetukset voi hyväksyä sellaisinaan, joten etene seuraavaan vaiheeseen napsauttamalla Seuraava-painiketta.
  4. Mallipohjat-sivulta valitse ruutu Luo lisäosa jonkin mallipohjan avulla. Valitse sitten mallipohja Lisäosa ja näkymä. Napsauta Seuraava-painiketta.
  5. Esimerkin tarkoitus on luoda hyvin suppea lisäosa, joten tässä vaiheessa oletusasetuksia pitää muuttaa, jotta lisäosa pysyy mahdollisimman yksinkertaisena. Muuta Päänäkymän asetukset-sivulta oletusasetukset seuraavasti: Lisäosan näkymän asetukset
  6. Poista Näkymän ominaisuudet-sivulla valinnat kaikista ruuduista, jotta lisäosaan ei luoda mitään ylimääräisiä ominaisuuksia. Napsauta Valmis-painiketta, jotta saat luotua projektin ja lisäosan perusrakenteen.
  7. Kun ympäristö kysyy, haluatko siirtyä lisäosien kehitysperspektiiviin, vastaa Kyllä.
  8. Siirry projektiin ja perehdy sen sisältöön.

Projektin perusrakenne sisältää useita kansioita, tiedostoja ja Java-paketin. Tässä vaiheessa tärkeimpiä tiedostoja ovat plugin.xml ja MANIFEST.MF sekä lisäosan Java-lähdekoodi. Ensin perehdytään näkymän toteutukseen, sitten manifest-tiedostoihin.