用自己的配方與配方庫的配方製作自訂應用程式
App Builder 應用程式除了配方庫的配方,還可使用一個專案的配方。本指南在 應用程式 頁面建立應用程式 termtools,其中 cmatrix 來自 您的第一個自訂配方 的專案,tmux 與 htop 來自配方庫,接著在 NAS 上啟用並匯出它。
- 專案您自己的配方
- 新應用程式專案的配方
- 配方專案的與配方庫的
- 建置一項作業
- 使用啟用、匯出
圖片取自 Bucket & Code Server IDE 的面板,每個步驟都依本指南的說明完成。
01應用程式從專案取用什麼
除了配方庫的配方,應用程式還可以使用一個專案的配方。專案 頁面上的任何專案,只要其 recipes/ 資料夾中有配方,就符合資格,不論專案類型為何。與配方庫配方同名的專案配方,只會在使用此專案的應用程式中取代該配方,其他地方都不會。
02使用專案配方的新應用程式
在 應用程式 頁面,新應用程式 會先詢問名稱與前綴、環境、目標、程式在哪裡執行,以及連結方式。將應用程式命名為 termtools;其前綴會變成 /usr/app/termtools。選擇 Ubuntu 24.04 builder 作為環境,目標保留為這台 NAS,連結方式保留為動態,然後按 選擇配方 繼續。
在配方上方,專案的配方 會列出含有配方的專案,以及 無:僅配方庫。選擇 cmatrix。清單接著會先顯示專案的配方,位於專案名稱下方並標示為 專案,配方庫的配方則位於 配方庫 下方。取代配方庫配方的專案配方會顯示 取代配方庫的,後接該配方的版本。
在專案的群組中勾選 cmatrix,在配方庫的群組中勾選 tmux 與 htop;搜尋框可以找到它們。建置順序 會加入它們需要的配方,並在每個配方旁標示需要它的配方。檢閱 會列出每一項選擇,包括 專案的配方,建立並建置 則會建立應用程式並開始建置。
03建置
應用程式頁面會一個配方接一個配方地顯示建置進度。應用程式名稱下方顯示 來自專案 cmatrix 的配方,開發者看到的是一個連到專案的連結。建置作業只在開始時讀取一次專案的配方,其日誌會寫出讀到的內容:
recipes of the project cmatrix, read at the job's start: 1 (cmatrix)
之後才儲存的專案檔案會等到下一次建置:在應用程式頁面按 重新建置。
04啟用並帶到別處
啟用(僅限管理員)會把 /usr/app/termtools 設為一個連結,指向最新通過的建置,程式就能從那裡在 NAS 上執行:
/usr/app/termtools/bin/cmatrix /usr/app/termtools/bin/tmux -V
下載 會以封存檔提供建置,可在相同架構的 NAS 上解開到相同的前綴。匯出為 QPKG 在安裝 QDK 後(工具鏈的 QNAP 分頁)供管理員使用,會把建置打包成不含程式碼簽章的 QTS 套件;為 只有這台 NAS 建置的應用程式不會匯出。您自己的 App Center 說明如何為套件簽章,並在 App Center 中提供。從零開始打造 Transmission 帶著一個程式走完全程,從一台尚未設定任何東西的 NAS,到已簽署的 QTS 套件安裝完成並在瀏覽器中回應。
05換一個專案,或不使用專案
在應用程式頁面按 變更,可重新設定 專案的配方:換成另一個專案,或 無:僅配方庫。已選擇、但新清單中沒有的配方會列在欄位下方,例如 不在此清單中,已略過:cmatrix,只要該選擇不變,它就不會加入應用程式。儲存變更 不會更動應用程式現有的檔案;變更會在下一次建置時生效。
06規則
- 應用程式靠資料夾名稱找到它的專案。資料夾一旦重新命名或移除,應用程式的建置就會被拒絕,並顯示沒有專案「cmatrix」。保留舊名稱的變更也會被拒絕:在 變更 中只能選資料夾的新名稱,或 無:僅配方庫。
- 有問題的專案配方會被略過,欄位會說明原因。配方庫中同名的配方不會代替它。
- 只有開發者看得到專案的配方。檢視者看得到應用程式及其建置;應用程式頁面會告訴檢視者,建置順序不會顯示。
- 建立應用程式需要開發者角色。啟用、停用 與 匯出為 QPKG 僅限管理員。