Unofficial
Auf dieser Seite
  1. 01Wo es fehlgeschlagen ist
  2. 02Lesen Sie das Protokoll des Rezepts
  3. 03Finden Sie die Ursache
  4. 04Was Sie ändern können
  5. 05Die Quelle eines Rezepts selbst ändern
  6. 06Erneut erstellen
  7. 07Wenn der Build erfolgreich ist, aber ein Programm nicht startet

Wenn ein App Builder-Build fehlschlägt: Protokoll lesen, Ursache ermitteln, erneut erstellen

Eine App in App Builder baut Programme nacheinander aus Rezepten. Eines davon kann fehlschlagen. Diese Anleitung zeigt einen tatsächlichen Fehler auf einem Test-NAS: TurboShell mit 70 Rezepten stoppte beim siebten Rezept, der Korn-Shell ksh93.

  1. Wodas Rezept, das fehlgeschlagen ist
  2. Protokolldie letzten Zeilen
  3. Ursachewas die Fehlermeldung nennt
  4. Änderungkorrigiertes Rezept oder App
  5. Neuer Buildverwendet erfolgreiche Rezepte wieder

Die Bilder stammen von Bucket & Code Server IDE 1.0.0-49, vor und nach dem Fix.

01Wo es fehlgeschlagen ist

Ein fehlgeschlagener Build lässt die App, wie sie war. Wenn ein früherer Build erfolgreich war, verwenden Aktivieren, Herunterladen und Als QPKG exportieren weiterhin dessen Ergebnis. Die Seitenleiste markiert den letzten Build als fehlgeschlagen; auf der App-Seite steht der Fehler in der Pipeline.

Die Apps-Seitenleiste: TurboShell, fehlgeschlagenDie Pipeline: Build, Fehlgeschlagen; ein früherer Build wird beibehalten

Die Karte Build-Reihenfolge nennt das Rezept, das fehlgeschlagen ist, und die Phase, in der es fehlschlug. In diesem Beispiel zeigen alle Rezepte davor bestanden. Die Rezepte danach zeigen nicht erreicht und behalten das Protokoll eines früheren Builds.

Die Karte Build-Reihenfolge: Build fehlgeschlagen, die Meldung builder: FAILED ksh93 in build (exit 1), Rezepte 1 bis 6 bestanden, ksh93 beim Kompilieren fehlgeschlagen, fish nicht erreicht, daneben Früheres Protokoll

02Lesen Sie das Protokoll des Rezepts

Protokoll in der Zeile des Rezepts öffnet, was der Builder dafür geschrieben hat: seine Phasen, die Ausgabe des Compilers, das Audit und die Prüfung. Die Ursache liegt kurz vor dem Ende.

Das Protokoll von ksh93: misc/magic.c von libast: Fehler: unbekannter Typname Magic_t; Meinten Sie magic_t, dann mamake mit Exit-Code 1 beim Erstellen von magic.o, und Paket: make ist fehlgeschlagen
  • Das eigene Protokoll des Build-Jobs unter Jobs im unteren Bereich (Ctrl+J) endet mit denselben Zeilen: Der Builder kopiert die letzten 40 Zeilen des Protokolls des Rezepts hinein.
  • Der Build-Baum des fehlgeschlagenen Rezepts bleibt bis zum nächsten Build der App im Build-Ordner der App: apps/<app>/build/work/<recipe> im Datenordner. Öffnen Sie ihn im Terminal des Editors, um sich die Quellen und die generierten Dateien anzusehen.

03Finden Sie die Ursache

Der Compiler verlangt Magic_t, den eigenen Typ von ksh, und schlägt magic_t vor, den Typ von libmagic, der Bibliothek des Befehls file. Also fand #include <magic.h> in den ksh-Quellen den Header von libmagic, nicht den von ksh.

TurboShell baut auch das Rezept file. Es installiert magic.h von libmagic im Präfix der App. Jedes Rezept wird mit dem include-Ordner dieses Präfixes im Suchpfad gebaut. So finden seine Programme die zuvor gebauten Bibliotheken. Beim ersten Build von TurboShell wurde ksh93 vor file gebaut, und der Build war erfolgreich. Ein späterer Build beginnt mit einer Kopie des letzten erfolgreichen Builds. Im Präfix dieser Kopie lag bereits der Header von libmagic, den ksh93 dann verwendete.

Nennt ein Fehler etwas, wie dieser hier, verfolgen Sie diesen Namen zurück durch die Quellen, die früheren Rezepte und die Build-Umgebung. Das Protokoll zeigt, wo dieser Build angehalten hat; welche Änderung den Fehler behebt, sagt es nicht.

04Was Sie ändern können

  • Ein korrigiertes Rezept. Zwischen den Paketversionen werden Rezepte als signierter Katalog auf das NAS übertragen. Die Karte Rezeptbibliothek auf der Seite Apps zeigt, welche Quelle die Builds verwenden und wann zuletzt nach Updates gesucht wurde. Nach Rezept-Updates suchen startet die Suche sofort. Das korrigierte Rezept ksh93 kam mit Katalog 2026.10.08-1: Es baut ksh93 ohne die Header-Dateien im Präfix der App. Karte Rezeptbibliothek: Rezeptquelle Katalog 2026.10.08-1, die letzte Prüfung war erfolgreich; Schaltflächen Nach Rezept-Updates suchen und Bibliothek des Pakets verwenden
  • Die App. Mit Ändern auf der App-Seite fügen Sie Rezepte hinzu oder entfernen sie und wählen Umgebung und Link-Modus. Ein Programm, das mit einem anderen Rezept kollidiert, kann in einer eigenen App gebaut werden.
  • Die Umgebung. Braucht ein Rezept einen neueren Compiler oder ein Build-Werkzeug, das der Umgebung fehlt, wählen Sie mit Ändern eine andere Umgebung.

05Die Quelle eines Rezepts selbst ändern

Wenn noch kein korrigiertes Rezept vorliegt oder ein Programm in einer neueren Version verfügbar ist, als das Bibliotheksrezept baut, erstellen Sie eine eigene Kopie des Rezepts mit der neuen Quelle. Legen Sie diese im Ordner recipes/ eines Ihrer Projekte ab. Eine App, die die Rezepte dieses Projekts verwendet, baut dann Ihre Kopie anstelle des Bibliotheksrezepts. Die Bibliothek und die anderen Apps bleiben unverändert. In der Bibliothek von Bucket & Code Server IDE 1.0.0-55 baut das Rezept tmux die Version 3.7c; die Kopie in diesem Beispiel baut 3.8.

Das Log des Build-Jobs nennt die verwendete Bibliothek in seiner Zeile recipe library:. Die eigene Bibliothek des Pakets liegt in /usr/bin/bucketvs/share/bucketvs/recipes/, die eines Katalogs in recipes/current/library/ im Datenordner. Kopieren Sie im Terminal des Editors, im Ordner des Projekts, den Ordner des Rezepts von dort:

mkdir -p recipes
cp -r /usr/bin/bucketvs/share/bucketvs/recipes/tmux recipes/

Ändern Sie in recipes/tmux/recipe.json die Version und die Adresse. Löschen Sie die sha256-Zeile des Bibliotheksrezepts. Der erste Build lädt 3.8 herunter, berechnet dessen sha256 und schreibt sie in recipes/tmux/recipe.lock.

"version": "3.8",
"source": {
  "url": "https://github.com/tmux/tmux/releases/download/{version}/tmux-{version}.tar.gz"
},
  • Beim Speichern der Datei werden die Rezepte des Projekts geprüft. Die Ergebnisse erscheinen in der Ansicht Probleme des Editors; bvs recipe lint . führt dieselbe Prüfung im Terminal aus. Die Karte Rezepte in der Projektansicht markiert die Kopie mit ersetzt die Version 3.7c der Bibliothek. Wenn die Kopie einen Fehler enthält, lässt die App sie aus und verwendet auch nicht ersatzweise das Bibliotheksrezept. Das Panel startet dann keinen Build, der tmux benötigt, und nennt den Grund.
  • Auf der Seite der App zeigt Ändern das Feld Rezepte aus einem Projekt, sobald ein Projekt ein Rezept enthält. Wählen Sie das Projekt, dann Änderung speichern und Neu bauen. Das Log des Build-Jobs listet die Rezepte, die er aus dem Projekt gelesen hat, und meldet tmux replaces the library's tmux 3.7c in this app.
  • Eine Version, die sich genauso baut, braucht nur eine neue version. Braucht sie andere configure-Optionen oder einen Patch, ändern Sie auch build.sh; Ihr erstes eigenes Rezept erklärt diese Datei.
  • Die Kopie ersetzt das gleichnamige Rezept der Bibliothek, auch wenn die Version in der Bibliothek neuer ist. Um wieder das Bibliotheksrezept zu verwenden, stellen Sie Rezepte aus einem Projekt auf Keines: nur die Bibliothek oder löschen Sie die Kopie.

06Neu erstellen

Neu bauen auf der App-Seite startet einen neuen Build-Job. Sind die Dateien der App seit dem fehlgeschlagenen Build unverändert, macht er dort weiter, wo dieser Build angehalten hat: Die Rezepte, die der fehlgeschlagene Build schon fertig hatte, werden wiederverwendet, und das fehlgeschlagene Rezept wird neu gebaut, hier ksh93 mit dem korrigierten Rezept aus dem Katalog.

Die Pipeline nach dem neuen Build: Build, GebautDie Karte Build-Reihenfolge nach dem neuen Build: ksh93 und fish bestanden

07Wenn der Build erfolgreich ist, aber ein Programm nicht startet

Jeder Build prüft sein Ergebnis, bevor er die App ersetzt. Dazu gehören die eigene Prüfung jedes Rezepts und eine Analyse, die alle Programme und Bibliotheken liest, ohne sie auszuführen. Der Reiter Abhängigkeiten der App listet die Ergebnisse auf. Beispielsweise fehlt eine Bibliothek oder eine von einem Programm benötigte Symbolversion, ein RUNPATH verweist aus der App heraus, oder ein Programm benötigt eine neuere glibc als die, für die die App gebaut wurde. Für unterstützte Befunde schlägt das Panel eine Aktion vor, oft als Schaltfläche: … hinzufügen und bauen, Auf … umstellen und bauen, RUNPATH patchen, Andere Umgebung wählen oder Nur für dieses NAS bauen. Auf dem NAS gibt bvs deps <app> dieselbe Liste aus.