Calculator - Java + Maven ders şablonu¶
Dönem projesi için eksiksiz, test edilmiş bir başlangıç noktası: Java 17, Maven, JUnit 5, JaCoCo ve ReportGenerator ile kapsama, Javadoc ve Doxygen ile API belgeleri ve bu site - her rapor Windows ve Linux'ta üretilir, her sürüm dosyası yerelde ve GitHub'da aynı biçimde adlandırılır.
Başlangıç¶
-
Kılavuz
Kurulum, şablonu kullanma, proje konusunu kendi projenize çevirme, günlük çalışma, sorun giderme.
-
English / Türkçe
Tüm site - kılavuzlar, rapor sayfaları, indirmeler - iki dilde de var. Başlıktaki dil seçiciyi kullanın.
-
GitHub Pages olmadan projenizi gösterin
GitHub Free'de özel depo mu? Tam siteyi yerelde derleyip açın, gösterim kontrol listesiyle.
-
Adlandırma standardı ve site kuralları
Betik adları, klasörler, sürüm dosyaları ve bir raporun ne zaman çerçevelenip ne zaman kendi başına açıldığı.
Raporlar - Windows ve Linux yan yana¶
-
Windows
Birim testleri, kapsama (JaCoCo ve ReportGenerator), dokümantasyon kapsaması, Doxygen, Javadoc.
-
Linux (WSL dahil)
Aynı takım Linux'ta üretildi - sayılar ve görünüm hafifçe farklı olabilir.
-
Hangi rapor hangisi?
Native araç ve ReportGenerator; her raporun neden iki kez var olduğu.
-
API belgeleri
Doxygen, Javadoc ve JXR çapraz başvuruları, platform başına.
-
İndirmeler
Her sürüm dosyası: uygulamalar, rapor arşivleri, kaynak, site, sağlama toplamları.
-
Maven sitesi (native)
Checkstyle, PMD, CPD, SpotBugs, Surefire - yalnızca Maven'in üretebildiği sayfalar, kendi sekmesinde.
Betikler tek tabloda¶
Aynı numara = her ders şablonunda aynı iş; platform sonektir (-windows.bat, -linux.sh; WSL de Linux'tur).
| # | İş | Windows | Linux / WSL |
|---|---|---|---|
| 1 | Git kancalarını kur | 1-configure-git-hooks-windows.bat |
./1-configure-git-hooks-linux.sh |
| 3 | Paket yöneticisini kur | 3-install-package-manager-windows.bat |
- |
| 4 | Araçları kur | 4-install-tools-windows.bat |
./4-install-tools-linux.sh |
| 5 | Kodu biçimlendir | 5-format-code-windows.bat |
./5-format-code-linux.sh |
| 6 | Derle + birim testleri (hızlı) | 6-build-and-test-windows.bat |
./6-build-and-test-linux.sh |
| 7 | Her şey: raporlar, API belgeleri, siteler, release/ |
7-build-all-windows.bat |
./7-build-all-linux.sh |
| 8 | Uygulamayı çalıştır | 8-run-app-windows.bat |
./8-run-app-linux.sh |
| 9 | Siteyi http://localhost üzerinde aç | 9-open-site-windows.bat |
./9-open-site-linux.sh |
| 10 | GitHub CLI ile sürüm yayınla | 10-release-windows.bat |
./10-release-linux.sh |
| 11 | Temizle | 11-clean-windows.bat |
./11-clean-linux.sh |