Seminar PTXdist Paketentwicklung und Buildregeln

Das Seminar vermittelt die vollständige Entwicklung und Pflege eigener PTXdist-Pakete. Quellen, Versionen, Prüfsummen, Patches, Kconfig, Abhängigkeiten, Buildsysteme, Hostwerkzeuge, Install, Target-Install sowie Lizenz- und Security-Metadaten werden schrittweise umgesetzt und durch saubere Neubauten abgesichert.

Inhaltsverzeichnis

1. Einordnung und Zielbild
2. Zielgruppe
3. Voraussetzungen
4. Lernziele
5. Thematische Module
   1. Anatomie einer Paketregel
   2. Paketvorlage und Konfigurationsoption
   3. Quellen, Versionen und Prüfsummen
   4. Patches und Prepare-Schritt
   5. Configure-Schritt und Buildsysteme
   6. Compile und Parallelbau
   7. Install und Target-Install
   8. Hostpakete und Codegeneratoren
   9. Bibliotheken, pkg-config und Sysroots
   10. Lizenz- und Security-Metadaten
   11. Fehleranalyse und Paketpflege
6. Praxisarbeiten
7. Qualitätssicherung

Einordnung und Zielbild

Das Seminar vermittelt die vollständige Entwicklung und Pflege eigener PTXdist-Pakete. Quellen, Versionen, Prüfsummen, Patches, Kconfig, Abhängigkeiten, Buildsysteme, Hostwerkzeuge, Install, Target-Install sowie Lizenz- und Security-Metadaten werden schrittweise umgesetzt und durch saubere Neubauten abgesichert.

Zielgruppe

Embedded-Linux-Entwickler, Paketmaintainer, BSP-Entwickler, Integratoren und Build-Engineers.

Voraussetzungen

PTXdist-Grundkenntnisse, Linux-Shell, grundlegendes Make-Verständnis sowie Erfahrung mit Compiler und Linker.

Lernziele

• Eigene Target-, Host- und Hilfspakete strukturiert anlegen.
• Quellen, Hashes, Versionen, Patches und Lizenzen vollständig deklarieren.
• Autotools-, CMake-, Meson- oder Make-Projekte korrekt cross-kompilieren.
• Abhängigkeiten, Kconfig-Optionen und Target-Install modellieren.
• Paketfehler auf Stufenebene analysieren und durch Rebuilds absichern.

Thematische Module

1. Anatomie einer Paketregel

Dieser Baustein behandelt Paketsymbol, Kconfig-Datei, Version, Quelle, Hash, Lizenz, Abhängigkeiten, Buildmakros und Stempeldateien. Die Bearbeitung folgt einer festen Reihenfolge aus Bestandsaufnahme, deklarativer Änderung, gezieltem Build, Artefaktprüfung und reproduzierbarer Verifikation.

1. Eingaben und erwarteten Zielinhalt für Paketsymbol, Kconfig-Datei, Version, Quelle, Hash, Lizenz, Abhängigkeiten, Buildmakros und Stempeldateien festlegen.
2. Paketregel, Kconfig-Symbol, Quellenstand, Prüfsumme, Lizenz und deklarierte Abhängigkeiten zuordnen.
3. Betroffene Paketstufe isoliert ausführen und Quell-, Build-, Installations- sowie Target-Verzeichnis untersuchen.
4. Regel, Patch oder Konfiguration minimal ändern und nur den erforderlichen Paketstatus verwerfen.
5. Buildlog, installierte Dateien, Rechte, Architektur und dynamische Abhängigkeiten gegen den Sollzustand prüfen.
6. Den Kontrollpunkt für Paketsymbol, Kconfig-Datei, Version, Quelle, Hash, Lizenz, Abhängigkeiten, Buildmakros und Stempeldateien mit einem klaren Sollzustand und einem reproduzierbaren Test festlegen.
7. Die verwendeten Eingaben, Konfigurationsstände, Kommandos und erzeugten Artefakte für Review und Wiederholung dokumentieren.

2. Paketvorlage und Konfigurationsoption

Dieser Baustein behandelt Paketname, Menüposition, Hilfetext, Auswahlbedingungen, Abhängigkeiten und aktive Konfiguration. Die Bearbeitung folgt einer festen Reihenfolge aus Bestandsaufnahme, deklarativer Änderung, gezieltem Build, Artefaktprüfung und reproduzierbarer Verifikation.

1. Eingaben und erwarteten Zielinhalt für Paketname, Menüposition, Hilfetext, Auswahlbedingungen, Abhängigkeiten und aktive Konfiguration festlegen.
2. Paketregel, Kconfig-Symbol, Quellenstand, Prüfsumme, Lizenz und deklarierte Abhängigkeiten zuordnen.
3. Betroffene Paketstufe isoliert ausführen und Quell-, Build-, Installations- sowie Target-Verzeichnis untersuchen.
4. Regel, Patch oder Konfiguration minimal ändern und nur den erforderlichen Paketstatus verwerfen.
5. Buildlog, installierte Dateien, Rechte, Architektur und dynamische Abhängigkeiten gegen den Sollzustand prüfen.
6. Den Kontrollpunkt für Paketname, Menüposition, Hilfetext, Auswahlbedingungen, Abhängigkeiten und aktive Konfiguration mit einem klaren Sollzustand und einem reproduzierbaren Test festlegen.
7. Die verwendeten Eingaben, Konfigurationsstände, Kommandos und erzeugten Artefakte für Review und Wiederholung dokumentieren.

3. Quellen, Versionen und Prüfsummen

Dieser Baustein behandelt Archiv, Repository-Referenz, Versionsbezeichner, Integrität, Downloadarchiv und kontrolliertes Update. Die Bearbeitung folgt einer festen Reihenfolge aus Bestandsaufnahme, deklarativer Änderung, gezieltem Build, Artefaktprüfung und reproduzierbarer Verifikation.

1. Eingaben und erwarteten Zielinhalt für Archiv, Repository-Referenz, Versionsbezeichner, Integrität, Downloadarchiv und kontrolliertes Update festlegen.
2. Paketregel, Kconfig-Symbol, Quellenstand, Prüfsumme, Lizenz und deklarierte Abhängigkeiten zuordnen.
3. Betroffene Paketstufe isoliert ausführen und Quell-, Build-, Installations- sowie Target-Verzeichnis untersuchen.
4. Regel, Patch oder Konfiguration minimal ändern und nur den erforderlichen Paketstatus verwerfen.
5. Buildlog, installierte Dateien, Rechte, Architektur und dynamische Abhängigkeiten gegen den Sollzustand prüfen.
6. Den Kontrollpunkt für Archiv, Repository-Referenz, Versionsbezeichner, Integrität, Downloadarchiv und kontrolliertes Update mit einem klaren Sollzustand und einem reproduzierbaren Test festlegen.
7. Die verwendeten Eingaben, Konfigurationsstände, Kommandos und erzeugten Artefakte für Review und Wiederholung dokumentieren.

4. Patches und Prepare-Schritt

Dieser Baustein behandelt saubere Patchbasis, kleine Änderung, Kontext, Reihenfolge, Serienablage, Anwendung und Rebase. Die Bearbeitung folgt einer festen Reihenfolge aus Bestandsaufnahme, deklarativer Änderung, gezieltem Build, Artefaktprüfung und reproduzierbarer Verifikation.

1. Eingaben und erwarteten Zielinhalt für saubere Patchbasis, kleine Änderung, Kontext, Reihenfolge, Serienablage, Anwendung und Rebase festlegen.
2. Paketregel, Kconfig-Symbol, Quellenstand, Prüfsumme, Lizenz und deklarierte Abhängigkeiten zuordnen.
3. Betroffene Paketstufe isoliert ausführen und Quell-, Build-, Installations- sowie Target-Verzeichnis untersuchen.
4. Regel, Patch oder Konfiguration minimal ändern und nur den erforderlichen Paketstatus verwerfen.
5. Buildlog, installierte Dateien, Rechte, Architektur und dynamische Abhängigkeiten gegen den Sollzustand prüfen.
6. Den Kontrollpunkt für saubere Patchbasis, kleine Änderung, Kontext, Reihenfolge, Serienablage, Anwendung und Rebase mit einem klaren Sollzustand und einem reproduzierbaren Test festlegen.
7. Die verwendeten Eingaben, Konfigurationsstände, Kommandos und erzeugten Artefakte für Review und Wiederholung dokumentieren.

5. Configure-Schritt und Buildsysteme

Dieser Baustein behandelt Autotools, CMake, Meson, Make, Paketklasse, Featureoptionen, Cross-Compiler und Sysroot. Die Bearbeitung folgt einer festen Reihenfolge aus Bestandsaufnahme, deklarativer Änderung, gezieltem Build, Artefaktprüfung und reproduzierbarer Verifikation.

1. Ausgangslage, Randbedingungen und erwarteten Sollzustand für Autotools, CMake, Meson, Make, Paketklasse, Featureoptionen, Cross-Compiler und Sysroot erfassen.
2. Relevante PTXdist-Konfigurationen, Regeln, Patches, Abhängigkeiten und Ergebnisartefakte zuordnen.
3. Änderung in kleine, überprüfbare Arbeitsschritte zerlegen und den ersten Schritt kontrolliert umsetzen.
4. Betroffene Komponente gezielt bauen und Logs sowie erzeugte Dateien auf Abweichungen prüfen.
5. Funktion im Zielsystem oder in einer isolierten Testumgebung verifizieren und den Stand reproduzierbar sichern.
6. Den Kontrollpunkt für Autotools, CMake, Meson, Make, Paketklasse, Featureoptionen, Cross-Compiler und Sysroot mit einem klaren Sollzustand und einem reproduzierbaren Test festlegen.
7. Die verwendeten Eingaben, Konfigurationsstände, Kommandos und erzeugten Artefakte für Review und Wiederholung dokumentieren.

6. Compile und Parallelbau

Dieser Baustein behandelt Compiler- und Linkerbefehle, Header, Bibliotheken, deklarierte Abhängigkeiten, Parallelität und sauberer Neubau. Die Bearbeitung folgt einer festen Reihenfolge aus Bestandsaufnahme, deklarativer Änderung, gezieltem Build, Artefaktprüfung und reproduzierbarer Verifikation.

1. Eingaben und erwarteten Zielinhalt für Compiler- und Linkerbefehle, Header, Bibliotheken, deklarierte Abhängigkeiten, Parallelität und sauberer Neubau festlegen.
2. Paketregel, Kconfig-Symbol, Quellenstand, Prüfsumme, Lizenz und deklarierte Abhängigkeiten zuordnen.
3. Betroffene Paketstufe isoliert ausführen und Quell-, Build-, Installations- sowie Target-Verzeichnis untersuchen.
4. Regel, Patch oder Konfiguration minimal ändern und nur den erforderlichen Paketstatus verwerfen.
5. Buildlog, installierte Dateien, Rechte, Architektur und dynamische Abhängigkeiten gegen den Sollzustand prüfen.
6. Den Kontrollpunkt für Compiler- und Linkerbefehle, Header, Bibliotheken, deklarierte Abhängigkeiten, Parallelität und sauberer Neubau mit einem klaren Sollzustand und einem reproduzierbaren Test festlegen.
7. Die verwendeten Eingaben, Konfigurationsstände, Kommandos und erzeugten Artefakte für Review und Wiederholung dokumentieren.

7. Install und Target-Install

Dieser Baustein behandelt Paketinstallationsbereich, Laufzeit-, Entwicklungs- und Dokumentationsdateien, Zielpfade, Rechte und Besitzer. Die Bearbeitung folgt einer festen Reihenfolge aus Bestandsaufnahme, deklarativer Änderung, gezieltem Build, Artefaktprüfung und reproduzierbarer Verifikation.

1. Eingaben und erwarteten Zielinhalt für Paketinstallationsbereich, Laufzeit-, Entwicklungs- und Dokumentationsdateien, Zielpfade, Rechte und Besitzer festlegen.
2. Paketregel, Kconfig-Symbol, Quellenstand, Prüfsumme, Lizenz und deklarierte Abhängigkeiten zuordnen.
3. Betroffene Paketstufe isoliert ausführen und Quell-, Build-, Installations- sowie Target-Verzeichnis untersuchen.
4. Regel, Patch oder Konfiguration minimal ändern und nur den erforderlichen Paketstatus verwerfen.
5. Buildlog, installierte Dateien, Rechte, Architektur und dynamische Abhängigkeiten gegen den Sollzustand prüfen.
6. Den Kontrollpunkt für Paketinstallationsbereich, Laufzeit-, Entwicklungs- und Dokumentationsdateien, Zielpfade, Rechte und Besitzer mit einem klaren Sollzustand und einem reproduzierbaren Test festlegen.
7. Die verwendeten Eingaben, Konfigurationsstände, Kommandos und erzeugten Artefakte für Review und Wiederholung dokumentieren.

8. Hostpakete und Codegeneratoren

Dieser Baustein behandelt Ausführungsort, Hostarchitektur, Hostregel, Generatorausgabe, Zielabhängigkeit und Architekturkontrolle. Die Bearbeitung folgt einer festen Reihenfolge aus Bestandsaufnahme, deklarativer Änderung, gezieltem Build, Artefaktprüfung und reproduzierbarer Verifikation.

1. Eingaben und erwarteten Zielinhalt für Ausführungsort, Hostarchitektur, Hostregel, Generatorausgabe, Zielabhängigkeit und Architekturkontrolle festlegen.
2. Paketregel, Kconfig-Symbol, Quellenstand, Prüfsumme, Lizenz und deklarierte Abhängigkeiten zuordnen.
3. Betroffene Paketstufe isoliert ausführen und Quell-, Build-, Installations- sowie Target-Verzeichnis untersuchen.
4. Regel, Patch oder Konfiguration minimal ändern und nur den erforderlichen Paketstatus verwerfen.
5. Buildlog, installierte Dateien, Rechte, Architektur und dynamische Abhängigkeiten gegen den Sollzustand prüfen.
6. Den Kontrollpunkt für Ausführungsort, Hostarchitektur, Hostregel, Generatorausgabe, Zielabhängigkeit und Architekturkontrolle mit einem klaren Sollzustand und einem reproduzierbaren Test festlegen.
7. Die verwendeten Eingaben, Konfigurationsstände, Kommandos und erzeugten Artefakte für Review und Wiederholung dokumentieren.

9. Bibliotheken, pkg-config und Sysroots

Dieser Baustein behandelt Header, Bibliothek, pc-Datei, pkg-config-Suchpfad, Linkerflags, RPATH und dynamische Abhängigkeiten. Die Bearbeitung folgt einer festen Reihenfolge aus Bestandsaufnahme, deklarativer Änderung, gezieltem Build, Artefaktprüfung und reproduzierbarer Verifikation.

1. Ausgangsstand und technische Randbedingungen für Header, Bibliothek, pc-Datei, pkg-config-Suchpfad, Linkerflags, RPATH und dynamische Abhängigkeiten erfassen.
2. Tatsächlich verwendete Werkzeuge, Zieltuple, Suchpfade und wirksame Plattformoptionen aus Konfiguration und Buildlog bestimmen.
3. Host-, Cross- und Target-Bestandteile trennen und nicht deklarierte Pfade oder Architekturvermischungen entfernen.
4. Eine minimale Konfigurations- oder Abhängigkeitsänderung umsetzen und die betroffene Komponente gezielt neu bauen.
5. Binärformat, Symbole, Interpreter, Bibliotheksabhängigkeiten und Laufzeitverhalten am erzeugten Artefakt prüfen.
6. Den Kontrollpunkt für Header, Bibliothek, pc-Datei, pkg-config-Suchpfad, Linkerflags, RPATH und dynamische Abhängigkeiten mit einem klaren Sollzustand und einem reproduzierbaren Test festlegen.
7. Die verwendeten Eingaben, Konfigurationsstände, Kommandos und erzeugten Artefakte für Review und Wiederholung dokumentieren.

10. Lizenz- und Security-Metadaten

Dieser Baustein behandelt Lizenzausdruck, Lizenzdateien, Hashes, Produktname, Version, Herkunft und Schwachstellenzuordnung. Die Bearbeitung folgt einer festen Reihenfolge aus Bestandsaufnahme, deklarativer Änderung, gezieltem Build, Artefaktprüfung und reproduzierbarer Verifikation.

1. Schutzobjekte, Vertrauensgrenzen, Angreiferfähigkeiten und geforderte Nachweise für Lizenzausdruck, Lizenzdateien, Hashes, Produktname, Version, Herkunft und Schwachstellenzuordnung festlegen.
2. Rollen, Berechtigungen, Schlüsselquelle, Verifikationsstelle und zulässige Buildphase eindeutig zuordnen.
3. Konfiguration oder Signaturschritt mit minimalem Schlüsselzugriff und getrennten Entwicklungs- sowie Produktionszuständen implementieren.
4. Artefakt, Signatur, Zertifikat, Hash und Auditinformationen unabhängig vom erzeugenden Buildschritt prüfen.
5. Gültigen, fehlenden, falschen, manipulierten und gesperrten Zustand als getrennte Negativtests ausführen.
6. Den Kontrollpunkt für Lizenzausdruck, Lizenzdateien, Hashes, Produktname, Version, Herkunft und Schwachstellenzuordnung mit einem klaren Sollzustand und einem reproduzierbaren Test festlegen.
7. Die verwendeten Eingaben, Konfigurationsstände, Kommandos und erzeugten Artefakte für Review und Wiederholung dokumentieren.

11. Fehleranalyse und Paketpflege

Dieser Baustein behandelt fehlerhafte Stufe, gezielte Bereinigung, Umgebung, Kommando, Artefaktvergleich, Regressionstest und Updatehinweise. Die Bearbeitung folgt einer festen Reihenfolge aus Bestandsaufnahme, deklarativer Änderung, gezieltem Build, Artefaktprüfung und reproduzierbarer Verifikation.

1. Eingaben und erwarteten Zielinhalt für fehlerhafte Stufe, gezielte Bereinigung, Umgebung, Kommando, Artefaktvergleich, Regressionstest und Updatehinweise festlegen.
2. Paketregel, Kconfig-Symbol, Quellenstand, Prüfsumme, Lizenz und deklarierte Abhängigkeiten zuordnen.
3. Betroffene Paketstufe isoliert ausführen und Quell-, Build-, Installations- sowie Target-Verzeichnis untersuchen.
4. Regel, Patch oder Konfiguration minimal ändern und nur den erforderlichen Paketstatus verwerfen.
5. Buildlog, installierte Dateien, Rechte, Architektur und dynamische Abhängigkeiten gegen den Sollzustand prüfen.
6. Den Kontrollpunkt für fehlerhafte Stufe, gezielte Bereinigung, Umgebung, Kommando, Artefaktvergleich, Regressionstest und Updatehinweise mit einem klaren Sollzustand und einem reproduzierbaren Test festlegen.
7. Die verwendeten Eingaben, Konfigurationsstände, Kommandos und erzeugten Artefakte für Review und Wiederholung dokumentieren.

Praxisarbeiten

• Anlegen eines Pakets mit Kconfig-Eintrag.
• Integration einer versionierten Quelle mit Prüfsumme.
• Erstellung und Anwendung einer Patchserie.
• Cross-Build eines CMake- oder Meson-Projekts.
• Target-Install mit definierten Dateirechten.
• Entwicklung eines Hosttools als Buildabhängigkeit.
• Pflege von Lizenz- und Security-Metadaten.

Qualitätssicherung

Die Bearbeitung wird anhand eindeutiger Eingaben, nachvollziehbarer Konfigurationsänderungen, gezielter Builds, geprüfter Artefakte, dokumentierter Tests und eines sauberen Wiederholungsbuilds bewertet.