eclipse ohje kooste1 -...

17
HELIA/TIKO Eclipse-pikaohje ©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 javadoc- ohjelmalla Tulossa versionhallinta

Transcript of eclipse ohje kooste1 -...

Page 1: eclipse ohje kooste1 - Haaga-Heliamyy.haaga-helia.fi/~ict1td002/OSIO_1_IltaTiko/.../eclipse_ohje_kooste… · Ohjelman tulos näkyy alalaidan Console välilehdellä. Sovelluksen toteutus

HELIA/TIKO Eclipse-pikaohje ©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 javadoc-

ohjelmalla

Tulossa versionhallinta

Page 2: eclipse ohje kooste1 - Haaga-Heliamyy.haaga-helia.fi/~ict1td002/OSIO_1_IltaTiko/.../eclipse_ohje_kooste… · Ohjelman tulos näkyy alalaidan Console välilehdellä. Sovelluksen toteutus

HELIA/TIKO Eclipse-pikaohje ©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 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.

Eclipsen sivusto on linkissä http://www.eclipse.org/ Lataus Eclipselle ja joillekin lisäosille alkaa linkistä http://www.eclipse.org/downloads/

Page 3: eclipse ohje kooste1 - Haaga-Heliamyy.haaga-helia.fi/~ict1td002/OSIO_1_IltaTiko/.../eclipse_ohje_kooste… · Ohjelman tulos näkyy alalaidan Console välilehdellä. Sovelluksen toteutus

HELIA/TIKO Eclipse-pikaohje ©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:

Page 4: eclipse ohje kooste1 - Haaga-Heliamyy.haaga-helia.fi/~ict1td002/OSIO_1_IltaTiko/.../eclipse_ohje_kooste… · Ohjelman tulos näkyy alalaidan Console välilehdellä. Sovelluksen toteutus

HELIA/TIKO Eclipse-pikaohje ©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):

Page 5: eclipse ohje kooste1 - Haaga-Heliamyy.haaga-helia.fi/~ict1td002/OSIO_1_IltaTiko/.../eclipse_ohje_kooste… · Ohjelman tulos näkyy alalaidan Console välilehdellä. Sovelluksen toteutus

HELIA/TIKO Eclipse-pikaohje ©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

Page 6: eclipse ohje kooste1 - Haaga-Heliamyy.haaga-helia.fi/~ict1td002/OSIO_1_IltaTiko/.../eclipse_ohje_kooste… · Ohjelman tulos näkyy alalaidan Console välilehdellä. Sovelluksen toteutus

HELIA/TIKO Eclipse-pikaohje ©Anne Benson/Tanja Bergius Opintojaksojen atk84d ja ict02d käyttöön 6/17

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ä:

Syötä Project name esim. kurssiosio1

Page 7: eclipse ohje kooste1 - Haaga-Heliamyy.haaga-helia.fi/~ict1td002/OSIO_1_IltaTiko/.../eclipse_ohje_kooste… · Ohjelman tulos näkyy alalaidan Console välilehdellä. Sovelluksen toteutus

HELIA/TIKO Eclipse-pikaohje ©Anne Benson/Tanja Bergius Opintojaksojen atk84d ja ict02d käyttöön 7/17 Source Files kansion luominen

Luokan 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

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)

Page 8: eclipse ohje kooste1 - Haaga-Heliamyy.haaga-helia.fi/~ict1td002/OSIO_1_IltaTiko/.../eclipse_ohje_kooste… · Ohjelman tulos näkyy alalaidan Console välilehdellä. Sovelluksen toteutus

HELIA/TIKO Eclipse-pikaohje ©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

Page 9: eclipse ohje kooste1 - Haaga-Heliamyy.haaga-helia.fi/~ict1td002/OSIO_1_IltaTiko/.../eclipse_ohje_kooste… · Ohjelman tulos näkyy alalaidan Console välilehdellä. Sovelluksen toteutus

HELIA/TIKO Eclipse-pikaohje ©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

workspace2

projectA

projectB

project1

project2

sourcefolderA

sourcefolderB

sourcefolder1

sourcefolder2

class1

class2

class1A2

classA

Page 10: eclipse ohje kooste1 - Haaga-Heliamyy.haaga-helia.fi/~ict1td002/OSIO_1_IltaTiko/.../eclipse_ohje_kooste… · Ohjelman tulos näkyy alalaidan Console välilehdellä. Sovelluksen toteutus

HELIA/TIKO Eclipse-pikaohje ©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 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.

File -> New->Project

Page 11: eclipse ohje kooste1 - Haaga-Heliamyy.haaga-helia.fi/~ict1td002/OSIO_1_IltaTiko/.../eclipse_ohje_kooste… · Ohjelman tulos näkyy alalaidan Console välilehdellä. Sovelluksen toteutus

HELIA/TIKO Eclipse-pikaohje ©Anne Benson/Tanja Bergius Opintojaksojen atk84d ja ict02d käyttöön 11/17

Näyttösi pitäisi olla nyt suurinpiirtein seuraavan kuvan mukainen. Jos sen sisältö on epämääräinen, valitse

?

Kun projektitiedot ovat valmiit, pääset jatkamaan

Window -> Open Perspective - > Java

Page 12: eclipse ohje kooste1 - Haaga-Heliamyy.haaga-helia.fi/~ict1td002/OSIO_1_IltaTiko/.../eclipse_ohje_kooste… · Ohjelman tulos näkyy alalaidan Console välilehdellä. Sovelluksen toteutus

HELIA/TIKO Eclipse-pikaohje ©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

Eteesi avautuu Import-dialogi. Valitse siitä File System. Tällä voit käydä valitsemassa valmiita luokkia(.java, .class) kehitettävään sovellukseen.

Import jatkuu. Valitse hakemisto, josta haluat ottaa luokkia sovelluksesi käyttöön. Tutki myös dialogin muita valintoja.

Valitse tiedostot, jotka haluat mukaan sovellukseen.

File -> Import

?

File System

Page 13: eclipse ohje kooste1 - Haaga-Heliamyy.haaga-helia.fi/~ict1td002/OSIO_1_IltaTiko/.../eclipse_ohje_kooste… · Ohjelman tulos näkyy alalaidan Console välilehdellä. Sovelluksen toteutus

HELIA/TIKO Eclipse-pikaohje ©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 Anna dialogi-ikkunassa luotavan luokan nimi. Tutki myös mitä muuta voit tehdä tässä vaiheessa.

New -> Class

Page 14: eclipse ohje kooste1 - Haaga-Heliamyy.haaga-helia.fi/~ict1td002/OSIO_1_IltaTiko/.../eclipse_ohje_kooste… · Ohjelman tulos näkyy alalaidan Console välilehdellä. Sovelluksen toteutus

HELIA/TIKO Eclipse-pikaohje ©Anne Benson/Tanja Bergius Opintojaksojen atk84d ja ict02d käyttöön 14/17

Nyt tehdään testiluokka:

?

Page 15: eclipse ohje kooste1 - Haaga-Heliamyy.haaga-helia.fi/~ict1td002/OSIO_1_IltaTiko/.../eclipse_ohje_kooste… · Ohjelman tulos näkyy alalaidan Console välilehdellä. Sovelluksen toteutus

HELIA/TIKO Eclipse-pikaohje ©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

Page 16: eclipse ohje kooste1 - Haaga-Heliamyy.haaga-helia.fi/~ict1td002/OSIO_1_IltaTiko/.../eclipse_ohje_kooste… · Ohjelman tulos näkyy alalaidan Console välilehdellä. Sovelluksen toteutus

HELIA/TIKO Eclipse-pikaohje ©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

Jos kaikki menee oikein, syntyy hakemisto jossa on APIsi:

Valitse sovellukseksi javadoc

Valitse sovellus ja luokat joista haluat dokumentaation

Anna hakemisto, mihin sovelluksen API luodaan

Page 17: eclipse ohje kooste1 - Haaga-Heliamyy.haaga-helia.fi/~ict1td002/OSIO_1_IltaTiko/.../eclipse_ohje_kooste… · Ohjelman tulos näkyy alalaidan Console välilehdellä. Sovelluksen toteutus

HELIA/TIKO Eclipse-pikaohje ©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: