在上一篇文章《国产系统之如意玲珑》中，我为大家介绍了一款创新的国产软件包管理工具——如意玲珑（Linyaps）。该工具集致力于解决 Linux 系统下传统软件包格式带来的复杂性和依赖问题，提供了一种更独立、更简洁的打包和管理方式。
本文将通过一个简单的 QT 应用示例，带大家走一遍如何将其打包成玲珑包的过程。虽然如意玲珑项目的官网提供了一些文档和示例，但在实际项目中仍会遇到不少问题，我也在这次探索中踩了些坑，希望这篇文章能为大家提供一些帮助。
本文使用的开发环境为 Deepin V23 系统，Qt Creator 13.0.2，Qt 库使用的版本为 5.15.2。源码托管在
https://e.coding.net/mogoweb/qt-in-action/qt-in-action.git
文中用到的源码位于 LingLongDemo 目录下，供大家参考。
1. 创建一个简单的 QT 工程
简单修改一下窗体里的显示，最后运行显示如下：
2. 添加一个 .desktop 文件
在 Linux 系统中，.desktop 文件用来描述应用程序的名称、图标、可执行程序等等，应用程序只有建立了 .desktop 文件，并放在系统的正确位置，才会在起始菜单项中出现。
在Qt Creator 中新建一个空文件：
文件命名为 hello-linglong.desktop:
文件的内容如下：
[Desktop Entry]
Exec=LingLongDemo
GenericName=LingLong Demo
Hidden=false
Name=LingLong Demo
StartupNotify=false
Type=Application其中，Exec 指定可执行程序名，Name 则为应用程序的名称。
修改 qmake 文件
在 LingLongDemo.pro 文件中添加以下内容：
QT += core gui
greaterThan(QT_MAJOR_VERSION, 4): QT += widgets
CONFIG += c++17
# You can make your code fail to compile if it uses deprecated APIs.
# In order to do so, uncomment the following line.
#DEFINES += QT_DISABLE_DEPRECATED_BEFORE=0x060000 # disables all the APIs deprecated before Qt 6.0.0
SOURCES += \
main.cpp \
mainwindow.cpp
HEADERS += \
mainwindow.h
FORMS += \
mainwindow.ui
# Default rules for deployment.
#qnx: target.path = /tmp/$${TARGET}/bin
#else: unix:!android: target.path = /opt/$${TARGET}/bin
target.path = $$PREFIX/bin
!isEmpty(target.path): INSTALLS += target
CONFIG(release) {
message("Release build")
desktop.files += hello-linglong.desktop
desktop.path = $${PREFIX}/share/applications
INSTALLS += desktop
}其中比较关键的是后面几行，指定 target.path、desktop.files 和 desktop.path。这其中 $$PREFIX 是 qmake 命令行传入的变量定义，可以理解为最后的安装路径，后面的构建步骤将会说明。
创建 linglong.yaml
构建玲珑包的关键就是 linglong.yaml 配置文件，我为这个应用程序创建的 linglong.yaml 文件内容如下：
version: "1"
package:
id: net.mogoweb.qt-in-action.linglongdemo
name: LingLongDemo
version: 0.0.0.1
kind: app
description: |
simple LingLong Demo.
command:
- /opt/apps/net.mogoweb.qt-in-action.linglongdemo/files/bin/LingLongDemo
base: org.deepin.foundation/23.0.0
runtime: org.deepin.Runtime/23.0.1
source:
- kind: local
build: |
qmake LingLongDemo.pro CONFIG+=release PREFIX=${PREFIX}
make -j${JOBS}
make install其中：
version: 版本，注意这里是玲珑的版本，而不是应用程序的版本，当前玲珑的版本为1
package
id: 应用程序的唯一id,为了避免冲突，一般用域名倒置加上应用程序包名
name: 应用程序名，这个名称是在玲珑包管理中展现的名称，并不是在开始菜单项中展现的名称。
version: 应用程序的版本号，一般要求4个用点分隔的数字
kind: 应用程序的类型，app 代表应用，runtime 则代表运行时
description: 应用程序描述
command: 应用程序执行路径，在 UOS 应用打包规范中，app 的 安装路径为: /opt/apps/<app_id>/files/bin/，所以这里的值为：/opt/apps/net.mogoweb.qt-in-action.linglongdemo/files/bin/LingLongDemo
base: 基础环境，因为玲珑应用是运行在容器中的，这里代表最小根文件系统，由 id 和版本号组成。先按照文档上的写。
runtime: 应用运行时依赖，我的理解就是一些运行时库，比如 libc、qt 之类的，先按照文档上填。
source: 在本项目中，是 local类型。但玲珑构建支持从 git 仓库下载资源并进行构建，这里先暂时不讨论。
build: 构建命令，在本例中是新建的 qmake 工程，所以使用 qmake 命令进行构建。${PREFIX} 是玲珑构建提供的环境变量之一，可在 variable、build 字段下使用，它提供构建时的安装路径，本例中值是 /opt/apps/net.mogoweb.qt-in-action.linglongdemo
编译、安装与运行
打开终端，进到 Qt 应用程序源码所在的目录，执行：
ll-builder build注意这个过程中会联网下载基础环境和运行时环境，不要挂 VPN。挂 VPN 会导致基础环境和运行时环境库无法下载，且没有提示，我在这个地方卡了半天，最后才发现是这个问题。
构建完成后，可以用命令先尝试者运行一下，看看有没有问题：
ll-builder run因为是在 linglong.yaml 文件所在的目录下运行，所以不用指定参数也可以。
运行确定没问题后，就可以导出 玲珑包了。
ll-builder export这个过程也是有些坑，要等待个几十秒，没任何输出，搞得我以为哪里又有问题。
导出的文件名为 appid.uab，所以本例中导出的文件为：
net.mogoweb.qt-in-action.linglongdemo_x86_64_0.0.0.1_main.uab
有了这个 uab 文件，就可以安装到系统中。
$ ll-cli install net.mogoweb.qt-in-action.linglongdemo_x86_64_0.0.0.1_main.uab
(295763) ./libs/linglong/src/linglong/cli/cli.cpp:522 install from file "/work/mywork/qt-in-action/source/LingLongDemo/net.mogoweb.qt-in-action.linglongdemo_x86_64_0.0.0.1_main.uab"
100% install uab successfully安装之后，在系统的起始菜单中就可以看到了。
也可以通过玲珑构建工具查看系统安装了哪些玲珑应用：
(base) alex@alex-deepin-os:/work/mywork/qt-in-action/source/LingLongDemo$ ll-cli list
id name version arch channel module description
com.163.music com.163.music 1.2.1.5 x86_64 main runtime 网易云音乐是一款专注于发现与分享的音乐产品，主打发现...
com.baidu.baidunetdisk.linyaps com.baidu.baidunetdisk 4.17.7.6 x86_64 main binary convert from 4.17.7 百度网盘
net.mogoweb.qt-in-action.linglongdemo LingLongDemo 0.0.0.1 x86_64 main binary simple LingLong Demo.通过玲珑构建工具卸载应用：
(base) alex@alex-deepin-os:/work/mywork/qt-in-action/source/LingLongDemo$ ll-cli uninstall net.mogoweb.qt-in-action.linglongdemo
(base) alex@alex-deepin-os:/work/mywork/qt-in-action/source/LingLongDemo$ ll-cli list
id name version arch channel module description
com.163.music com.163.music 1.2.1.5 x86_64 main runtime 网易云音乐是一款专注于发现与分享的音乐产品，主打发现...
com.baidu.baidunetdisk.linyaps com.baidu.baidunetdisk 4.17.7.6 x86_64 main binary convert from 4.17.7 百度网盘以上命令均可以加上 --help 参数，查看更详细的使用方法。
小结
如意玲珑打包主要依赖 linglong.yaml 文件，由于文档的不完善，刚开始做玲珑包时还是走了一些弯路。上面用一个简单的Qt 应用程序的例子展示了基本流程。大家可能会发现，这个例子中，并没有打包所依赖的 Qt 库，而是使用了系统的 Qt 库。在实际的项目中，可能会使用比较新的 Qt 库，还有的项目可能会使用复杂的构建系统，也可能需要先 build 出应用程序，再来构建玲珑包，还可能有更复杂的环境等问题，这个在后面的文章中和大家分享，敬请关注！
