技術指南

安裝

下面的初始複製步驟需要 Git。如果尚未安裝 Git，請先安裝（Debian/Ubuntu：sudo apt install git），或參閱：在 Linux 上使用 Git

1) 複製 Lumi（首次設定）

建立 Lumi 目錄，並用 Git 複製原始碼。

sudo apt install git

mkdir -p ~/code
cd ~/code

# Clone via SSH (matches the Git guide above)
git clone git@ssh.gitlab.gnome.org:pixelmixer/lumi-dev.git lumi-dev

# Or clone via HTTPS (no SSH key setup)
# git clone https://gitlab.gnome.org/pixelmixer/lumi-dev.git lumi-dev

2) 安裝相依項（首次設定） 

cd ~/code/lumi-dev/build/lumi/scripts
sudo bash lumi-install-packages.sh

3) 建置 Lumi（首次設定）

首次或重大變更後的完整設定建置：

cd ~/code/lumi-dev/build/lumi/scripts
bash lumi-build-script.sh --scope setup --dir lumi-dev

4) 啟動 Lumi 

cd ~/code/lumi-dev/build/lumi/scripts
bash lumi-launch-active.sh lumi-dev

可選：重新建置 / 編譯

程式碼變更後的一般重新建置：

cd ~/code/lumi-dev/build/lumi/scripts
bash lumi-build-script.sh --scope build --dir lumi-dev

僅編譯的快速路徑：

cd ~/code/lumi-dev/build/lumi/scripts
bash lumi-build-script.sh --scope compile --dir lumi-dev

建置單一整合元件（將 babl 替換為 gegl 或 gtk3）：

cd ~/code/lumi-dev/build/lumi/scripts
bash lumi-build-script.sh --scope build --dir lumi-dev --component babl

可選：建置類型

需要時使用 --type：

  • debug – 除錯工作流程
  • debugoptimized – 開發用的平衡預設值
  • release – 最快的執行速度

範例：

bash lumi-build-script.sh --scope build --dir lumi-dev --type release
在 Linux 上使用 Git建置除錯版本