本文以構(gòu)建 desktop-entry-editor 為例，該項目依賴較為簡單，僅需玲瓏官方文檔中默認提供的基礎(chǔ)運行環(huán)境即可成功構(gòu)建運行

第一步：前期準備

在終端中執(zhí)行

sudo apt install linglong-builder –no-install-recommends

安裝 ll-builder 工具

由于推薦安裝依賴較多，此處跳過推薦依賴不進行安裝。如有需要，去除命令中 –no-install-recommends 參數(shù)即可

第二步：創(chuàng)建項目

由于需要從源代碼構(gòu)建玲瓏格式應(yīng)用，故可以跳過 ll-builder create 操作，無需創(chuàng)建玲瓏對應(yīng)文件夾，直接在工程源代碼頂層目錄編寫 linglong.yaml 文件即可（可使用官網(wǎng)提供的完整的 模板文件 ）。

第三步：編輯 linglong.yaml

version:"1" # linglong.yaml 文件語法的版本package: # 軟件包元信息配置id:com.github.desktop-entry-editor # 軟件包 appid，類似 deb 格式軟件包包名，區(qū)分不同玲瓏格式軟件包name:desktop-entry-editor # 應(yīng)用名稱version:1.4.6.1 # 軟件包版本kind:app # 軟件包類型，多數(shù)應(yīng)用為 app，基礎(chǔ)環(huán)境和運行時為 runtimedescription:| # 軟件包描述 desktop entry editor fo deepin os.command: # 容器內(nèi)可執(zhí)行程序啟動命令-/opt/apps/com.github.desktop-entry-editor/files/bin/desktop-entey-editorbase:org.deepin.foundation/23.0.0 # 基礎(chǔ)環(huán)境runtime:org.deepin.Runtime/23.0.1 # 運行時source: # 構(gòu)建來源kind: local # 由于直接在工程源代碼中構(gòu)建，此處選擇 local 即可，無需從 git 倉庫拉取代碼build:| # 構(gòu)建rm -rf build-linglongmkdir -p build-linglong qmake BUILD_VERSION=1.4.6 PREFIX=${PREFIX} LIB_INSTALL_DIR=${PREFIX}/lib/${TRIPLET} INSTALL_ROOT=${PREFIX} -spec Linux-g CONFIG =Qtquickcompiler -o build-linglong desktop-entry-editor.promake -C build-linglong -j$(nproc)make-C build-linglong -j$(nproc) install

以此 linglong.yaml 為例，軟件包元信息按需填寫即可。

由于項目較為簡單，僅需要基礎(chǔ)的 Qt 和 Dtk 環(huán)境即可構(gòu)建，使用模板文件中所示的 base 和 runtime 即可。更復雜的構(gòu)建環(huán)境可參考構(gòu)建計算器，在構(gòu)建應(yīng)用前拉取所需依賴代碼，優(yōu)先構(gòu)建所需依賴。

理解安裝位置“前綴”

以我們所熟知的方式來理解，一般可執(zhí)行文件需要放到 /usr/bin 文件夾下，在終端嘗試執(zhí)行時才能被找到；.desktop 文件提供了啟動的入口，想在啟動器中看到應(yīng)用圖標，一般放到 /usr/share/applications 文件夾下；而圖片文件會放到 /usr/share/icons 文件夾中具體的圖標主題及尺寸和分類文件夾下。這其中，/usr 就是所有文件安裝位置的前綴。

根據(jù) GNU 編碼標準，前綴 的默認值一般為 /usr/local；而構(gòu)建 deb 格式軟件包時，一般會使用 /usr 前綴。

而玲瓏容器啟動時，會將容器內(nèi)容 files 文件夾掛載至/opt/apps/${appid}文件夾下，故可以近似認為前綴為 /opt/apps/${appid}/files。以此類推，可執(zhí)行文件的實際位置為 /opt/apps/${appid}/files/bin/可執(zhí)行文件名稱，所以 linglong.yaml 中 command 啟動指令部分也需要如此填寫，而不是常見的 /usr/bin/ 可執(zhí)行文件名稱。

檢查修改工程源代碼

理解了前綴 的概念，就要檢查工程源代碼的安裝位置前綴了。qmake工程中，默認安裝位置前綴一般為 /opt/$${TARGET}文件夾，如可執(zhí)行文件就被在 /opt/$${TARGET}/bin文件夾中。此處可能需要修改 .pro文件，將前綴修改為 /opt/apps/${appid}/files 文件夾，保證玲瓏容器啟動后文件位置正確。

或者如構(gòu)建 計算器 所示，通過 qmake 參數(shù)從外部傳入安裝位置前綴，并在 .pro 文件中解析 ${PREFIX} 以實現(xiàn)控制文件安裝位置。

第四步：構(gòu)建應(yīng)用

在工程源代碼頂層目錄（linglong.yaml同級目錄）打開終端，執(zhí)行ll-builder build命令即可。

首次構(gòu)建時需下載指定的 base 和 runtime，耗時較長，需要耐心等待

第五步：測試運行應(yīng)用

在工程源代碼頂層目錄（linglong.yaml同級目錄）打開終端，執(zhí)行ll-builder run –exec 可執(zhí)行程序名稱，可測試在玲瓏容器環(huán)境內(nèi)啟動應(yīng)用。

若找不到可執(zhí)行程序，請檢查工程源代碼中文件安裝位置是否正確。可查看工程頂層目錄下 linglong/output/runtime/files/bin 文件夾中是否生成可執(zhí)行文件。

若啟動應(yīng)用失敗，參考 文檔 在容器內(nèi)進行調(diào)試。

第六步：導出 layer 文件

在工程源代碼頂層目錄（linglong.yaml同級目錄）打開終端，執(zhí)行ll-builder export命令，即可在目錄中生成${appid}_${version}_${arch}_develop.layer 和${appid}_${version}_${arch}runtime.layer 文件。

第七步：測試安裝 layer 文件

在工程源代碼頂層目錄（linglong.yaml 同級目錄）打開終端，輸入 ll-cli install并輸入空格分隔后，將文件夾中的 runtime.layer文件拖入終端，按回車執(zhí)行，將 layer文件安裝至本地玲瓏環(huán)境中。

安裝成功后，應(yīng)該可以在啟動器中看到該應(yīng)用，并進行啟動和使用測試。

若啟動器中無法找到該應(yīng)用，請檢查工程源代碼中文件安裝位置是否正確。可查看工程頂層目錄下 linglong/output/runtime/entries/share/applications 文件夾中是否生成 .desktop 文件。

若存在啟動失敗情況，可查看對應(yīng) .desktop 文件并復制 Exec 字段內(nèi)容至終端中執(zhí)行，觀察啟動輸出日志。若提示缺少玲瓏對應(yīng)版本的 base 或 runtime 環(huán)境，需手動執(zhí)行 ll-cli install 環(huán)境名稱/版本號 進行安裝以排除故障（e.g. ll-cli install org.deepin.Runtime/23.0.1）。

總結(jié)：

至此從源代碼構(gòu)建玲瓏格式應(yīng)用已完成。

本文舉例的項目使用 qmake 構(gòu)建，依賴簡單，且支持構(gòu)建時外部傳入 ${PREFIX}設(shè)置文件安裝位置，構(gòu)建為玲瓏格式應(yīng)用非常簡單。若項目使用 cmake或其他工具構(gòu)建，同理需在工程內(nèi)修改安裝前綴，或在 linglong.yaml 構(gòu)建部分傳入?yún)?shù)進行設(shè)置，否則即使構(gòu)建成功，也會出現(xiàn)容器內(nèi)無法找到可執(zhí)行文件，或安裝后啟動器沒有圖標等各種問題。

【產(chǎn)品面對面】是 deepin 社區(qū) 2024 年 5 月新推出的專題欄目，在本欄目中，我們將會邀請不同產(chǎn)品的產(chǎn)品經(jīng)理來跟大家分享交流好玩好用的 deepin 或 Linux 相關(guān)應(yīng)用，產(chǎn)品經(jīng)理們也會在 deepin 論壇與所有用戶進行交流答疑。

今天分享的文章來自 deepin 社區(qū)商店產(chǎn)品經(jīng)理，同時也是 deepin 社區(qū)的論壇用戶（忘記、過去），希望大家持續(xù)關(guān)注 deepin 論壇專欄活動【產(chǎn)品面對面】。