通過《如意玲瓏應(yīng)用構(gòu)建指南（一）：規(guī)范體系與配置文件全解析》的學(xué)習(xí)后，相信大家已經(jīng)對玲瓏應(yīng)用構(gòu)建工程基礎(chǔ)知識有了一定的了解。在接下來的系列推文中，我們將深入實(shí)操環(huán)節(jié)，帶大家利用所學(xué)知識正式構(gòu)建玲瓏應(yīng)用。

本篇作為“如意玲瓏應(yīng)用構(gòu)建從入門到實(shí)戰(zhàn)”系列的第二篇，我們將以開源圖形應(yīng)用 qBittorrent 為例，為大家將演示如何進(jìn)入玲瓏容器、以及如何在玲瓏容器中編譯 qBittorrent 并測試運(yùn)行。

01前期準(zhǔn)備

根據(jù)玲瓏應(yīng)用構(gòu)建工程通用資源的規(guī)范要求，我們應(yīng)當(dāng)為一款圖形化應(yīng)用同時提供保障桌面用戶體驗(yàn)的 icons 圖標(biāo)文件及 desktop 啟動文件。但本節(jié)實(shí)操演示僅在玲瓏容器中進(jìn)行編譯、測試操作，因此暫時不需要準(zhǔn)備通用資源。 本次分享基于 deepin 23 發(fā)行版，因此在進(jìn)行以下任意步驟前均需要準(zhǔn)備一個可以構(gòu)建玲瓏應(yīng)用的 deepin 23 系統(tǒng)環(huán)境：

確保環(huán)境中已經(jīng)安裝 ll-builder 構(gòu)建套件, 不同發(fā)行版安裝方式參考如意玲瓏安裝教程[1]；

由于在構(gòu)建過程中我們需要聯(lián)網(wǎng)獲取玲瓏容器的運(yùn)行庫以及可能需要的第三方庫，因此我們需要保障全操作過程能夠得到順暢的網(wǎng)絡(luò)連接；

在通過玲瓏容器編譯前, 最好先在比較接近本次構(gòu)建容器的 deepin 23 中成功編譯過 qBittorrent，以確保你對源代碼編譯有一定的了解

結(jié)合上一節(jié)玲瓏應(yīng)用構(gòu)建工程 linglong.yaml 規(guī)范，并按照以下模板簡單編寫一版玲瓏構(gòu)建工程配置文件 linglong.yaml，以此來生成一個符合要求的容器。

主要有以下兩個方面需要關(guān)注：

由于本次操作是直接進(jìn)入容器進(jìn)行操作，因此 build 部分的構(gòu)建規(guī)則可不詳細(xì)寫；

由于本次涉及編譯操作，為了能夠極大程度包含所需的運(yùn)行庫，我們加入 runtime 段，具體編寫規(guī)范參考《如意玲瓏應(yīng)用構(gòu)建指南（一）》。

# SPDX-FileCopyrightText: 2023 UnionTech Software Technology Co., Ltd.
#
# SPDX-License-Identifier: LGPL-3.0-or-later


version: "4.6.7.2"


package:
  id: org.qbittorrent.qBittorrent
  name: "qBittorrent"
  version: 4.6.7.2
  kind: app
  description: |
    qBittorrent binary


base: org.deepin.foundation/23.0.0
runtime: org.deepin.Runtime/23.0.1


command:
  - /opt/apps/org.qbittorrent.qBittorrent/files/bin/qbittorrent


source:
  - kind: local
    name: "qBittorrent"


build: |
  mkdir -p ${PREFIX}/bin/ ${PREFIX}/share/

02項(xiàng)目編譯演示

在這里需要回顧一個知識點(diǎn): 根據(jù)玲瓏應(yīng)用目錄結(jié)構(gòu)規(guī)范，與構(gòu)建工程配置文件 linglong.yaml 同級的構(gòu)建目錄將被映射為 /project 目錄。

萬事俱備，我們就可以開始編譯了

1. 為了方便操作，在構(gòu)建目錄下同時開啟兩個 shell 窗口，分別用于玲瓏容器操作和普通操作。

2. 在完成準(zhǔn)備 linglong.yaml 編輯后，我們就可以開始生成容器了，執(zhí)行有限的操作以直接進(jìn)入玲瓏容器：

szbt@szbt-linyaps23:/media/szbt/Data/ll-build/QT/qBittorrent-git$ ll-builder build --exec bash

szbt@szbt-linyaps23:/project$

szbt@szbt-linyaps23:/media/szbt/Data/ll-build/QT/qBittorrent-git$ tar -xvf qBittorrent-4.6.7-git-origin-src.tar.zst -C src/

4. 源碼解壓后，根據(jù)玲瓏應(yīng)用構(gòu)建基本步驟，我們在編譯任意源代碼前應(yīng)該正確選擇使用何種編譯系統(tǒng)/工具。我們通過觀察 qBittorrent-4.6.7 源碼目錄, 可以看到其存在 CMakeLists.txt 文件，這是 CMake 構(gòu)建項(xiàng)目。

5.由于 qBittorrent INSTALL[2]中簡要描述了本項(xiàng)目主要使用的運(yùn)行庫，因此我們可以對照此文檔來判斷哪些運(yùn)行庫存在與玲瓏提供的 base、runtime 中，或哪些運(yùn)行庫并未被提供。對于暫未被正式提供的運(yùn)行庫，在編譯主程序前我們可能需要先預(yù)編譯必要的第三方庫。

由于文檔所述需要的運(yùn)行庫較少，此次我們可以先直接進(jìn)行一次測試編譯來確認(rèn)運(yùn)行庫缺失情況。

6.通過玲瓏容器操作窗口進(jìn)入源碼目錄，為了盡量避免對源目錄的干擾，我這里新建一個 build 目錄用于編譯。進(jìn)入 build 目錄后我們輸入 CMake 相關(guān)配置參數(shù)來配置構(gòu)建工程。

根據(jù)玲瓏應(yīng)用目錄結(jié)構(gòu)規(guī)范，我們將 DCMAKE_INSTALL_PREFIX 賦予 $PREFIX 的值，最終我在本地執(zhí)行了以下操作：

  cmake -DCMAKE_BUILD_TYPE=Release
 -DCMAKE_INSTALL_PREFIX=$PREFIX ..

7. 可以從圖中看到，這里出現(xiàn)了一個錯誤導(dǎo)致無法完成配置。我們看到 pkg-config 出現(xiàn)錯誤：libtorrent-rasterbar>=1.2.19 庫不能滿足條件：

-- Found PkgConfig: /bin/pkg-config (found version "1.8.1") 
-- Checking for module 'libtorrent-rasterbar>=1.2.19'

szbt@szbt-linyaps23:/project/src/qBittorrent-release-4.6.7-szbt2/build$ pkg-config --print-provides libtorrent-rasterbar

結(jié)合此報錯，基本可以判斷為該庫缺失，因此我們需要在編譯主程序前編譯并安裝此第三方庫。

8. 返回普通操作窗口將 libtorrent-rasterbar>=1.2.19 庫對應(yīng)的源碼下載到當(dāng)前構(gòu)建目錄中，進(jìn)入玲瓏容器操作窗口重新編譯。

9. 源碼解壓后，根據(jù)玲瓏應(yīng)用構(gòu)建基本步驟，我們在編譯任意源代碼前應(yīng)該正確選擇使用何種編譯系統(tǒng)/工具。我們通過觀察 libtorrent-rasterbar-2.0.9 源碼目錄，可以看到其存在 CMakeLists.txt 文件，這是 CMake 構(gòu)建項(xiàng)目。

10. 我們通過玲瓏容器操作窗口進(jìn)入源碼目錄，為了盡量避免對源目錄的干擾，我這里新建一個 build 目錄用于編譯。進(jìn)入 build 目錄后我們輸入 CMake 相關(guān)配置參數(shù)來配置構(gòu)建工程。

根據(jù)玲瓏應(yīng)用目錄結(jié)構(gòu)規(guī)范，我們將 DCMAKE_INSTALL_PREFIX 賦予 $PREFIX 的值，最終我在本地執(zhí)行了以下操作：

  cmake -DCMAKE_BUILD_TYPE=Release
 -DCMAKE_INSTALL_PREFIX=$PREFIX ..
  make -j$(nproc)
  make install

可以看到, 第三方庫 libtorrent-rasterbar-2.0.9 成功完成編譯并安裝到容器的 $PREFIX 目錄中了，我們可以開啟下一個操作。

11. 我們返回玲瓏容器操作窗口進(jìn)入 qBittorrent-4.6.7 源碼目錄，重新執(zhí)行配置、編譯、安裝操作, 均不存在報錯了。

03編譯結(jié)果測試

流程結(jié)束后，在 $PREFIX 目錄中找到該項(xiàng)目的二進(jìn)制執(zhí)行文件并在容器中運(yùn)行測試，該二進(jìn)制執(zhí)行文件為： /opt/apps/org.qbittorrent.qBittorrent/files/bin/qbittorrent 注意，該操作需要在圖形化桌面的終端操作，否則有可能無法調(diào)起程序的圖形界面。

由下圖可見并不是直接通過容器啟動，發(fā)生了運(yùn)行庫無法找到的問題，因?yàn)閳箦e的庫也在 $PREFIX 中，因此我們直接通過變量 LD_LIBRARY_PATH 來指定動態(tài)運(yùn)行庫尋找路徑。

由此可見，qBittorrent 已經(jīng)成功在如意玲瓏應(yīng)用容器中成功編譯并運(yùn)行！

關(guān)于項(xiàng)目

如意玲瓏（Linyaps）是一種新型的獨(dú)立包管理工具集，專注于解決 Linux 系統(tǒng)下由傳統(tǒng)軟件包格式的復(fù)雜性和交叉依賴關(guān)系引起的兼容性問題。項(xiàng)目通過先進(jìn)的隔離技術(shù)，將應(yīng)用與系統(tǒng)完全解耦，從根本上解決因環(huán)境變化引發(fā)的應(yīng)用兼容性問題，實(shí)現(xiàn)“一個架構(gòu)，一次構(gòu)建”，致力于簡化軟件開發(fā)流程、降低維護(hù)成本、加強(qiáng)數(shù)據(jù)安全，促進(jìn)技術(shù)與平臺間的協(xié)同合作，構(gòu)建一個更加繁榮、安全和高效的 Linux 軟件生態(tài)環(huán)境。