Anne Benson/Tanja Bergius Opintojaksojen atk84d ja ict02d käyttöön 1/17 Eclipse 3.1 Pikaopas versio 1.0 Pikaohjeen sisältö 1. Esittely 2. Asennus ja poistaminen 3. Sovelluskehitys 4. Sovelluksen toteutus olemassaolevista ja uusista luokista 5. Sovelluksen dokumentointi javadocohjelmalla Tulossa versionhallinta
Anne Benson/Tanja Bergius Opintojaksojen atk84d ja ict02d käyttöön 2/17 1. Esittely Eclipse on sovelluskehitysympäristö (IDE Integrated Development Environment). Eclipse sisältää seuraavat osat: - editori - kääntäjä - joukko erilaisia käännöksen ja testauksen työkaluja Eclipseen voi lisätä erilaisia lisäominaisuuksia, kuten: - versionhallintatyökalu - c++ kehitysympäristö - cobol kehitysympäristö - GEF Graphical Environment Framework - VE Visual Editor - EMF Eclipse Modeling Framework - jne. Eclipsen sivusto on linkissä http://www.eclipse.org/ Lataus Eclipselle ja joillekin lisäosille alkaa linkistä http://www.eclipse.org/downloads/ Eclipsen asennus kotikoneeseen Tällä hetkellä (helmikuu 2006) Eclipsen voi asentaa koneeseen ilman admin-oikeuksia. Valitaan sopiva asennuspaketti, yleensä 32-bittinen eli työasemapohjainen versio. 64-bittiset ovat monen käyttäjän serverversioita, jotka vaativat jo käyttäjävaltuuksien organisointia yms. Tarkista ensin, että työasemassasi on Eclipsen vaatima java-alusta, joka tähän Eclipse-versioon on: JavaTM 2 SDK, Standard Edition Version 1.4.2 tai JavaTM 2 Runtime Environment, Standard Edition Version 1.4.2 Eclipsen voi ladata usealta eri palvelimelta, valitse mieluisin. Kun olet ladannut zipin, Eclipse purkautuu joko oletus- tai antamaasi hakemistoon. Jos kaikki meni oikein, on Eclipsesi käyttövalmis. Tee vielä Eclipsestä pikakuvake työpöydällesi. Eclipsen poisto kotikoneelta Eclipse ei muuta järjestelmän rekistereitä eikä ympäristömuuttujia, joten voit poistaa Eclipsen kotikoneeltasi poistamalla ainoastaan hakemiston sisältöinen, johon purit asennuspaketin.
Anne Benson/Tanja Bergius Opintojaksojen atk84d ja ict02d käyttöön 3/17 3. Sovelluskehitys Eclipsen käynnistys ensimmäisen kerran Eteesi avautuu kyselyikkuna: Eclipse kysyy, mikä on tämän istunnon työtila, workspace, mihin hakemistoon haluat tallettaa tehtävät dokumentit. Browsella pääset muuttamaan ehdotettua hakemistoa ja luomaan uusia kansioita. Suositeltava Työtilan (Workspace) asetus Anna kotihakemistosi polku \\myy\a...\ict02, missä a... = käyttäjätunnuksesi) Eclipse tallettaa kaikki syntyvät tiedostot hakemistoon, jonka polun annoit Jos hakemistossasi ei ole ennestään mainittua ict02 hakemistoa, Eclipse luo sen. Sulje Welcome välilehti Eclipsessä Tämän jälkeen eteesi avautuu tervetuloikkuna:
Anne Benson/Tanja Bergius Opintojaksojen atk84d ja ict02d käyttöön 4/17 Tervetuloikkunan kuvakkeiden selitykset Esittely: mikä Eclipse on, mitä sillä voi tehdä jne Tutoriaalit Esimerkit Mitä uutta Eclipsen tässä versiossa on, esittely Näitä kannattaa tutkia, sisältävät paljon hyödyllistä tietoa. Sulje tervetuloikkuna (saat sen uudelleen näkyviin Help-valikon Welcome-valinnasta). Eteesi avautuu java-näkökulma (perspective):
Anne Benson/Tanja Bergius Opintojaksojen atk84d ja ict02d käyttöön 5/17 Projektin luominen Seuraavaksi luodaan projekti ( = sovellus, joka muodostuu 1 - n kappaleesta komponentteja): File - New - Project Valitse Java Project ja Next
Anne Benson/Tanja Bergius Opintojaksojen atk84d ja ict02d käyttöön 6/17 Syötä Project name esim. kurssiosio1 Valitse Yes kysymykseen This kind of project is assosiated to Java Perpective. Do you want to switch to that perspective now? Tämä kannattaa tehdä, koska saat myöhemmin projektit näkyviin projektilistaan. Rastita Don't Show Me This Message Again. Uusi Projekti näkyy nyt Package Explorer näkymässä:
Anne Benson/Tanja Bergius Opintojaksojen atk84d ja ict02d käyttöön 7/17 Source Files kansion luominen Luo Projekti-tyyppisen kurssiosio1- kansion alle jokaista kurssiviikkoa kohden oma Source Files-tyyppinen kansio Valitse kurssiosio1 projekti siniseksi ja valitse ponnahdusvalikosta New Source Folder ja syötä Folder name Luokan luominen File - New - Class Anna luokalle nimi esim. Tehtava1_100 Rastita valinta public static void main(string[] args) kysymyskohdassa Which method stubs would you like to create?) (Tällöin luodaan automaattisesti main metodi luokan sisään)
Anne Benson/Tanja Bergius Opintojaksojen atk84d ja ict02d käyttöön 8/17 Nyt edessäsi on työskentelynäkymä ja voit ryhtyä koodaamaan. Ohjelman/luokan kääntäminen (Build) Katso rastia kohdassa Project - Build Automatically (Luokka käännetään automaattisesti lähdetiedoston (.java) talletuksen yhteydessä) Tallenna.java tiedosto näppäinkommennolla Ctrl+S Mahdollista käännösvirheistä tulee ilmoitus alalaidan Problems välilehdellä. Virheettömän käännöksen tuloksena syntyy.class tiedosto
Anne Benson/Tanja Bergius Opintojaksojen atk84d ja ict02d käyttöön 9/17 Ohjelman/luokan ajaminen (Run) Run -> Run As -> Java Application Ohjelman tulos näkyy alalaidan Console välilehdellä. Sovelluksen toteutus olemassaolevista ja uusista luokista Kun sovellusta ryhdytään toteuttamaan, on hyvä pitää mielessä eclipsen näkemys sovelluksen organisoinnista: workspace1 projecta sourcefoldera class1 class2 sourcefolderb projectb workspace2 project1 sourcefolder1 classa class1a2 sourcefolder2 project2
Anne Benson/Tanja Bergius Opintojaksojen atk84d ja ict02d käyttöön 10/17 1. Ensimmäiseksi täytyy aina valita tai tarkistaa, mikä on työtila (workspace), mitä käytetään. Vaihtoehtoisesti voit luoda uuden tai valita olemassaolevan. Avaa eclips. Tarkista workspace, että se on oikea. Jos edelleisellä kerralla on laitettu valinta Use this päälle, tätä kyselydialogia ei näytetä. 2. Sen jälkeen tehdään projekti. Valitse File -> New->Project Eteesi avautuu New Project -dialogi. Valitse Java-projekti ja klikkaa Next. Luo projekti, tässä esimerkissä annetaan nimeksi pankkisovellus. Tutki valintoja, mitä dialogissa näkyy.
Anne Benson/Tanja Bergius Opintojaksojen atk84d ja ict02d käyttöön 11/17? Kun projektitiedot ovat valmiit, pääset jatkamaan Näyttösi pitäisi olla nyt suurinpiirtein seuraavan kuvan mukainen. Jos sen sisältö on epämääräinen, valitse Window -> Open Perspective - > Java
Anne Benson/Tanja Bergius Opintojaksojen atk84d ja ict02d käyttöön 12/17 3. Seuraavaksi lisätään sovellukseen olemassaolevat luokat Tili, SaastoTili ja LuottoTili. Valitse File -> Import Eteesi avautuu Import-dialogi. Valitse siitä File System. Tällä voit käydä valitsemassa valmiita luokkia(.java,.class) kehitettävään sovellukseen. File System Import jatkuu. Valitse hakemisto, josta haluat ottaa luokkia sovelluksesi käyttöön. Tutki myös dialogin muita valintoja.? Valitse tiedostot, jotka haluat mukaan sovellukseen.
Anne Benson/Tanja Bergius Opintojaksojen atk84d ja ict02d käyttöön 13/17 Eteesi avautuu työikkuna, jossa pitäisi näkyä sovellukseen tuodut luokat. Luodaan testiluokka Pankki Valitse New -> Class Anna dialogi-ikkunassa luotavan luokan nimi. Tutki myös mitä muuta voit tehdä tässä vaiheessa.
Anne Benson/Tanja Bergius Opintojaksojen atk84d ja ict02d käyttöön 14/17? Nyt tehdään testiluokka:
Anne Benson/Tanja Bergius Opintojaksojen atk84d ja ict02d käyttöön 15/17 Kun koodi on valmis, ajetaan luokka. Java Perspectivessä on : rakenneikkuna editori kääntäjän/ajurin ikkuna Virheilmoitus ja virheekorjausehdotus
Anne Benson/Tanja Bergius Opintojaksojen atk84d ja ict02d käyttöön 16/17 Ajon voi käynnistää jatkossa myös pikapainikkeesta Run. Oman APIn rakentaminen Valitse sovellukseksi javadoc Valitse sovellus ja luokat joista haluat dokumentaation Anna hakemisto, mihin sovelluksen API luodaan Jos kaikki menee oikein, syntyy hakemisto jossa on APIsi:
Anne Benson/Tanja Bergius Opintojaksojen atk84d ja ict02d käyttöön 17/17 Avaa selain, IE, Netscape tai mitä nyt käytät. Valitse APIhakemisto ja klikkaa dokumenttia index.html. Dokumentaatiosi avautuu selaimeen: