← C++

C++ · 15 / 24

Reproduzierbare Desktop-Builds und Pakete

Du baust und testest getrennte Konfigurationen und prüfst ein installierbares Paket.

  • Groß
  • Anspruchsvoll
  • 90 min

Voraussetzungen: Header, CMake und erste Unit-Tests, Deine erste Qt-Oberfläche mit Signals und Slots, Hintergrundarbeit, Performance und Desktop-Pakete

In diesem Tutorial
  1. Den Vertrag festlegen
  2. Werkzeuge und Build trennen
  3. Beobachtbare Erwartungen prüfen
  4. Eine falsche Änderung erkennen
  5. Die Übung getrennt ausführen
  6. Grenzen des Nachweises einordnen
  7. Übung und Lösung
  8. Projektbezug und Quellen

Lernpaket herunterladen

Einrichtung und Prüfstand

GCC mit C++20 und CMake ab 3.25. Zusätzlich Python 3 für den gemeinsamen Prüfstart. Entpacke das Lernpaket in einen neuen Ordner und führe dort python3 run_checks.py aus. Das Skript kopiert die enthaltenen Dateien in einen temporären Lernordner. Dort prüft es zuerst das Beispiel und danach die mitgelieferte Lösung. Die Ausgangsdateien bleiben erhalten. Benötigte Pakete werden beim ersten Lauf aus dem Netz geladen.

Geprüft am 21.10.2026 unter Linux x86_64. Der Linux-Prüflauf baut, testet und paketiert das kleine Programm. Die Windows-Matrix ist vorbereitet. Ihre erfolgreiche Ausführung muss auf einem echten Windows-Runner separat belegt werden.

Ein Buildverzeichnis enthält Zustände für Compiler, Generator und Konfiguration. Getrennte Verzeichnisse verhindern, dass ein alter Debug-Build versehentlich als Release ausgeliefert wird. CTest prüft Verhalten, install legt die Lieferstruktur fest und CPack erstellt das Archiv. Reproduzierbar bedeutet hier dokumentierte Eingaben und wiederholbaren Ablauf, keine behauptete Bytegleichheit verschiedener Compiler.

Paketinhalt und einzelne Dateien

01Den Vertrag festlegen

CMake beschreibt Ziele, Abhängigkeiten und Installation. CPack erstellt daraus ein Paket. Die Zielplattform entscheidet über Laufzeitbibliotheken und Paketformat. Ein Linux-Build validiert keine Windows-Binärdatei.

main.cpp · cppDatei öffnen
#include <iostream>
#include <string>
int main(int argc, char **argv) {
  if (argc == 2 && std::string(argv[1]) == "--self-test") {
    std::cout << "self-test passed\n";
    return 0;
  }
  std::cout << "Factory learning 1.0\n";
}

Starten / prüfen

python3 verify.py

02Werkzeuge und Build trennen

Lege alle Dateien in einen neuen Ordner. Lies die Compileroptionen und führe verify.py aus. Der Rückgabecode eines fehlgeschlagenen Befehls muss bis zum Aufrufer erhalten bleiben.

verify.py · pyDatei öffnen
import subprocess

subprocess.run(["cmake", "-S", ".", "-B", "build"], check=True)
subprocess.run(["cmake", "--build", "build", "--config", "Release"], check=True)
subprocess.run(
    ["ctest", "--test-dir", "build", "-C", "Release", "--output-on-failure"], check=True
)
subprocess.run(
    ["cmake", "--install", "build", "--prefix", "delivery", "--config", "Release"],
    check=True,
)
subprocess.run(
    ["cpack", "--config", "build/CPackConfig.cmake", "-C", "Release"], check=True
)
from pathlib import Path
import os

name = "lesson.exe" if os.name == "nt" else "lesson"
subprocess.run([str(Path("delivery/bin", name).resolve()), "--self-test"], check=True)

03Beobachtbare Erwartungen prüfen

Der Linux-Prüflauf baut, testet und paketiert das kleine Programm. Die Windows-Matrix ist vorbereitet. Ihre erfolgreiche Ausführung muss auf einem echten Windows-Runner separat belegt werden.

CMakeLists.txt · cmakeDatei öffnen
cmake_minimum_required(VERSION 3.20)
project(learning LANGUAGES CXX)
set(CMAKE_CXX_STANDARD 20)
set(CMAKE_CXX_STANDARD_REQUIRED ON)
add_executable(lesson main.cpp)
enable_testing()
add_test(NAME behaviour COMMAND lesson)
install(TARGETS lesson RUNTIME DESTINATION bin)
set(CPACK_PACKAGE_NAME factory-learning)
set(CPACK_PACKAGE_VERSION 1.0.0)
set(CPACK_GENERATOR ZIP)
include(CPack)
Erwartetes Ergebnis

Der Linux-Prüflauf baut, testet und paketiert das kleine Programm. Die Windows-Matrix ist vorbereitet. Ihre erfolgreiche Ausführung muss auf einem echten Windows-Runner separat belegt werden.

04Eine falsche Änderung erkennen

Ändere eine geprüfte Bedingung oder das erwartete Ergebnis. Der Prüfbefehl muss nun fehlschlagen. Stelle danach den Ausgangszustand wieder her. Ein grüner Prozess allein erklärt noch nicht, welche Eigenschaft geschützt wird.

05Die Übung getrennt ausführen

Erzeuge zusätzlich ein Debug-Paket und führe denselben Selbsttest aus dessen Installationsverzeichnis aus.

06Grenzen des Nachweises einordnen

Debug und Release erhalten getrennte Verzeichnisse. Unter Windows muss ein passendes Visual-Studio-Terminal geöffnet sein. Eine Linux-Prüfung ersetzt weder den Windows-Lauf noch die Qt-Laufzeitprüfung der vollständigen FactoryForge-App.

Erwartetes Ergebnis

Der Prüflauf endet erfolgreich. Die im Beispiel benannten Bedingungen werden geprüft.

Deine Übung

Erzeuge zusätzlich ein Debug-Paket und führe denselben Selbsttest aus dessen Installationsverzeichnis aus.

Lösung mit Erklärung anzeigen

Debug und Release erhalten getrennte Verzeichnisse. Unter Windows muss ein passendes Visual-Studio-Terminal geöffnet sein. Eine Linux-Prüfung ersetzt weder den Windows-Lauf noch die Qt-Laufzeitprüfung der vollständigen FactoryForge-App.

solution.py · pyDatei öffnen
import subprocess

subprocess.run(
    ["cmake", "-S", ".", "-B", "build-debug", "-DCMAKE_BUILD_TYPE=Debug"], check=True
)
subprocess.run(["cmake", "--build", "build-debug", "--config", "Debug"], check=True)
subprocess.run(
    ["ctest", "--test-dir", "build-debug", "-C", "Debug", "--output-on-failure"],
    check=True,
)
subprocess.run(
    [
        "cmake",
        "--install",
        "build-debug",
        "--prefix",
        "delivery-debug",
        "--config",
        "Debug",
    ],
    check=True,
)
from pathlib import Path

name = "lesson.exe" if __import__("os").name == "nt" else "lesson"
subprocess.run(
    [str(Path("delivery-debug/bin", name).resolve()), "--self-test"], check=True
)

Projektbezug und Quellen

Das eigenständige Lernprojekt vertieft ein Thema aus diesem Technologiebereich. Die Projektverweise zeigen einen festgehaltenen Quellstand als Architekturkontext. Sie sind kein Beleg dafür, dass jede hier neu eingeführte Bibliothek oder Funktion bereits in dieser App verwendet wird.