如意玲珑应用构建指南（一）：规范体系与配置文件全解析

在 Linux 生态中，软件包的分发与管理一直是开发者与用户关注的焦点。如意玲珑（Linyaps）作为一种新兴的容器化应用格式，凭借其轻量化、强隔离、跨发行版兼容等特性，正在为 Linux 应用生态注入新的活力。无论是开发者还是技术爱好者，掌握玲珑应用的构建方法都至关重要。

本篇作为 “如意玲珑应用构建从入门到实战” 系列的第一章，将带您系统梳理玲珑应用构建的核心基础知识，涵盖构建流程、规范要求与关键配置文件。通过理解这些基础概念，您将能够为后续的实操教程打下坚实根基，从容应对从代码到安装包的每一步挑战。

01 玲珑应用构建基本步骤

在正式开始构建一个玲珑应用工程前，我们需要了解一个玲珑应用从资源 (源代码、二进制文件等) 输入到应用安装包导出所经过的基本步骤，来确定我们需要准备哪些必要文件。

1. 获取构建目标源文件 (开源项目源代码、应用二进制文件等)；

2. 根据源文件判断玲珑应用构建类型，选择合适的构建方案；

3. 准备符合要求的玲珑构建环境；

4. 按照构建类型及源代码内容定制构建配置文件 linglong.yaml ；

5. 准备应用所使用的通用类资源，图标以及其他非二进制资源。

02 玲珑应用构建工程所需材料

结合上述的知识，我们可以了解到一个玲珑应用在构建的全过程中，主要涉及到以下的文件:

1. 玲珑应用构建工程配置文件 linglong.yaml；

2. 应用源代码 / 需要封装的二进制文件等资源；

3. 非二进制文件等通用资源。

03 玲珑应用遵循的主流规范

每一个 Linux 桌面软件包管理方案为了能够保障完整的功能和良好的体验，均需要遵守软件包管理方案提出的各类规范要求以最大限度发挥软件包管理方案的功能并保障应用生态体验。

如意玲珑也并不总是特立独行，需要满足一定的规范来保障如意玲珑生态得以持续稳步发展。目前如意玲珑生方案遵守以下主流的规范：

1. Freedesktop XDG 规范；

2. 玲珑应用目录结构规范；

3. 玲珑应用构建工程配置文件 linglong.yaml 规范。

3.1 Freedesktop XDG 规范

1. 玲珑应用解决方案遵循 Freedesktop XDG 规范，一款正常的图形化应用应具备图标文件、desktop 文件并符合 Freedesktop XDG 规范；

2. 玲珑应用图标文件应该根据不同尺寸归类到 $PREFIX/share/icons/hicolor/ 目录下；

3. 玲珑应用容器中使用 XDG_DATA_DIRS 等变量，支持读写宿主机中的用户目录；

3.2 玲珑应用目录结构规范

1. 玲珑应用遵循 $PREFIX 路径规则，该变量自动生成，应用所有相关文件需存放于此目录下，该目录层级下存在 bin、share 等目录；

2. 玲珑应用容器中的应用将不被允许读取宿主机中系统目录中的二进制文件、运行库；

3. 在构建工程中，构建工程目录将会被映射到玲珑容器中，挂载为 /project；

4. 玲珑应用容器中运行库、头文件所在目录将根据运行环境类型而异：

   1. foundation 类：在玲珑容器中映射为普通系统路径 /usr/bin、/usr/include 等，作为基础运行系统环境存在；