Seminar OpenBoard – Quellcode, Build und individuelle Anpassung

Dreitägiges Entwicklungsseminar für einen reproduzierbaren OpenBoard-Build und kontrollierte individuelle Anpassungen. Behandelt werden Quellbaum, Qt-basierte Architektur, CMake, Abhängigkeiten, plattformspezifische Builds, Ressourcen und Übersetzungen, kleine Funktionsanpassungen, Tests, Paketierung, Lizenzhinweise und Wartungsstrategie.

Inhaltsübersicht

1. Zielgruppe
2. Voraussetzungen
3. Lernziele
4. Tag 1: Entwicklungsrahmen und Quellbaum
5. Tag 1: Qt- und CMake-Werkzeugkette
6. Tag 1: Referenz-Build und Baseline
7. Tag 2: Ressourcen und Oberflächenanpassung
8. Tag 2: Funktionale Anpassung
9. Tag 2: Debugging und Fehleranalyse
10. Tag 3: Plattformübergreifende Prüfung
11. Tag 3: Paketierung und Release
12. Tag 3: Wartung und Upstream-Strategie
13. Praxisübungen

Zielgruppe

C++-Entwicklung, Build Engineering, technische Projektleitung, DevOps und Administratorinnen beziehungsweise Administratoren mit Entwicklungsauftrag.

Voraussetzungen

Sichere Kenntnisse in C++, Versionsverwaltung, Compilerwerkzeugen und Buildprozessen. Grundkenntnisse von Qt und CMake sowie Administratorrechte auf einer geeigneten Entwicklungsmaschine.

Lernziele

• Quellbaum und wesentliche technische Komponenten einordnen
• eine reproduzierbare Build-Umgebung für eine Zielplattform aufsetzen
• einen unveränderten Referenz-Build erzeugen und validieren
• Ressourcen, Übersetzungen oder klar abgegrenzte Funktionen anpassen
• Tests, Paketierung und Wartung in einen nachvollziehbaren Releaseprozess überführen

Seminarinhalte

1. Tag 1: Entwicklungsrahmen und Quellbaum

1. Ziel der Anpassung, Zielplattform, Unterstützungszeitraum und Abgrenzung zum Standardprodukt festlegen.
2. Quellbaum nach Anwendungscode, Bibliotheken, Ressourcen, Übersetzungen, Plattformcode und Builddateien untersuchen.
3. Abhängigkeiten und Werkzeugversionen in einer reproduzierbaren Umgebungsbeschreibung erfassen.
4. Unveränderten Ausgangsstand als Referenz markieren und vor lokalen Änderungen sichern.

2. Tag 1: Qt- und CMake-Werkzeugkette

1. Compiler, Qt-Komponenten, CMake und weitere benötigte Werkzeuge passend zur Zielplattform installieren.
2. Buildverzeichnis strikt vom Quellverzeichnis trennen.
3. Konfiguration erzeugen und fehlende Abhängigkeiten systematisch aus den Meldungen ableiten.
4. Buildparameter, Pfade und Umgebungsvariablen in einer ausführbaren Anleitung dokumentieren.

3. Tag 1: Referenz-Build und Baseline

1. Unveränderten Quellstand kompilieren und auftretende Warnungen oder Fehler klassifizieren.
2. Erzeugtes Programm starten und zentrale Funktionen anhand eines festen Prüfkatalogs testen.
3. Builddauer, Artefakte, Bibliotheksabhängigkeiten und Laufzeitumgebung erfassen.
4. Referenzartefakt und Testergebnis als Baseline für spätere Änderungen sichern.

4. Tag 2: Ressourcen und Oberflächenanpassung

1. Symbole, Standardressourcen, Texte und Übersetzungsdateien identifizieren.
2. Eine kleine, reversible Ressourcen- oder Textanpassung durchführen.
3. Neu bauen und prüfen, ob die Änderung auf allen betroffenen Ansichten korrekt erscheint.
4. Änderung einschließlich Dateipfad, Zweck, Test und Rücknahme dokumentieren.

5. Tag 2: Funktionale Anpassung

1. Änderungswunsch in klaren Sollzustand, Nichtziele und Akzeptanzkriterien zerlegen.
2. Betroffene Klassen, Signale, Zustände und Abhängigkeiten eingrenzen.
3. Kleine Änderung in einem separaten Branch implementieren und lokal testen.
4. Seiteneffekte auf Dokumente, Werkzeuge, Anzeige und Plattformverhalten gezielt prüfen.

6. Tag 2: Debugging und Fehleranalyse

1. Debug-Build erzeugen und reproduzierbaren Fehlerfall vorbereiten.
2. Meldungen, Stack, Zustände und Eingabedaten schrittweise untersuchen.
3. Ursache von Folgefehlern trennen und kleinsten fehlerauslösenden Fall dokumentieren.
4. Korrektur mit vorherigem und nachherigem Testfall belegen.

7. Tag 3: Plattformübergreifende Prüfung

1. Plattformspezifische Pfade, Dateirechte, Anzeige, Medien und Eingabegeräte in die Testmatrix aufnehmen.
2. Änderung mindestens auf einer Referenz- und einer abweichenden Zielumgebung prüfen.
3. Dokumentkompatibilität sowie Öffnen und Speichern bestehender Dateien kontrollieren.
4. Nicht geprüfte Plattformen und bekannte Einschränkungen transparent festhalten.

8. Tag 3: Paketierung und Release

1. Artefakte, Laufzeitbibliotheken, Ressourcen und Versionsinformationen vollständig zusammenstellen.
2. Installations- oder Verteilpaket in einer sauberen Zielumgebung testen.
3. Releaseprüfung aus Installation, Programmstart, Kernfunktionen und Deinstallation durchführen.
4. Änderungsnotizen, Prüfergebnis, Rückfallpaket und Freigabestatus dokumentieren.

9. Tag 3: Wartung und Upstream-Strategie

1. Lokale Änderungen möglichst klein, getrennt und nachvollziehbar halten.
2. Regelmäßigen Abgleich mit neuen Standardständen und Konfliktprüfung planen.
3. Lizenz- und Drittkomponentenhinweise sowie interne Verantwortlichkeiten dokumentieren.
4. Entscheidungskriterien für Weiterpflege, Neuimplementierung oder Rückkehr zum Standard festlegen.

Praxisübungen

1. Aufsetzen einer reproduzierbaren Entwicklungs- und Build-Umgebung.
2. Erzeugung und Validierung eines unveränderten Referenz-Builds.
3. Durchführung einer Ressourcen- und einer kleinen Funktionsanpassung.
4. Erstellung einer plattformbezogenen Testmatrix.
5. Paketierung eines Test-Releases mit Änderungs- und Rückfalldokumentation.