Unofficial
本頁內容
  1. 01Toolchains 頁面的功能
  2. 02在 Shell 中使用執行階段
  3. 03建置環境
  4. 04在環境中編譯程式
  5. 05使用 ELF 檢查器檢查

NAS 上的編譯器、執行階段與建置環境

QTS 沒有編譯器。Bucket & Code Server IDE 會下載語言執行階段、交叉編譯器與供建置使用的完整 Linux 系統，依 sha256 檢查每次下載的檔案，並保存在資料資料夾中。本指南不會安裝任何新項目：我們使用建置環境與 Go 執行階段所提供的工具，編譯小程式，再確認它能在 NAS 上執行。

  1. 目錄執行階段、編譯器、系統
  2. 執行階段eval "$(bvs use …)"
  3. 環境供建置使用的 Linux 系統
  4. 建置bvs env run
  5. 檢查ELF 檢查器

圖片來自測試 NAS 上的 Bucket & Code Server IDE 面板，其資料資料夾為 /share/CACHEDEV1_DATA/BucketVS。

01Toolchains 頁面的功能

Toolchains 頁面會以分頁顯示目錄：

類型說明範例
根檔案系統可解壓縮到環境中的 Linux 系統Debian 12 與 13、Ubuntu 22.04 與 24.04、Alpine 3.22
交叉工具鏈為其他處理器建置程式的編譯器適用於 aarch64、x86-64 與 armv7 的 Bootlin 工具鏈，搭配 glibc 或 musl
執行階段語言或建置工具Python, Go, Node.js, Zig, Rust, CMake, Ninja, Java
QNAPQNAP 自有的建置套件QDK 2.5.0，供 bvs qbuild 與 Export as QPKG 使用
Runtimes 分頁：已安裝 Go 1.27，提供 bvs use 與 Remove；Zig 0.15 有 Install 按鈕
  • Install 需要管理員角色。工作會將壓縮檔下載至資料資料夾的 toolchains/cache/，依目錄檢查 sha256（不符便刪除檔案），再將執行階段或交叉工具鏈解壓縮至 toolchains/<kind>/<id>。進度會顯示在 Jobs 頁面；若下載中斷，重新開始安裝時會接續下載。
  • 其他處理器的項目會隱藏。Bootlin 交叉工具鏈在 x86_64 上執行，因此 ARM NAS 不提供這些工具鏈。
  • 目錄隨套件提供。pub.qnaputilities.com 的已簽署目錄可在不更新套件的情況下新增項目；Refresh the catalog 會立即擷取，內建的 cron 工作則每天擷取一次。
QNAP 分頁：已安裝 QNAP QDK 2.5.0（qbuild）

02在 Shell 中使用執行階段

已安裝項目的 bvs use 會顯示在 Shell 中啟用它所需的命令，例如用於編輯器終端機或 cron 工作。

Toolchains 頁面已安裝的 Go 1.27 項目：建置對象、磁碟位置，以及 bvs use go-1.27-x86_64 的輸出：含執行階段 bin 資料夾的 export PATH、export CGO_ENABLED=0 
# 在編輯器終端機中執行（Editor settings 頁面的 Open the editor）
eval "$(bvs use go-1.27-x86_64)"
go version
go build -o hello-go hello.go
./hello-go

Go 執行階段會設定 CGO_ENABLED=0，因此產生的程式採靜態連結，可在相同處理器的任何 NAS 上執行。交叉工具鏈的使用方式相同：eval "$(bvs use bootlin-aarch64-glibc-stable)" 會提供適用於 ARM 64 位元裝置的編譯器。

03建置環境

環境是解壓縮至資料資料夾 envs/<name> 的 Linux 系統。您可以在其中安裝套件（Debian 或 Ubuntu 上可用 apt install build-essential），安裝的內容會保留。資料資料夾中的專案資料夾在環境內對應為 /projects。

  • 最快取得完整建置工具的方式，是使用 Apps 頁面 Examples 中的預設範例（管理員）：Ubuntu 24.04 builder 會先用 apt-get 安裝建置工具，之後才顯示在清單中。其 glibc 為 2.39，是此套件支援的 NAS 中最低的版本，因此在其中建置的程式可在這些 NAS 上執行。 Ubuntu 24.04 builder (full) 範例卡片：建立工作會安裝的套件、所需的根檔案系統，以及 Use this example
  • New environment（管理員）會以您選擇的名稱解壓縮基本根檔案系統；若尚未安裝，會先下載。 New environment 對話方塊：Name 為 deb12，Root filesystem 為 Debian 12 bookworm，glibc 2.36，以及 Create 按鈕
  • 每個環境都有 Open a shell，會開啟編輯器並提供已進入環境的終端機，另外還有 Clone、Export 與 Delete。 debian12-builder（glibc 2.36）與 ubuntu2404-builder（glibc 2.39）環境，各有 Open a shell、Clone、Export、Delete，以及各自的 bvs env shell 命令

04在環境中編譯程式

從 NAS 上任何終端機執行 bvs env shell <name> 可進入環境，執行 bvs env run <name> -- <command> 則會在其中執行單一命令。兩者都從您執行命令的資料夾開始：專案資料夾下的子資料夾，在環境內對應為 /projects 下的相同子資料夾。

# projects/ 下某個資料夾中的 hello.cpp，在編輯器終端機中執行
bvs env run ubuntu2404-builder -- g++ -O2 -o hello hello.cpp
./hello

編譯器與其函式庫來自環境；程式則在 NAS 本身執行。下一步會檢查它是否能在 NAS 找到所需的內容。

05使用 ELF 檢查器檢查

Toolchains 頁面的 ELF inspector 分頁（開發者角色）會讀取程式或函式庫，以及目標自身的載入器資料，不執行任何內容，並指出此 NAS 或環境是否滿足其需求。請選擇檔案位置（應用程式的建置結果、專案資料夾、環境；管理員則可選 NAS 上任何檔案）與目標，再按下 Inspect。

ELF 檢查器：已選專案資料夾，Path 為 hello/hello，Target 為 This NAS (x86_64)，LD_LIBRARY_PATH 留空 結果：在 NAS 上檢視，x86_64，glibc 2.43，已讀取 6 個 ELF 檔案，0 個錯誤、0 個警告；沒有問題：6 個檔案的所有需求都能找到，且符合函式庫所定義的版本

What it needs 會繪出程式、載入的函式庫、每個函式庫的位置，以及要求的版本。此處的 C++ 程式需要 libstdc++.so.6 與 libc.so.6，而這台 NAS 的兩個函式庫皆定義了所需版本。

所需項目：hello 連接到 NAS 的 ld-linux-x86-64.so.2、libc.so.6、libgcc_s.so.1、libm.so.6 與 libstdc++.so.6，以及需要的 GLIBC_2.34、GLIBCXX_3.4.32 等版本
  • 若缺少函式庫、函式庫未提供要求的版本，或 glibc 比目標的更新，結果會說明原因。將環境選為目標，即可檢視相同程式在該環境執行時的需求是否滿足。
  • 在 NAS 上，bvs ldd <file> 會輸出相同結果；若要檢查環境，則用 bvs ldd --env <name> <file>。
  • 對於您要發佈的程式，App Builder 會檢查每次建置的每個檔案，其 Dependencies 分頁會提供修正方式。