App Builder ビルドが失敗した場合: ログを読んで原因を見つけ、再度ビルドします。
App Builder のアプリは、レシピからプログラムを 1 つずつ順にビルドします。そのうちの 1 つが失敗することがあります。このガイドでは、テスト用 NAS で実際に起きた失敗を追います。70 個のレシピから成るアプリ TurboShell のビルドが、7 番目のレシピである Korn シェル ksh93 で止まりました。
- どこ失敗したレシピ
- ログ最後の行
- 原因エラーの名前
- 変更修正済みレシピまたはアプリ
- 再ビルド成功したレシピを再利用
画像は、Bucket & Code Server IDE 1.0.0-49 で、修正の前と後に撮影したものです。
01失敗した場所
ビルドが失敗しても、アプリは元のままです。以前に成功したビルドがあれば、有効化、ダウンロード、QPKG としてエクスポート は引き続きそのビルドを使います。サイドバーでは最新のビルドに 失敗 と表示され、アプリのページのパイプラインにも失敗が表示されます。

ビルド順序 カードには、失敗したレシピと、失敗した段階が表示されます。この例では、それより前のレシピはすべて 合格、後のレシピは 未到達 と表示され、以前のビルドのログが残っています。
02レシピのログを読む
レシピの行の ログ を押すと、ビルダーがそのレシピについて書き出した内容 (各段階、コンパイラーの出力、監査、チェック) が開きます。原因は終わりのほうにあります。
- ビルドジョブ自体のログ (下部パネル (Ctrl+J) の ジョブ の下) も、同じ行で終わります。ビルダーが、レシピのログの最後の 40 行をそこにコピーするためです。
- 失敗したレシピのビルドツリーは、アプリの次のビルドまで、アプリのビルドフォルダー (データフォルダーの
apps/<app>/build/work/<recipe>) に残ります。エディターのターミナルでそこを開くと、ソースと生成されたファイルを確認できます。
03原因を見つける
コンパイラーは ksh 独自の型 Magic_t を探し、代わりに、file コマンドのライブラリである libmagic の型 magic_t を提案しています。つまり、ksh のソースにある #include <magic.h> が、ksh のヘッダーではなく libmagic のヘッダーを読み込んでいました。
TurboShell はレシピ file もビルドし、このレシピが libmagic の magic.h をアプリのプレフィックスにインストールします。どのレシピも、そのプレフィックスの include フォルダーを検索パスに入れてビルドされます。そのため、各プログラムは、自分より前にビルドされたライブラリを見つけられます。TurboShell の最初のビルドでは、ksh93 が file より先にビルドされ、成功しました。2 回目以降のビルドは、最後に成功したビルドのコピーの中で行われます。そのプレフィックスにはすでに libmagic のヘッダーがあり、ksh93 がそれを読み込みました。
このエラーのように、エラーが何かの名前を挙げているときは、その名前をソース、前のレシピ、ビルド環境とさかのぼって追います。ログからわかるのは、このビルドがどこで止まったかです。どう変更すれば直るかまでは、ログには書かれていません。
04変更できるもの
- 修正済みのレシピ。パッケージのリリースとリリースの間にも、レシピは署名付きカタログとして NAS に届きます。レシピライブラリカードは アプリページにあり、ビルドが使うレシピのソースと最終確認日時を表示します。レシピの更新を確認を押すと、その場で確認します。修正済みの
ksh93レシピはカタログ 2026.10.08-1 で配信されました。このレシピは、アプリのプレフィックス内のヘッダーファイルを使わずにksh93をビルドします。
- アプリ。 アプリのページの 変更 でレシピの追加と削除、環境とリンクモードの設定ができます。別のレシピと競合するプログラムは、独立したアプリとしてビルドできます。
- 環境。 レシピが、環境にない新しいコンパイラーやビルドツールを必要とする場合は、変更 で別の環境を選びます。
05レシピのソースを自分で変える
修正済みのレシピがまだ届いていないときや、ライブラリのレシピがビルドするものより新しいリリースがプログラムにあるときは、レシピのコピーで新しいソースを指定できます。コピーは、自分のどれかのプロジェクトの recipes/ フォルダーに置きます。そのプロジェクトのレシピを使うアプリは、ライブラリのレシピの代わりにコピーをビルドします。ライブラリとほかのアプリはそのままです。Bucket & Code Server IDE 1.0.0-55 のライブラリでは tmux のレシピが 3.7c をビルドし、ここでのコピーは 3.8 をビルドします。
ビルド ジョブのログは、recipe library: の行で使用中のライブラリを示します。パッケージ自身のライブラリは /usr/bin/bucketvs/share/bucketvs/recipes/、カタログのライブラリはデータフォルダーの recipes/current/library/ です。エディターのターミナルでプロジェクトのフォルダーに移り、そこからレシピのフォルダーをコピーします。
mkdir -p recipes cp -r /usr/bin/bucketvs/share/bucketvs/recipes/tmux recipes/
recipes/tmux/recipe.json でバージョンとアドレスを変更し、ライブラリの sha256 の行を削除します。最初のビルドは 3.8 をダウンロードし、その sha256 を計算して recipes/tmux/recipe.lock に書き込みます。
"version": "3.8",
"source": {
"url": "https://github.com/tmux/tmux/releases/download/{version}/tmux-{version}.tar.gz"
},
- ファイルを保存すると、プロジェクトのレシピを検査し、結果をエディターの 問題ビューに表示します。
bvs recipe lint .はターミナルで同じ検査を行います。プロジェクトビューの レシピカードでは、コピーに ライブラリの 3.7c を置き換えます と表示されます。コピーにエラーがあると、アプリはそのコピーを除外し、ライブラリのレシピで代用することもありません。パネルはtmuxを必要とするビルドを開始せず、その理由を表示します。 - アプリのページでは、レシピを持つプロジェクトが 1 つでもあれば、変更 に プロジェクトのレシピ が表示されます。プロジェクトを選び、変更を保存 を押してから 再ビルド を押します。ビルド ジョブのログには、プロジェクトから読み込んだレシピが並び、
tmux replaces the library's tmux 3.7c in this appと出ます。 - 同じ方法でビルドできるリリースなら、新しい
versionだけで足ります。別の configure オプションやパッチが必要ならbuild.shも変更します。このファイルについては はじめての自作レシピ で説明しています。 - コピーは同じ名前のライブラリのレシピを置き換えます。ライブラリのバージョンが新しくても同様です。ライブラリのレシピに戻すには、プロジェクトのレシピを なし:ライブラリのみ に設定するか、コピーを削除します。
06再ビルド
アプリのページで 再ビルド を押すと、新しいビルドジョブが始まります。失敗したビルドの後でアプリのファイルが変わっていなければ、そのビルドが止まったところから再開します。失敗したビルドで完了していたレシピは再利用され、失敗したレシピがもう一度ビルドされます。ここでは、カタログの修正済みレシピで ksh93 がビルドされます。


07ビルドは成功したがプログラムが起動しない場合
すべてのビルドは、アプリを置き換える前に結果を検査します。各レシピ自身のチェックに加え、すべてのプログラムとライブラリを実行せずに読み取る分析を行います。分析結果はアプリの 依存関係タブに表示されます。たとえば、ライブラリが見つからない、必要なシンボルのバージョンがライブラリにない、RUNPATH がアプリの外を指している、プログラムがアプリの対象より新しい glibc を必要とするといった問題です。対応している問題には、パネルが推奨する操作を表示します。多くは … を追加してビルド、… に切り替えてビルド、RUNPATH を修正、別の環境を選ぶ、この NAS 専用でビルド などのボタンです。NAS では bvs deps <app> で同じ一覧を表示できます。