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

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

01前期準(zhǔn)備

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

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

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

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

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

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

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

由于本次涉及編譯操作，為了能夠極大程度包含所需的運(yùn)行庫(kù)，我們加入 runtime 段，具體編寫(xiě)規(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)目編譯演示

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

萬(wàn)事俱備，我們就可以開(kāi)始編譯了

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

2. 在完成準(zhǔn)備 linglong.yaml 編輯后，我們就可以開(kāi)始生成容器了，執(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)建基本步驟，我們?cè)诰幾g任意源代碼前應(yīng)該正確選擇使用何種編譯系統(tǒng)/工具。我們通過(guò)觀(guān)察 qBittorrent-4.6.7 源碼目錄, 可以看到其存在 CMakeLists.txt 文件，這是 CMake 構(gòu)建項(xiàng)目。

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

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

6.通過(guò)玲瓏容器操作窗口進(jìn)入源碼目錄，為了盡量避免對(duì)源目錄的干擾，我這里新建一個(gè) build 目錄用于編譯。進(jìn)入 build 目錄后我們輸入 CMake 相關(guān)配置參數(shù)來(lái)配置構(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)了一個(gè)錯(cuò)誤導(dǎo)致無(wú)法完成配置。我們看到 pkg-config 出現(xiàn)錯(cuò)誤：libtorrent-rasterbar>=1.2.19 庫(kù)不能滿(mǎn)足條件：

-- 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é)合此報(bào)錯(cuò)，基本可以判斷為該庫(kù)缺失，因此我們需要在編譯主程序前編譯并安裝此第三方庫(kù)。

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

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

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

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

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

03編譯結(jié)果測(cè)試

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

由下圖可見(jiàn)并不是直接通過(guò)容器啟動(dòng)，發(fā)生了運(yùn)行庫(kù)無(wú)法找到的問(wèn)題，因?yàn)閳?bào)錯(cuò)的庫(kù)也在 $PREFIX 中，因此我們直接通過(guò)變量 LD_LIBRARY_PATH 來(lái)指定動(dòng)態(tài)運(yùn)行庫(kù)尋找路徑。

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

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

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