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.
- Avaa ohjattu toiminto Uusi projekti (
Tiedosto > Uusi >
Projekti)
ja valitse Lisäosaprojekti luokasta vaihtoehto Lisäosien kehitys ja napsauta
Seuraava-painiketta.
- 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.
- 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.
- Mallipohjat-sivulta valitse ruutu Luo lisäosa jonkin mallipohjan
avulla. Valitse sitten mallipohja Lisäosa ja näkymä.
Napsauta Seuraava-painiketta.
- 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:
- Muuta Java-paketin nimi muodosta
com.example.helloworld.views muotoon com.example.helloworld
(näkymälle ei tarvita erillistä pakettia).
- Muuta Näkymäluokan nimi (class) muotoon HelloWorldView.
- Muuta Näkymän nimi muotoon Hello View.
- Jätä Näkymän luokan tunnus (category) oletusasetuksen mukaiseksi
(com.example.helloworld).
- Muuta Näkymän luokan nimi (category) muotoon Hello
Category.
- Jätä katseluohjelman laji oletusarvon mukaiseksi (Table
viewer - tätä tosin muutetaan koodissa vielä yksinkertaisemmaksi).
- Poista valinta ruudusta Lisää näkymä resurssiperspektiiviin.
- Napsauta Seuraava-painiketta, jotta pääset seuraavalle sivulle.
- 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.
- Kun ympäristö kysyy, haluatko siirtyä lisäosien kehitysperspektiiviin, vastaa
Kyllä.
- 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.