Make your own free website on Tripod.com
Eclipse ile Tspell projesinin indirilip calistirilmasi

Ben her ne kadar uzun suredi IntelliJ IDEA kullanicisi olsam da gerek bedava olmasi gerekse cogu yonden IDEA kadar guclu bir gelistirme ortami olmasindan dolayi Tspell projesinin indirilme ve derlenme asamalarini Eclipse uzerinden anlatacagim. Bu yazi ile sadece Tspell degil hemen her tur java projesini de Eclipse uzerinden kurabilme bilgisini umarim ki edineceksiniz. Eclipse ile acemi oldugumdan hata yapabilirim affola. Yazidaki kirmizi ile yazilan yerler sabirsiz okuyucular icin yapilmasi gereken oz islemi gosteren cumleler ama ozellikle eclipse ve javaya yeni basliyorsaniz, CVS konusunda yeni iseniz herseyi okumanizi oneririm. elimden geldigince basit bicimde anlatmaya calistim, hata ve eksiklik ya da anlasilmayan, calismayan yerleri ahmetaaATcaribeNOKTAnet adresine gonderebilirsiniz

1- Oncelikle www.eclipse.org adresinden en son 3.0Stream Stable surumu indirin (su anda 3.0RC2 surumu en sonuncusu.). Aslinda henuz 3.0 final surumu cikmadi ama bu  yeterince saglam sayilabilir. Riskli olsa da maceracilar icin yazilimda yeni surumleri tercih etmek iyidir. http://eclipse.org/downloads/index.php  adresinden ana eclipse sunucusundan (ya da cok yuklu olma ihtimali kuvvetli oldugundan cografi olarak yakin bir yansi (mirror) uzerinden) cekebilirsiniz. Windows XP Professional icin kurulumu anlatiyorum, linux uzerinden kurulumda belki fazladan bir de JRE cekmeniz gerekebilir. Zip dosyasi yaklasik 80-90MB civarinda hizli bir baglanti uzerinden cekin derim.

2- zip dosyasini c:/eclipse olacak sekilde ana dizine acin. Farkli dizinler ya da diskler uzerinden de calisir ama bendeki kurulum boyle oldugundan takip kolayligi acisindan bu sekilde yapin. (dosyalar zip'in icinde zaten /eclipse/... seklinde. yani dosyayi dogrudan c:'ye acarsaniz hallolur.)

3- c:/eclipse dizinine gidin. orada eclipse.exe dosyasini goreceksiniz. calistirin bu dosyayi. ilk kurulum oldugundan bir sure sonra projelerinizin yer alacagi yeri soran bir diyalog karsiniza cikacak (adi workspaceLauncher) normal kosullarda sistem size c:/eclipse/workspace/ dizinini onerir. biz de buna uyalim ve "Ok" ile kuruluma devam edelim.
Biraz calismadan sonra eclipse bir hosgeldiniz ekrani ile acilir. kurulum bundan ibaret. Windows installer yazilimlarindan hoslanmayan birisi olarak bu tam istedigim bir sey. yani uninstaller vs gerek yok. Bu mavi hosgeldiniz  ekraninda cesitli secenekler, egitim ve yardim araclari var. Aslinda cok faydali olabilir ama biz dogrudan tspell kurulumuna gececegiz. Bu nedenle ustteki "welcome" basliginin yanindaki carpi isaretine basarak bu ekrani kapatiyoruz.

Eclipse'in gorunusu oldukca hos Hatta en guzel gorunumlu IDE bile diyebilirim. Ancak eclipse kullanirken biraz saglam bir sisteminiz olmasini oneririm. mumkunse en az 512MB bellekli bir sistem. yazilim gelistirme ortamlari akillanip guclendikce daha cok sistem kaynagi tuketir hale geliyor. Eclipse'in nasil kullanilacagi oldukca uzun bir hikaye, o nedenle ben sadece en kisa yoldan proje kurulumunu anlatmaya calisacagim. Simdi su adimlari gerceklestirin:

Resimde sag ust kosedeki Resource yazan dugmenin solundaki dugmeye basarak ya da bolumunde muhtelif secenekler var. Bu seceneklerden birisi [CVS repository exploring] adinda. eger ilk seceneklerde goremezseniz en menuden [window->open perspective]alttaki [Other] alt menusunu secin. Bir pencere gelecek, burada secebilirisniz. RC2 surumunde nasil olduysa CVS secenegini iyice gizlemisler, ilk kurulumda menude gozukmuyor, Other deyince gelen pencerede de gozukmuyor, alttaki "Show all" kutucuguna tiklayinca ancak gorunuyor. CVS repository exploring secenegini secip onaylayin.



Secince sizden bu islemin CVS destegini gerektirdigine, aktif hale gecirip gecirmyecegine dair onay soruyor Ok deyip gecin, hatta kutucugu da isaretleyin bir daha sormasin.



Bir anda tum ekranin degistigini goreceksiniz. Eclipse'in en belirgin ozelliklerinden biri budur. Yani yapilan ise gore ekrandaki pencereler, menuler vs degisebilir. Buna alismak biraz zaman alabilir ama biraz dusununce bunun oldukca yararli bir sey oldugu gorulebilir. Neyse, CVS nedir sorusu akliniza gelebilir. bunun icin de ayri bir yazi yazmak gerekir herhalde. Buna vaktimiz yok, birkac cumle ile CVS'i yaziliminin tum surumlerinin saklandigi bir depo olarak dusunebilirisniz. depodan yazilimin son halini ya da herhangi bir andaki halini cekebilir, degisiklikleri de gene depoya gonderebilirsiniz. Yani verinin kaybolmasi diye bir sey soz konusu degildir.
Simdi yapmamiz gereken sey su, Menuden New->Project seciyoruz. Asagidaki ekran karsimiza gelir. sekilde gosterildigi gibi seceneklerden CVS, ve Checkout Projects from CVS'i seciyoruz. Yani amacimiz projeyi uzaktaki CVS deposundan cekmek.



Next ile yeni yeni ekrana geciyoruz. Burada Projeyi  CVS deposundan yeni bir "Java" projesi olarak ekmek istedigimizi soyluyoruz. Eclipse her ne kadar java ile gelistirilip asil java odakli yazilim gelistirme ortami olsada farkli diller (C++, php gibi) icin de kullanilabilir. o nedenle dogrudan cekmek projenin java projesi olarak gorulmesine yetmiyor. umarim bu konuda biraz dah gelistirme ve kolaylik saglarlar. Bunun icin en ustteki "Check out as a project configured using the New Project Wizard" secenegini isaretleyin.



Next ile devam edin, yeni pencerede CVS deposundaki hangi surumu cekmemiz istendigi soruluyor. HEAD isaretleyip Finish tusuna basin. Bu sekilde yazilimin en son halinin sisteme yuklenmesi saglanacak. (Aslinda bu tam olarak dogru degil ama CVS konusunda simdlik derine inmeyecegiz)



Tspell'in  CVS deposuna erisim icin gerekli bilgileri girecegimiz ekrana geldik. Tspell, bir java.net projesi oldugundan java.net'in cvs deposunda yer aliyor. Bu deponun adresi cvs.dev.java.net  Bu bilgiyi Location->Host bolumune yaziyoruz. Deponun ana dizini ise /cvs (Burada bir not: java.net'in anonymous baglanti verdigini tahmin ediyorum, yani java.net uyesi olmadan da kodu indirebilirsiniz diye tahmin ediyorum, ama hic denemedim, ileride ogrenip bu konuda bigi de verebilirim. su an icin bir kosu java.net uyesi olursniz bu isi kolaydan halledebiliriz.). bu bilgiyi de Repository path alanina yaziyoruz. Daha sonra java.net kullanici adi ve sifrenizi Authentication bolumune yaziyorsunuz. Asagidaki save password alanini isaretlerseniz bu CVS deposu icin sifreniz saklanir tekrar tekrar girmek zorunda kalmazsiniz. Next ile devam edelim.



Simdi depo adresini soyledik ama java.net'te dunya kadar proje var, bunlardan hangisini sececegimizi belirtecegimiz ekrana geldik. CVS altindaki her bir ana dizine module adi verilir. tspell de java.net ana CVS deposunun bir modulu. Gelen ekrandaki bosluga "tspell/tspell" yazin ve next ile devam edin. (Not: iki tane tspell yazilmasi benim projeyi ilk defa java.net'e atarken yaptigim bir hatadan kaynaklaniyor. normalde sadece tspell yazmak yetecekti. ne yapalim oldu bir kere.)



Tekrar yeni proje ekrani gelecek. Bu defa java Project secenegini secip Next ile devam ediyoruz.



Gelen ekranda java projemize isim veriyoruz. en ustteki alana tspell yazin. Daha sonra altta yer alan Project layout bolumunde ikinci secenek olan "Create separate source and output folders" secenegini secin. Bu aslinda cok gerekli degil ama ben projelerimde kaynak kodlari ve derleme sonucu olusan class dosyalarini ayri yerlerde tutmayi tercih ediyorum. daha temiz oluyor. gelen yerde hic bir sey  yapmadan Next ile devam edince Finish secin. aslinda next yapmadan dogrudan finish'te isaretleyebilirisiniz.



Simdi baglanti hiziniza gore epeyce bir bekleme yasayacaksiniz. Eclipse projeyi hedeften indirip tspell adiyla yeni proje olusturup bunu ana ekranda acacak. Tspell'in kodu sozluk ve corpus dosyalarindan dolayi epey buyuk. saniyorum  1.5 MB civarinda veri indirilecek. bu sadece bir kere gereken bir sey, daha sonra yerel sistem uzerinden calisilacak.
Indirme isleminden once asagidaki gibi bir onaylama ekrani gelebilir. "Yes" secerek gecin. "Remember my desicion" kutusunu da isaretlerseniz bir daha sormaz.



Proje tamamen indirildikten sonra ekranin gene degistigini goreceksiniz. Solda proje dosyalarinin yer aldigi bir alan yer alir. Sistem bu sirada oldukca yogun bir islem gerceklestirir. Bu yuzden bu ekran geldikten sonra biraz gecikme yasayabilirsiniz. Modern yazilim gelistirme ortamlari kod yazma sirasinda yazilimciya cok buyuk kolayliklar getirir. Akilli kod tamamlama, hatalari aninda gosterme gibi. Projenin Bu konulardaki gerekli verilerini bu sirada sistem hazirlar. Ve ne yazik ki ilk anda pek cok hatanin oldugunu goreceksiniz. Cunku sistem yazilim icinde kullanilan kutuphaneleri bulamayacaktir. Packet Explorer adindaki alanda bazi dugumlerde kirmizi beyaz carpi isaretleri goreceksiniz. bu o dugumlerdeki kodlarda hata oldugunu gosterir. merak etmeyin hatalari giderecegiz.



Bunun icin menuden [Project->Properties]'i secin. yapacagimiz iki sey var burada. Oncelikle sistemin bulamadigi kutuphaneleri Eclips'e gosterecegiz. Bunun icin agac yapisindan "Java build path' secenegini secin. Gelen yan ekranda Liraries, tabini secin. Burada proje kutuphanelerine dair bilgi yer alir. Sagdaki dugmelerden "Add Jars"'i secin. minik bir pencere gelecek. burada tspell icindeki jar kutuphane dosyalari gorulebilir. tum jar dosyalarini ayri ayri ya da topluca (CTRL'ye basili tutup tiklayarak) secip ekleyin.



Yapacagimiz ikinci sey sisteme kaynak kodlarini gostermek. Bunun icin Source Tabini secin ve gelen agac yapisindan sekilde goruldugu gibi "test" ve "resources->config" kutularini secin (resimde test isaretlenmemis, siz isaretleyin). Aslinda bunu yapmasakta yazilim calisirdi ama ilerde faydasini gorecegiz.



Tamam deyince sistemdeki hatalarin kayboldugunu goreceksiniz. Artik yazilim calistirmaya hazir vaziyette.


Calistirma islemi icin menuden [Run->Run] secin. Gelen ekranda muhtelif secenekler gorecesiniz. Eclipse java uygulamasi, applet ya da unite  testi uygulamalari gibi cesitli secenekler sunar. Tspell'i test etmek icin once kullanici arayuzunu calistirmayi deneyelim. Bu sonucta bir java uygulamasi oldugundan Soldaki configurations alaninda Java Application secilip alttaki new tusu ile yeni bir java uygulama konfigurasyonu olusturuyoruz. Amacimiz arayuzu calistirmak olduguna gore bu konfigurasyona arayuz adini ustteki Name alanina yazarak veriyoruz.



Java uygulamalarinda malumunuz oldugu gibi birden fazla main metodu yani baslangic noktasi olabilir. bu nedenle hangi main metodunu istedigimizi secmek icin Main class alanindaki Search dugmesine basiyoruz. gelen minik pencereden "Main" yazan satiri seciyoruz. bu arayuz icin yazilan min metodu. nereden biliyorum? isterseniz kodda src->org.tspell.gui.swing paketi altindaki Main sinifina bakin. orada main sinifi goreceksiniz. Run dedigimizde eger hersey yolunda ise Tspell calisacaktir.



Tspell arayzunu kapatip baska bir main sinifi daha ekleyelim (kpatmazsaniz calismaya devam eder. ayri ayri pek cok uygulama ayni anda calistirilabilir), mesela Tspell sozlugunu kilavuz dosyasindan olusturan uygulamayi olusturalim. gene menuden Run->run secip java app isaretleyip new ile yeni bir uygulama olusturalim. ismine bu defa sozluk_olustur diyelim. main metod olarak listeden SozlukAraclarini secin ve onaylayin. Run ile calistirdiginizda Bu defa ekrana hic bir pencere vs gelmeyecektir. Cunku bu arayuz uygulamasi degil, konsola cikis verir.




Konsolda kac tane kelimenin okunduguna dair bir cikti goreceksiniz.



Simdilik bu kadar. Aslinda anlatacak dunya kadar konu var . CVS kullanimi aslinda sandiginizdan daha kolay. Yani eclipse olmadan disaridan baska programlar vasitasiyla ya da konsoldan cvs yazilimlari ile iki komutla tum proje oldugu gibi indirilebilir. Ama takim calismasi gereken durumlarda bu sekilde gelistirme ortami ile butunlesik sistemler her zaman daha basarili olmustur. Bundan sonraki yazida test konusuna deginmeye calisacagim. Tabi asil konu olan tspell projesinin yapisi hala bekliyor bir kenarda. umarim ona da sira gelecek. Biraz daha olgunlassin, daha iyi olur. Eclipse ve CVS konusunda deneyimi olmayanlar icin alistirma:

gene java.net icindeki "bouldercat" projesini cekip calistirmayi deneyin.. Junit kutuphanesini bulamama durumunda ecpilse icinden gerekli dosyayi bulmayi deneyin..

Eclipse icin bir kac kucuk not: kod  fontu olarak luicida console 9 punto secerseniz guzel gorunuyor.. (window->preferences, workbench->font-colors->java)