Evet sevgili yazılımperver dostlarım birim testlere yönelik hususları da tamamladıktan sonra, bu yazımda alt yapısal konulardan bir diğeri olan CI/CD (Continuous Integration and Continuous Delivery/Deployment) konusuna değineceğiz.
Aşağıda verdiğim yazımda, Github actions’a yönelik olarak konuyu detaylıca aktarmıştım, onun için burada bunları bir daha açıklamayacağım.
Bununla birlikte, ilgili alt yapıyı geliştirdiğimiz uygulamaya nasıl uyarlayabiliriz ve nasıl çıktılar elde edebiliriz onlara bakıyor olacağız.
Uygulamamız için hazırlamış olduğumuz workflow’un son haline aşağıdaki adresten erişebilirsiniz:
https://github.com/yazilimperver/cpp-playground/blob/main/.github/workflows/cpp-playground.yml
Öncelikli olarak, hem linux hem de windows’u desteklemek için matrix kullanımı ile iki temel konfigürasyon oluşturacağız. Bu yazımda sadece Linux’e yönelik adımları ekliyor olacağız (siz bunu okurken windows için de gerekli adımları eklemeyi umuyorum). Gerekli ortamın hazırlanmasına yönelik adımları daha önce uEngine4 için kullandığım adımları kullanarak yazıyor olacağım. Bunları sadece SDL3 için güncelliyor olacağız.
Yukarıdaki bağlantıda SDL3 kurulumu ve ortam hazırlığı için gerekli adımları görebilirsiniz. Bizim şimdilik yazılım oluşturma ile ilgili adımlarla başlayalım:
|
1 2 3 4 5 6 7 8 9 10 11 |
# Projeyi ayarlayalim - name: Configure Application if: runner.os == 'Linux' run: cmake -S . -B build -DCMAKE_BUILD_TYPE=Release shell: bash # Yazilimi ve birim test uygulamasini oluşturalim - name: Build Application if: runner.os == 'Linux' run: cmake --build build shell: bash |
Yazılımın oluşturma adımları sonrasında aşağıdaki gibi birim testlerin koşturulmasına yönelik adımları ekliyor olacağız:
|
1 2 3 4 5 6 7 |
- name: Execute Unit Tests if: runner.os == 'Linux' run: | cd build/test ctest --output-on-failure --output-junit test-results.xml cd ../.. shell: bash |
Aşağıdaki adım ile ise test sonuçlarını yayınlıyor olacağız. Burada özellikle, test sonuçlarının oluşturulduğu dizine dikkat etmenizde fayda var.
|
1 2 3 4 5 6 7 |
# Bu adim ile Artifacts altinda test sonuçları gorunecek - name: Upload test results if: runner.os == 'Linux' uses: actions/upload-artifact@v4 with: name: ctest-results path: build/test/test-results.xml |
Sonraki adımda ise gcovr kullanarak, kapsama analizi çıktılarını oluşturup, sonrasında yayınlamaya yönelik adımlara bakıyor olacağız. Repo içerisinde, lcov vs için de gerekli betikler mevcut, aynı zamanda bir önceki yazımda da bunlara değindim. İsterseniz, onu da kullanabilirsiniz.
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 |
# ------------------------ # gcovr (HTML+XML) # ------------------------ - name: Generate coverage report (gcovr) if: runner.os == 'Linux' run: | mkdir gcovr_report gcovr --root . --exclude GoogleTest/ --xml-pretty --output gcovr_report/coverage.xml gcovr --root . --exclude GoogleTest/ --html --html-details -o gcovr_report/coverage.html shell: bash - name: Upload gcovr report if: runner.os == 'Linux' uses: actions/upload-artifact@v4 with: name: gcovr-report path: | gcovr_report/coverage.xml gcovr_report/coverage.html |
Yukarıdaki adımlara ilaveten bir de yazılımın kendisini de “artifact” olarak sunabilirsiniz. Onun için de aşağıdaki adımı eklemeniz kafi:
|
1 2 3 4 5 6 |
# Bu adim ile uygulama çalıştırılabilir dosyalar Artifacts altinda gorunecek - name: Upload built application files uses: actions/upload-artifact@v4 with: name: application-linux-x64 path: build/app/sdl3-example-app |
Evet sevgili yazılımperver dostlarım bu yazım ile birlikte aslında modern bir C++ yazılımı için ihtiyaç duyacağınız (aslında diğer programlama dilleri ile geliştirilen yazılımlar için de benzer) ve bence olması gereken kabiliyetlere , uygulamalı örnekler üzerinden geçmiş olduk. Bundan sonra, github’a yönelik birkaç hususa değinip, artık SDL3 kullanarak, farklı konulara yönelik çalışmalara devam ediyor olacağız.
Bir sonraki yazımda görüşmek dileğiyle kendinize çok iyi bakın.