Geliştirme Ortamı Kurulumu(Frontend)

Geliştirme Ortamının Hazırlanması

  1. git clone git@github.com:zetaops/ulakbus-ui.git reposunu indirin.

    git kullanımını bilmiyorsanız, aşağıdaki bağlantılardan yardım alabilirsiniz.

  2. Nodejs’yi indirin ve kurun.

  3. Bower’ı kurunuz npm install bower

  4. bower.json içinde listelenen paketleri yüklemek için bower install komutunu çalıştırınız.

  5. package.json içinde listelenen paketleri yüklemek için npm install komutunu çalıştırınız.

  6. Tüm paketlerin yüklenmesininin ardından aşağıdaki komut sayesinde http server ‘ı çalıştırabilirsiniz.

    npm start

Uygulamayı sunmak için başka http server kullanabilirsiniz.

Geliştirme Döngüsü

Şu an gerekli repo’ya sahipsiniz, npm ve bower kurulumunu gerçekleştirdiniz ve geliştirmeye başladınız.

Daha ileri programlama teknikleri kullanımları için, http://www.extremeprogramming.org/introduction.html sitesinde gösterilen geliştirme döngülerini takip etmenizi öneririz.

_images/planning_feedback_loops.png

Kodlarken aşağıdaki adımları izleyiniz.

  • Yeni bir tane branch oluşturun. Örnek olarak(e.g: search_func)
  • git checkout <branch>
  • git pull --rebase
  • Verilen görev için bir branch oluşturup master branch’i rebase ettikten sonra, kodunuzu yazabilirsiniz.
  • Kodunuzu denemek için testler yazınız.
  • Testlerinizi çalıştırınız.
  • Push yapmadan önce tekrardan master branch’i rebase edin git pull --rebase
  • Şimdi push yapabilirsiniz git push origin <branch>

Test

~/_test.js dosyaları, Jasmine içindeki birim test dosyalarıdır , çalıştırmak için aşağıdaki komutları çalıştırabilirsiniz:

npm test

Bu komut testleri bulacak ve sonucu ekrana yazdıracak.

e2e-tests klasörü altındaki e2e-testlerini çalıştırmak için protractor kullanınız. Aşağıdaki komutu çalıştırabilirsiniz.

protractor e2e-tests/protractor.conf.js

Prensipler

Git:

  • Asla master branch üzerinde çalışmayın. İlgili issue üzerinden yeni branch açınız.
  • Hiçbir zaman MASTER BRANCH’e doğrudan commit etmeyin!
  • Bir kerede çok fazla sayıda değişiklik commit etmeyiniz. Mümkün oldukça az sayıda değişikliği commit ediniz.

Kod:

  • DRY - don’t repeat yourself(kendini tekrarlama)!!! Bunu okuyunuz. https://en.wikipedia.org/wiki/Don%27t_repeat_yourself
  • Kodunuzu yazarken açıklamalarda bulununuz.
  • Kodunuz düzenli ve açık olsun.
  • Değişken isimleri ve nesneler açıklayıcı şekilde olmalıdır.

Test:

Daha etkili testler yazmak için http://www.softwaretestinghelp.com/how-to-write-effective-test-cases-test-cases-procedures-and-definitions/ sitesinden yardım alabilirsiniz.

Testler olabildiğince kodunuzu kapsamalı.