Unofficial
Na této stránce
  1. 01Kde selhalo
  2. 02Přečtěte si protokol receptu
  3. 03Najděte příčinu
  4. 04Co můžete změnit
  5. 05Změňte zdroj receptu sami
  6. 06Vytvořit znovu
  7. 07Když sestavení projde, ale program se nespustí

Když sestavení App Builder selže: přečtěte si protokol, najděte příčinu, sestavte znovu

Aplikace App Builder sestavuje programy z receptů, jeden po druhém, a kterýkoli z nich může selhat. Tento návod sleduje skutečné selhání na testovacím NASu: TurboShell, aplikace se 70 recepty, se zastavila na sedmém z nich, Korn shellu ksh93.

  1. Kderecept, který selhal
  2. Protokolposlední řádky
  3. Příčinaco uvádí chyba
  4. Změnaopravený recept nebo aplikace
  5. ZnovuRebuild použije, co prošlo

Obrázky pocházejí z Bucket & Code Server IDE 1.0.0-49, před opravou a po ní.

01Kde selhalo

Neúspěšné sestavení nezmění fungující aplikaci. Pokud dřívější sestavení uspělo, Activate, Download a Export as QPKG nadále používají jeho výsledek. Postranní panel označí poslední sestavení jako failed a stránka aplikace zobrazí chybu v pipeline.

Postranní panel Apps: TurboShell se stavem failedPipeline: Build, Failed; dřívější sestavení je zachováno

Karta Build order ukazuje recept a fázi, ve které selhal. V tomto příkladu mají předchozí recepty stav passed; následující mají stav not reached a uchovávají protokol z dřívějšího sestavení.

Karta Build order: poslední sestavení selhalo, zpráva builder: FAILED ksh93 in build (exit 1), recepty 1 až 6 prošly (passed), ksh93 selhal při kompilaci, fish nedosažen (not reached) s protokolem z dřívějšího sestavení (Earlier log)

02Přečtěte si protokol receptu

Log v řádku receptu otevře, co pro recept zapsal sestavovací nástroj: jeho fáze, výstup kompilátoru, audit a kontrolu. Příčina je blízko konce.

Protokol ksh93: v souboru misc/magic.c knihovny libast chyba unknown type name Magic_t; did you mean magic_t, pak mamake s návratovým kódem 1 při vytváření magic.o a nakonec package: make failed
  • Vlastní protokol úlohy sestavení pod Jobs ve spodním panelu (Ctrl+J) končí stejnými řádky: sestavovací nástroj do něj zkopíruje posledních 40 řádků protokolu receptu.
  • Strom sestavení neúspěšného receptu zůstane ve složce sestavení aplikace až do dalšího sestavení aplikace: apps/<app>/build/work/<recipe> v datové složce. Otevřete jej v terminálu editoru a podívejte se na zdroje a vygenerované soubory.

03Najděte příčinu

Kompilátor hledá Magic_t, vlastní typ ksh, a navrhuje magic_t, typ knihovny libmagic, kterou používá příkaz file. #include <magic.h> ve zdrojích ksh tedy našel hlavičku libmagic, a ne hlavičku ksh.

TurboShell sestavuje také recept file, který nainstaluje hlavičkový soubor magic.h knihovny libmagic do prefixu aplikace. Při sestavování každého receptu je ve vyhledávací cestě složka include tohoto prefixu, takže programy najdou knihovny sestavené před nimi. Při prvním sestavení TurboShell se ksh93 sestavil před file a vše uspělo. Další sestavení začíná z kopie posledního úspěšného sestavení. Prefix této kopie už obsahoval hlavičkový soubor libmagic a ksh93 ho použil.

Když chyba něco jmenuje, jako tato, sledujte to jméno zpět přes zdroje, dřívější recepty a prostředí sestavení. Protokol ukazuje, kde se toto sestavení zastavilo; neříká vám, která změna ho opraví.

04Co můžete změnit

  • Opravený recept. Recepty se na NAS dostávají mezi vydáními jako podepsaný katalog. Karta Recipe library na stránce Apps ukazuje, co sestavení používají a kdy proběhla poslední kontrola. Tlačítko Check for recipe updates spustí kontrolu hned. Opravený recept ksh93 přišel v katalogu 2026.10.08-1: sestavuje ksh93 bez hlavičkových souborů v prefixu aplikace. Karta Recipe library: používá se katalog 2026.10.08-1, poslední kontrola uspěla; tlačítka Check for recipe updates a Use the package’s library
  • Aplikace. Pomocí Change na stránce aplikace přidáte nebo odeberete recepty a vyberete prostředí a režim linkování. Program, který koliduje s jiným receptem, můžete sestavit v samostatné aplikaci.
  • Prostředí. Pokud recept potřebuje novější kompilátor nebo nástroj pro sestavení, který v prostředí chybí, zvolte tlačítkem Change jiné prostředí.

05Změňte zdroj receptu sami

Pokud opravený recept ještě není dostupný nebo program vyšel v novější verzi, než jakou sestavuje recept z knihovny, vytvořte vlastní kopii receptu s novým zdrojem. Uložte ji do složky recipes/ v některém ze svých projektů. Aplikace, která používá recepty tohoto projektu, pak sestaví vaši kopii místo receptu z knihovny. Knihovna ani ostatní aplikace se nezmění. V knihovně Bucket & Code Server IDE 1.0.0-55 sestavuje recept tmux verzi 3.7c; kopie v tomto příkladu sestavuje verzi 3.8.

Protokol úlohy sestavení uvádí používanou knihovnu na řádku recipe library:. Vlastní knihovna balíčku je /usr/bin/bucketvs/share/bucketvs/recipes/; knihovna katalogu je recipes/current/library/ v datové složce. V terminálu editoru ve složce projektu odtud zkopírujte složku receptu:

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

V souboru recipes/tmux/recipe.json změňte verzi a adresu a smažte řádek sha256 z knihovny. První sestavení stáhne verzi 3.8, vypočítá její sha256 a zapíše ho do recipes/tmux/recipe.lock.

"version": "3.8",
"source": {
  "url": "https://github.com/tmux/tmux/releases/download/{version}/tmux-{version}.tar.gz"
},
  • Uložením souboru se zkontrolují recepty projektu a výsledky se zobrazí v zobrazení Problems v editoru. Příkaz bvs recipe lint . provede stejnou kontrolu v terminálu. Karta Recipes v zobrazení projektu označí kopii jako replaces the library’s 3.7c. Pokud kopie obsahuje chybu, aplikace ji vynechá a nenahradí ji receptem z knihovny. Panel pak nespustí sestavení, které vyžaduje tmux, a uvede důvod.
  • Na stránce aplikace ukáže Change pole Recipes from a project, jakmile nějaký projekt obsahuje recept. Vyberte projekt, stiskněte Save the change a potom Rebuild. Protokol úlohy sestavení vypíše recepty načtené z projektu a uvede tmux replaces the library's tmux 3.7c in this app.
  • Vydání, které se sestavuje stejně, potřebuje jen novou version. Potřebuje-li jiné volby configure nebo záplatu, upravte i build.sh; tento soubor vysvětluje Váš první vlastní recept.
  • Kopie nahrazuje stejnojmenný recept z knihovny, i když je verze v knihovně novější. Chcete-li se vrátit k receptu z knihovny, nastavte Recipes from a project na None: the library only nebo kopii smažte.

06Vytvořit znovu

Rebuild na stránce aplikace spustí novou úlohu sestavení. Pokud se soubory aplikace od neúspěšného sestavení nezměnily, pokračuje tam, kde se to sestavení zastavilo: recepty, které stihlo dokončit, se použijí znovu a recept, který selhal, se sestaví znovu, zde ksh93 s opraveným receptem z katalogu.

Pipeline po novém sestavení (Rebuild): Build, BuiltKarta Build order po novém sestavení: ksh93 a fish prošly (passed)

07Když sestavení projde, ale program se nespustí

Před nahrazením aplikace každé sestavení zkontroluje svůj výsledek: vlastní kontrolou každého receptu a analýzou, která přečte všechny programy a knihovny, aniž by je spouštěla. Karta Dependencies v aplikaci uvádí zjištění analýzy. Například chybí knihovna, knihovna neposkytuje verzi symbolu potřebnou pro program, RUNPATH míří mimo aplikaci nebo program vyžaduje novější glibc, než pro jakou je aplikace sestavena. U podporovaných zjištění panel navrhne akci, často jako tlačítko: Add … and build, Switch to … and build, Patch the RUNPATH, Choose another environment nebo Build for this NAS only. Na NASu vypíše stejný seznam příkaz bvs deps <app>.