Wozu braucht ein ESP32-Projekt eine Lockdatei?
Eine ESP-IDF-Komponente ist ein wiederverwendbares Softwarepaket, etwa eine Bibliothek für eine Anzeige. Die Datei idf_component.yml ist das Manifest: eine Liste, in der das Projekt seine direkten Komponenten und Versionsregeln festhält.

Der Component Manager ist Espressifs Verwaltungswerkzeug für diese Paketabhängigkeiten. Er nutzt einen Versionslöser – ein Werkzeug, das passende konkrete Versionen auswählt und auch benötigte Folgekomponenten berücksichtigt. Die Pakete können aus einem Paketkatalog (Registry) oder einem versionierten Code-Repository stammen; die Lockdatei hält auch die Quelle fest. Espressifs ESP-IDF-Builddokumentation beschreibt diese Auflösung der Manifestdateien.
Die daraus erzeugte Datei dependencies.lock hält die ausgewählten exakten Komponentenstände fest. Sie dokumentiert auch Quelle, Zielchip, Manifesthash (Prüffingerabdruck der Manifestdateien) und weitere aufgelöste Abhängigkeiten. Das ist der besondere Nutzen der Lockdatei: Das Manifest kann einen Versionsbereich wünschen; die Lockdatei hält fest, welche konkrete Auswahl der Versionslöser für diesen Projektstand getroffen hat. Die Component-Manager-Dokumentation beschreibt Lockdatei-Inhalt und Grenzen.
Beispiel: Ein Displayprojekt fordert eine Bibliothek aus einem Versionsbereich an. Der Versionslöser wählt einen konkreten Stand sowie nötige Folgekomponenten. Die Lockdatei hält diese Auswahl fest, damit Teammitglieder denselben aufgelösten Paketstand nachvollziehen können. Das Verzeichnis managed_components enthält die vom Component Manager heruntergeladenen Pakete; der Ordnername allein zeigt nicht, welche Stände in einem anderen Projekt ausgewählt wurden.
Eine Lockdatei ist kein vollständiger Bauplan für einen überall identischen Erstellungsprozess. Sie bindet die vom Component Manager erfassten Paketstände, aber nicht automatisch Betriebssystem, Compiler, lokale Entwicklungsumgebung oder Platinenrevision. Das angegebene Ziel bezeichnet den ESP-Chip des Projekts, nicht ein bestimmtes Board. Bei lokalen Paketpfaden kann die Lockdatei außerdem umgebungsabhängige Pfade enthalten; die Dokumentation empfiehlt das Einchecken vor allem für Registry- oder Git-Abhängigkeiten und warnt vor bestimmten lokalen Pfadkonfigurationen.
Zwei Prüffingerabdrücke, zwei Aufgaben: Der bereits erwähnte Manifesthash bezieht sich auf die Manifestdateien. Ein in einem Komponenteneintrag vorhandener component_hash dient laut Espressifs Lockdatei-Dokumentation dazu, die Unverändertheit dieser Komponente zu prüfen. Daraus folgt kein Prüffingerabdruck des gesamten fertigen Programms. Für einen nachvollziehbaren Erstellungsstand sind außerdem die konkrete ESP-IDF- und Werkzeugversion sowie die Projektkonfiguration wichtig: Espressif beschreibt sdkconfig als Datei mit der Projektkonfiguration. Ob zwei erstellte Dateien tatsächlich bytegleich sind, lässt sich erst durch Vergleich der jeweiligen Ergebnisse feststellen. ESP-IDF-Buildsystem.
Quellenprüfung: 13.11.2026; Component Manager latest ist beweglich, ESP-IDF stable zeigte v6.1. Kein Build oder Vergleich von Ausgabedateien durchgeführt.
Merksatz: Manifest = gewünschte Komponenten und Versionsregeln. dependencies.lock = konkrete Auswahl des Versionslösers für dieses Projekt und dieses Chipziel. Sie ersetzt weder den Boardnachweis noch einen identischen Gesamtbuild.
Quellenstand: 01.11.2026. Die Component-Manager-Dokumentation latest ist veränderlich; vor einer konkreten Projektprüfung den dortigen Stand neu binden.