Geliştirme Ortamı Kurulumu(Frontend)¶
Geliştirme Ortamının Hazırlanması¶
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.
Nodejs’yi indirin ve kurun.
- https://nodejs.org/download/
- Debian, Ubuntu, FreeBSD vs diğer dağıtımlarda kurulum için nodejs sayfasından faydalanabilirsiniz.
Bower’ı kurunuz
npm install bower
bower.json içinde listelenen paketleri yüklemek için
bower install
komutunu çalıştırınız.package.json içinde listelenen paketleri yüklemek için
npm install
komutunu çalıştırınız.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.
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ı.