Skip to content
seyhan edited this page Dec 26, 2018 · 1 revision

Kaynak kodlar ile çalışmak

Bir programcıysanız ve uygulamayı test - debug etmek istiyorsanız ya da tasarımcıysanız ve seyhan' ın temasını değiştirmek istiyorsanız aşağıdaki yönergelere göre seyhan' ın kaynak kodlarını indirebilir, değiştirip istediğiniz kadar test edebilirsiniz.

Ön hazırlıklar

Test işlemlerine başlamadan önce sisteminizde bazı düzenlemelerin ve kurulumların hazır olması gerekiyor.

İlk adımlar

  • Java JDK 8+: Uygulamanın hazırlandığı ana platformdur. Henüz kurmadıysanız şimdi tam zamanıdır. Şurada nasıl yapacağınız detaylıca anlatılıyor : Java JDK Kurulumu
  • Git Client: Kaynak kodları kendi bilgisayarınıza indirebilmeniz için seyhan' ı merkezi reposu olan Github' dan çekmeniz gerekiyor.
  • iReport: Raporların hazırlandığı programdır, raporlarınızı bu program aracılığı ile yeniden düzenleyebilirsiniz. Şuradan indirebilirsiniz : iReport Designer
  • Play Framework: Uygulamanın kullandığı geliştirme çatısıdır. Şuradan indirebilirsiniz : play-2.2.4.zip

Playframework kurulumu

İndirdiğiniz play-2.2.4.zip dosyasını uygun bir dizine açın (windows için c:\sp\play, linux için ~/sp/play olabilir, bu dizin play dizini olarak kullanılacaktır). JDK Kurulumu esnasında tanımladığımız JAVA_HOME sistem değişkeni gibi play dizini için de PLAY_HOME sistem değişkenini tanımlamalıyız. Tek farkı, Path kısmına PLAY_HOME değerini eklerken %PLAY_HOME%; yazmamız yeterli olacaktır.

Lütfen dikkat!

Github üzerinde bir kullanıcı hesabınızın olması gerkiyor, henüz yoksa şimdi oluşturmalısınız! Hesabınız yoksa ücretsiz olarak şu adreste oluşturabilirsiniz.

Git Client kurulumu

Daha önce Git Sürüm Kontrol Sistemini kullanmadıysanız şu adresteki Git Rehberi işinize çok yarayacaktır.

  • Eclipse, Netbeans ... gibi bir IDE kullanıyorsanız, plugin olarak gelen bir client' ı kullanabilirsiniz

  • Windows için harici client olarak; SmartGit' i

  • Linux için harici client olarak ise aşağıdaki client' ları kullanabilirsiniz.

    Debian, Ubuntu, Mint... için; (komut satırından)

    $ sudo apt-get install git-core
    

    Fedora, Oracle Linux, Red Hat Enterprise Linux... için; (komut satırından)

    $ su -c "yum install git-core"
    

Kaynak kodları kendi bilgisayarınıza çekme

SmartGit kullanacaksanız;

  • Project -> Clone -> Remote Git / SVN repository menüsünü açın.
  • Açılan formdaki Repository URL kısmına https://github.com/seyhanp/seyhan.git yazıp Continue butonunu klikleyin.
  • Bir sonraki adımda sizden github username ve password bilgilerinizi isteyecektir. Bu bilgileri girip sonraki kısıma geçin.
  • Son adımda uygulamanın bilgisayarınızda nereye indirileceği sorulacaktır, sizin için uygun bir dizin belirleyebilirsiniz (windows için c:\sp\seyhan olabilir)

Konsol kullanarak çekecekseniz, uygun dizine (linux için ~/sp/seyhan olabilir) geçin ve aşağıdaki komutu yazarak enter tuşuna basın, sonrasında sizden username ve password bilgilerinizi isteyecektir.

$ git clone https://github.com/seyhanp/seyhan.git

seyhan' ın yönetimi

Uygulamanın ana çatısı ve yönetim aracı olan Playframework konsol tabanlı olarak yönetiliyor. Derleme, Normal ya da Debug Modda Çalıştırma ve Durdurma işlemlerinin tamamı konsoldan yapılır. Eclipse gibi IDE' ler ise proje geliştirilirken sadece düzenleyici bir araç olarak kullanılır. Bu tür IDE'ler ile debug modda çalışabilmeniz için uzak bağlantı seçeneğini kullanmanız gerekir (ki aşağıdaki kısımlarda nasıl yapabileceğiniz anlatılıyor). Yukarıdaki adımlarda Playframework' ü nasıl indirip sisteme tanıtacağımızı görmüştük, bu kısımda ise, uygulamayı nasıl yöneteceğimizi göreceğiz. Bunun için öncelikle temel Playframework komutlarını görelim;

Temel komutlar

  • Eclipse uygun proje yapısının oluşturulması için eclipse
  • Netbeans' e uygun proje yapısının oluşturulması için netbeans
  • IntelliJ' ye uygun proje yapısının oluşturulması için idea
  • clean : Çok fazla derleme ve test işlemlerinden sonra (ihtiyaç olması durumunda) derlenmiş olan sınıfları temizlemek için kullanılır. Derleme adımlarının tüm sınıflar için yeniden ve tam olması istendiği durumlarda kullanılabilir.
  • compile : Playframework otomatik olarak değişen sınıfları algılar ve derleme işlemlerini yapar, fakat bazen bu işlemler tam da istendiği gibi olmaz. Bu durumlarda compile komutu kullanılır. Genellikle clean komutundan sonra kullanılır.
  • run : seyhan' ı test modda çalıştırır. Bu komutu verdikten sonra tarayıcınızdan http://localhost:9000 yazarak uygulamaya erişebilirsiniz.
  • debug : seyhan' ı debug modda çalıştırır. Bu komutu verdikten sonra da yine run komutunda olduğu gibi tarayıcınızdan uygulamaya erişebilirsiniz.

Komutların kullanımı

Aşağıdaki komutları çalıştırabilmek için, komut satırından uygulamanın ana dizinine girin (windows için c:\sp\seyhan, linux için ~/sp/seyhan olabilir)

Projeyi kullanmak istediğiniz IDE' de açmak için aşağıdaki komutları çalıştırdıktan sonra IDE' nin Import Existing Proıject seçeneğini kullanabilirsiniz.

  • Projeyi Eclipse' te açacaksanız play eclipse
  • Projeyi Netbeans' de açacaksanız play netbeans
  • Projeyi IntelliJ' de açacaksanız play idea

Uygulamayı yönetmek için aşağıdaki komutları kullanabilirsiniz.

  • Temizlik için play clean
  • Kodları derlemek için play compile
  • Test modda çalıştırmak için play run
  • Debug modda çalıştırmak için play debug

yazıp enter tuşuna basın.

Çalıştırma

  • Konsoldan seyhan' ın olduğu dizine girin

  • Normal modda çalıştırmak istiyorsanız : play run komutu ile,

  • Debug modda çalıştırmak istiyorsanız da : play debug run komutu ile uygulamayı çalıştırın

  • Aşağıdaki gibi satırları gördüğünüzde uygulama çalışmış demektir. Web tarayıcınızdan http://localhost:9000 adresi ile uygulamanıza erişebilirsiniz.

  • Programı durdurmak için de yine çalıştırdığınız konsoldayken ctrl+d tuş kombinasyonunu kullanabilirsiniz.

    /home/mdpinar/projects/seyhan$>play run [info] Loading project definition from /home/mdpinar/projects/seyhan/project [info] Set current project to seyhan (in build file://home/mdpinar/projects/play/seyhan/)

    --- (Running the application from SBT, auto-reloading is enabled) ---

    [info] play - Listening for HTTP on /0.0.0.0:9000

    (Server started, use Ctrl+D to stop and go back to the console...)

Eclipse' i kullanma

Kodlarla çalışmaya başlamadan öncelikle bir kereliğine konsoldan play eclipse komutu ile projeyi Eclipse proje ağacı yapısına göre yapılandırın. Daha sonra Eclipse' i açıp Import seçeneği ile uygulamayı aktarın. Proje çalışır durumdayken istediğiniz kadar kodları düzenleyebilirsiniz.

Debug modda Eclipse' i kullanma

  • Bir üst kısımda anlatılan işlemleri yaptıktan sonra sırasıyla aşağıdaki işlemleri yapın
  • Debug Configurations menüsünden, Run -> Edit Configurations menüsünü seçin
  • Sol kısımdaki Remote Java Application kısmına yeni bir konfigurasyon ekleyin
  • Bir isim verin, ve aşağıdaki alanları karşılık şu değerleri verin;
    • Connection Type: Socket Attach
    • Host: localhost
    • Port: 9999
    • Apply ve sonrasında Debug butonunu klikleyerek Run/Debug Configurations dialoğunu kapatın.

bu işlemlerden sonra Eclipse ile debug modda çalışan uygulamamız arasında bağlantı kurulmuş olacak.

iRepor ile çalışma

iReport programı görsel bir rapor tasarım programıdır. Kullanımı oldukça basittir. seyhan' ın raporları uygulama dizini altındaki reoprts dizini içerisinde bulunur. Düzenlediğiniz raporlar için programı durdur-başlat, temizleme, derleme... yapmanıza gerek yoktur!

İşinize yarayabilir

  • Uygulamayı bir kere run komutu ile çalıştırdıktan sonra durdurmaksızın istediğiniz kadar değişiklik yapıp, tarayıcınızı refresh yaparak yaptığınız düzenlemeleri görebilirsiniz.
  • Veritanabanı ayarı ilk kurulumla birlikte h2db olarak gelir (isterseniz application.conf dosyasından değiştirebilirsiniz). Bu veritabanı test işlemleriniz için oldukça uygundur. Default kurulum dizini olarak seyhan' ın kaynak kodlarının olduğu dizin içerisinde h2db dizinidir. Veritabanı ile ilgili herhangi bir sorun yaşarsanız; programı durudurun, h2db dizinini silin. Tekrar çalıştırdığınızda sıfırdan veritabanı oluşacaktır.