浏览完整文档

2026-10-16

使用 CI/CD 构建玲珑应用

本章介绍如何通过 GitHub Actions 和 Docker 两种方式自动化构建玲珑应用。使用 GitHub Actions 构建 linglong-builder-action 是一个 GitHub Action，可在 GitHub Actions 工作流中自动安装 ll-builder 并完成构建和导出。前置条件仓库中包含

2026-10-16

手动从 deb 转换

本章以 Google Antigravity 的 amd64 deb 软件包为例，介绍如何在 linglong.yaml 中解包 deb、重新组织应用目录、修正桌面入口并补充运行依赖。该方式不会重新编译应用源码，而是将 deb 中已经编译好的二进制文件和资源整理成如意玲珑应用。转换其他软件前，请确认软件许可证允许重新打包和分发。示例配

2026-10-16

构建配置示例解读

本章以 Linyaps 仓库 master 分支中的 linglong.yaml 为例，解读一个真实项目如何组织包信息、源码、构建命令和构建依赖。为便于逐行核对，本页摘录固定到 2bd8bf49 提交。下面每一节都先原封不动摘录原始配置，再解释字段和命令。由于 master 分支会持续更新，如果页面内容与上游发生差异，请以上游文件为准。

2026-10-16

玲珑应用应用程序打包规范

本文中的关键词必须、禁止、必要的、应当、不应、推荐的、允许以及可选的[^rfc2119-keywords]的解释见于RFC 2119中的描述。这些关键词与原文中的英文词汇的对应关系如下表所示：中文英语必须 MUST 禁止 MUST NOT 必要的 REQUIRED 应当 SHALL 不应 SHALL NOT 推荐的 RECOMME

2026-10-16

构建配置文件简介

linglong.yaml 是如意玲珑项目的描述文件，记录构建所需信息。如构建产物的名称、版本、源码地址、构建依赖等。工程目录结构 {project-root} ├── linglong.yaml └── linglong {user-home} └── .cache └── linglong-builder ├── repo └──

2026-10-16

模块拆分

在如意玲珑构建时，一个应用可以拆分成多个模块，每个模块包含部分构建产物，例如调试符号放到 develop 模块，翻译文件放到 lang-* 模块等。这样用户可以按需安装，缩减应用体积。模块文件开发者在 linglong.yaml 添加 modules 字段，配置如下： modules: - name: 模块1 files: - /pa

2026-10-16

玲珑多架构构建指南

支持的架构当前玲珑打包工具支持以下 CPU 架构： x86_64 arm64（aarch64） loong64 loongarch64（龙芯旧世界） sw64（申威） mips64 构建配置文件的指定 ll-builder build 时会按照下面的顺序查找项目配置文件，并使用第一个找到的项目配置文件。如果指定了 -f 参数，使用 -

2026-10-16

调试如意玲珑应用

以下教程以应用 ID 为 org.deepin.demo 的示例项目为例。先按照下面的步骤准备并构建应用，再进行后续调试。实际调试自己的应用时，请将应用 ID、可执行文件和项目路径替换为当前项目的对应值。准备调试示例创建项目在 /tmp 中创建 org.deepin.demo 项目： cd /tmp ll-builder creat

2026-10-16

如意玲珑文档索引

本文档记录中文 guide 目录当前纳入导航大纲的文档。文档按读者角色分为“入门指南”“用户手册”和“开发者手册”；文件仍按内容类型存放。目录结构 docs/pages/guide/ ├── building/ # 构建相关文档 ├── debug/ # 调试相关文档 ├── desktop-integration/ # 桌面集成文档

2026-10-16

Application run conf

Application run conf is the file how linglong runtime module load the app, and the conf is machine related, the user can set mount path, permission control file to the ap

2026-10-16

捆绑包格式

介绍绿色软件，指的是一些不向系统安装任何文件的二进制程序。绿色软件的基本约束是：路径无关，意味着与本地文件无关。高度兼容性，因此软件应包含系统所没有的所有依赖项。在 Linux 上构建绿色软件的著名技术是 AppImage。然而，该技术存在许多问题，最大的问题是主机系统 ABI 无法保持稳定，并且彼此不同。玲珑也无法解决这个问

2026-10-16

引用（Ref）

定义组件：组件通常等同于其他系统中的 artifacts/component/module/package 等，在玲珑中，我们使用 layer 来表示一个组件。格式 ref 是组件在存储仓库中的唯一标识（存储仓库中的索引信息）。一条完整的 ref 信息包括仓库名、渠道、ID、版本号、架构、分支名等信息。 ref 格式如下： ${rep

2026-10-16

Rootfs

根据 OCI 运行时规范，运行时从 rootfs 开始，但在玲珑中，它在 ll-box 中准备 rootfs。因此我们将构建 rootfs 的信息放在 ll-box 的注释中。注释的示例是： "annotations": { "container_root_path": "/run/user/1000/linglong/375f5681

2026-10-16

ll-cli 运行时配置

ll-cli 运行时配置用于调整应用运行行为或所在容器环境的配置，包括环境变量、挂载点、设备、扩展和桌面集成等。该功能面向熟悉容器与主机安全边界的高级用户和系统管理员。运行时配置可以把主机文件、目录或设备暴露给容器环境。写入配置前应确认来源可信，并只授予应用必需的访问范围。配置变更只对之后运行的程序生效，测试变更前应先退出已有应用实例。

2026-10-16

系统助手

无特权的用户可以通过以下方式将 erofs 挂载到目录： busctl --system call org.deepin.linglong.SystemHelper \ /org/deepin/linglong/FilesystemHelper \ org.deepin.linglong.FilesystemHelper \ Mount

2026-10-16

uab 构建

从面向玲珑构建的项目中创建出一个能够运行的uab文件需要以下几个配置文件： linglong.yaml：玲珑项目的配置文件，决定了该包如何被编译和安装； loader：一个可执行文件，作为uab的入口。 extra-files.txt：一个文本文件，其中写明该应用依赖base和runtime中的哪些文件，这些文件会被拷贝到uab包中，应

2026-10-16

单元测试

如意玲珑使用 gtest 进行单元测试，测试代码和测试数据位于项目根目录的 test/ 目录中。由于某些测试在 CI 环境中难以运行，我们默认禁用了这些测试。以下是控制测试运行的环境变量，默认情况下它们都是空的：名称值说明 LINGLONG_TEST_ALL 如果设置此变量，将运行所有单元测试启用所有测试用例

2026-10-16

玲珑应用构建工程基础知识

在正式开始构建一个玲珑应用工程前，我们需要对玲珑应用构建的基础知识有一定的认知，以此协助我们更好地决定在启动构建工程前需要准备哪些材料、进行哪一类型的操作。玲珑应用构建基本步骤在正式开始构建一个玲珑应用工程前，我们需要了解一个玲珑应用从资源（源代码、二进制文件等）输入到应用安装包导出所经过的基本步骤，来确定我们需要准备哪些必要文件。

2026-10-16

将基于Qt5的开源应用--qBittorrent 适配为支持自动化的玲珑应用构建工程

书接上文, 我们继续探讨如何将 linglong.yaml 适配为支持自动构建的版本由于上一环节我们已经确定了可以正常完成编译构建任务所使用的构建规则, 因此我们本节主要讨论如何利用 git 功能完成下列自动操作自动拉取开源项目git仓库资源自动应用自定义patch内容改造 linglong.yaml 在上一节中我们已经获得了可以

2026-10-16

在玲珑容器中编译基于Qt5的开源应用--qBittorrent

在学习上一章节玲珑应用构建工程基础知识后, 我们即将步入实操课堂, 利用所学知识去正式构建一款玲珑应用. 今天, 我们将演示进入玲珑容器并将一款开源图形应用 qBittorrent 的源代码编译为二进制文件并测试运行前期准备根据玲珑应用构建工程基础知识中对于玲珑应用构建工程通用资源的规范要求, 我们应当为一款图形化应用同时

2026-10-16

将基于Qt5的开源应用--qBittorrent 适配为支持自动化的玲珑应用构建工程 · 离线源码配置

在学习上一章节在玲珑容器中编译基于Qt5的开源应用--qBittorrent 后, 我们已经大概了解了在玲珑容器中通过怎么样的操作可以将基于Qt5的开源应用--qBittorrent项目源代码编译为可以运行的二进制程序文件. 今天, 我们在此基础上补齐玲珑应用构建基本步骤中的最后步骤--编写一份完整的玲珑应用构建工程配置文件 lin

2026-10-16

玲珑应用兼容性测试进阶--玲珑应用自动化测试套件

大家可以发现, 在我们前面的玲珑应用编译之后, 都是通过手动安装软件包、启动应用来检验兼容性的但是这里会衍生出一个问题: 随着需要测试的应用不断增加, 人工测试的方式是否显得相对低效率? 为此, 我向各位介绍如意玲珑社区中目前开放给各生态贡献者使用、学习的玲珑应用自动化测试套件 -- Next Linyaps Testing Tool

2026-10-16

玲珑仓库 mirror 功能设计

在ll-cli和ll-builder中添加了enable-mirror和disable-mirror命令，用于启用和禁用镜像功能。在对某个仓库启用mirror功能时，会更新ostree的config文件，添加contenturl配置项： url=$repo_url/repos/$repo_name gpg-verify=false ht

2026-10-16

仓库

仓库是如意玲珑存储和分发应用程序及运行环境的远程服务。客户端从仓库查询软件包元数据，并在安装时拉取所需内容。安装如意玲珑后，系统会预置默认仓库；用户也可以同时配置来自官方的、社区的或者自托管的多个仓库。仓库配置项执行以下命令可以查看当前配置： ll-cli repo show 输出包含默认仓库以及每个仓库的名称、URL、别名和优先级。

2026-10-16

基础概念介绍

本章从包类型、运行环境、存储与容器、系统架构四个方面介绍如意玲珑的工作原理。第一次构建应用时不必掌握全部细节；遇到 Base/Runtime 选型、驱动、依赖、容器或仓库问题时再按需查阅。包类型与使用场景如意玲珑使用 kind 区分包的职责。应用运行时，系统按需组合 Base、Runtime、App 和 Extension，而不是把所

2026-10-16

显卡驱动 CDI 适配指南

如意玲珑应用的运行容器与宿主机环境隔离，显卡等硬件设备需要通过受控方式注入容器。除驱动程序介绍的扩展（Extension）方式外，驱动厂商还可以采用 CDI（Container Device Interface）方案：以标准化的描述文件声明设备及其注入细节，由玲珑在应用运行时按需加入容器。适配 CDI 方案的整体流程：驱动包提供 CD

2026-10-16

ll-appimage-convert-convert

NAME ll-appimage-convert-convert - 将 AppImage 包转换为如意玲珑包格式 SYNOPSIS ll-appimage-convert convert [flags] DESCRIPTION ll-appimage-convert convert 命令根据指定的应用名称生成一个目录，该目录会作为如意玲

2026-10-16

ll-appimage-convert

NAME ll-appimage-convert - 将 AppImage 包转换为如意玲珑包格式 SYNOPSIS ll-appimage-convert subcommand DESCRIPTION ll-appimage-convert 命令用于将 AppImage 包格式（.appimage 或 .AppImage）转换为如意玲珑

2026-10-16

ll-builder-build

NAME ll-builder-build - 构建如意玲珑项目 SYNOPSIS ll-builder build [options] [command...] DESCRIPTION ll-builder build 命令用来构建如意玲珑应用。构建完成后，构建内容将自动提交到本地 ostree 缓存中。 OPTIONS -h, --h

2026-10-16

- kind: git

NAME ll-builder-create - 创建如意玲珑构建模板 SYNOPSIS ll-builder create [options] name DESCRIPTION ll-builder create 命令根据输入的项目名称在当前目录创建对应的文件夹，同时生成构建所需的 linglong.yaml 模板文件。 OPTIONS

2026-10-16

基本导出

NAME ll-builder-export - 导出如意玲珑 layer 或 UAB 文件 SYNOPSIS ll-builder export [options] DESCRIPTION ll-builder export 默认将本地构建缓存中的包导出为用于安装和分发的 distribution 模式 UAB。使用 --uabx 可生

2026-10-16

ll-builder-extract

NAME ll-builder-extract - 将如意玲珑 layer 文件解压到目录 SYNOPSIS ll-builder extract file directory DESCRIPTION ll-builder extract 命令用于将如意玲珑 layer 文件解压到指定目录。 OPTIONS -h, --help : 打印

2026-10-16

ll-builder-import

NAME ll-builder-import - 导入如意玲珑 layer 文件到构建仓库 SYNOPSIS ll-builder import [options] file DESCRIPTION ll-builder import 命令用于导入如意玲珑 layer 文件到构建仓库。 OPTIONS -h, --help : 打印帮助信

2026-10-16

ll-builder-list

NAME ll-builder-list - 列出已构建的应用程序 SYNOPSIS ll-builder list [options] DESCRIPTION ll-builder list 命令用于列出已构建的应用程序。 OPTIONS -h, --help : 打印帮助信息并退出 --help-all : 展开所有帮助 EXAMPL

2026-10-16

ll-builder

NAME ll-builder - 如意玲珑应用构建工具 SYNOPSIS ll-builder [options] subcommand DESCRIPTION ll-builder 是为应用开发者提供的一款构建如意玲珑应用的工具。它支持在独立容器内构建应用，并包含完整的推送发布流程。主要功能包括：在独立容器内构建应用完整的应用构

2026-10-16

ll-builder-push

NAME ll-builder-push - 推送如意玲珑应用到远程仓库 SYNOPSIS ll-builder push [options] DESCRIPTION ll-builder push 命令用来将如意玲珑软件包推送至如意玲珑远程仓库。命令根据项目配置自动推送所有模块或指定的模块到远程仓库。 OPTIONS -h, --hel

2026-10-16

ll-builder-remove

NAME ll-builder-remove - 删除已构建的应用程序 SYNOPSIS ll-builder remove [options] ref... DESCRIPTION ll-builder remove 命令用于从本地构建仓库删除一个或多个构建结果。每个构建结果必须使用 ll-builder list 输出的完整 ref

2026-10-16

ll-builder-repo

NAME ll-builder-repo - 显示和管理仓库 SYNOPSIS ll-builder repo [options] subcommand DESCRIPTION ll-builder repo 命令用于显示和管理如意玲珑仓库。 OPTIONS -h, --help : 打印帮助信息并退出 --help-all : 展开所有

2026-10-16

ll-builder-run

NAME ll-builder-run - 运行构建好的应用程序 SYNOPSIS ll-builder run [options] [command...] DESCRIPTION ll-builder run 命令根据配置文件读取该程序相关的运行环境信息，构造一个容器环境，并在容器中执行该程序而无需安装。 OPTIONS -h, --

2026-10-16

ll-cli-analyze

NAME ll-cli-analyze - 分析已安装应用 SYNOPSIS ll-cli analyze subcommand [options] DESCRIPTION ll-cli analyze 用于分析已安装模块的磁盘占用和应用依赖关系。必须指定一个子命令。 SUBCOMMANDS size 显示已安装模块的磁盘占用以及仓库的实

2026-10-16

ll-cli-content

NAME ll-cli-content - 显示应用导出文件 SYNOPSIS ll-cli content [options] app DESCRIPTION 使用 ll-cli content 显示应用导出文件。该命令用于显示已安装应用程序导出的文件路径，包括桌面文件、元信息文件等。 OPTIONS -h, --help : 打印帮助

2026-10-16

ll-cli-enter

NAME ll-cli-enter - 在当前运行的沙盒中执行命令 SYNOPSIS ll-cli enter [options] instance command... DESCRIPTION ll-cli enter 命令可以进入正在运行的容器内部。该命令允许用户在正在运行的应用程序容器中执行指定的命令。 OPTIONS -h, --

2026-10-16

ll-cli-info

NAME ll-cli-info - 显示已安装的应用程序或运行时的信息 SYNOPSIS ll-cli info [options] app DESCRIPTION 使用 ll-cli info 显示已安装的应用程序或运行时的信息。该命令以 JSON 格式显示应用程序或运行时的详细信息，包括架构、基础环境、运行时、描述等。 OPTION

2026-10-16

ll-cli-install

NAME ll-cli-install - 安装应用程序或运行时 SYNOPSIS ll-cli install [options] app DESCRIPTION ll-cli install 命令用来安装如意玲珑应用。该命令支持通过应用名、.layer 文件或 .uab 文件安装应用程序或运行时。 OPTIONS -h, --help

2026-10-16

ll-cli-kill

NAME ll-cli-kill - 停止运行的应用程序 SYNOPSIS ll-cli kill [options] app DESCRIPTION ll-cli kill 命令可以强制退出正在运行的玲珑应用。该命令用于终止正在运行的应用程序进程。 OPTIONS -h, --help : 打印帮助信息并退出 --help-all :

2026-10-16

ll-cli-list

NAME ll-cli-list - 列出已安装的应用程序或运行时 SYNOPSIS ll-cli list [options] DESCRIPTION ll-cli list 命令可以查看已安装的玲珑应用。该命令用于显示系统中已安装的应用程序、运行时和基础环境的详细信息。 OPTIONS -h, --help : 打印帮助信息并退出 -

2026-10-16

ll-cli

NAME ll-cli - 如意玲珑命令行工具，用于管理应用程序和运行时 SYNOPSIS ll-cli [global-options] subcommand [subcommand-options] DESCRIPTION ll-cli 是一个包管理器前端，用于管理如意玲珑应用的安装、卸载、查看、启动、关闭、调试、更新等操作。它提供了

2026-10-16

ll-cli-prune

NAME ll-cli-prune - 移除未使用的最小系统或运行时 SYNOPSIS ll-cli prune [options] DESCRIPTION 使用 ll-cli prune 移除未使用的最小系统或运行时。该命令用于清理系统中不再被任何应用程序使用的基础环境或运行时组件，释放磁盘空间。 OPTIONS -h, --help

2026-10-16

ll-cli-ps

NAME ll-cli-ps - 列出正在运行的应用程序 SYNOPSIS ll-cli ps [options] DESCRIPTION ll-cli ps 命令可以查看正在运行的如意玲珑应用。该命令显示当前系统中所有正在运行的玲珑应用程序及其相关信息。 OPTIONS -h, --help : 打印帮助信息并退出 --help-all

2026-10-16

ll-cli-repo

NAME ll-cli-repo - 显示或修改当前使用的仓库信息 SYNOPSIS ll-cli repo subcommand [options] DESCRIPTION ll-cli repo 命令用于管理远程仓库。该命令提供了一系列子命令来添加、修改、删除、显示和配置仓库信息。 SUBCOMMANDS add 添加一个新的仓库。

2026-10-16

ll-cli-run

NAME ll-cli-run - 运行应用程序 SYNOPSIS ll-cli run [options] app [command...] DESCRIPTION ll-cli run 命令可以启动一个如意玲珑应用。该命令支持通过应用名运行应用程序，也可以在容器中执行命令而不是运行应用程序。高级用户可以通过 ll-cli 运行时配置

2026-10-16

ll-cli-search

NAME ll-cli-search - 从远程仓库中搜索包含指定关键词的应用程序/运行时 SYNOPSIS ll-cli search [options] keywords DESCRIPTION ll-cli search 命令可以查询如意玲珑远程仓库中的应用信息。该命令用于从远程仓库中搜索包含指定关键词的应用程序、运行时或基础环境。

2026-10-16

ll-cli-uninstall

NAME ll-cli-uninstall - 卸载应用程序或运行时 SYNOPSIS ll-cli uninstall [options] app DESCRIPTION ll-cli uninstall 命令可以卸载已安装的玲珑应用。Base 和 Runtime 默认受卸载保护，未使用的 Base 和 Runtime 应使用 ll-c

2026-10-16

ll-cli-upgrade

NAME ll-cli-upgrade - 升级应用程序或运行时 SYNOPSIS ll-cli upgrade [options] [app] DESCRIPTION ll-cli upgrade 命令可以更新玲珑应用。该命令用于将已安装的应用程序或运行时升级到远程仓库中的最新版本。 OPTIONS -h, --help : 打印帮助信

2026-10-16

ll-pica-adep

NAME ll-pica-adep - 给 linglong.yaml 文件添加包依赖 SYNOPSIS ll-pica adep [flags] DESCRIPTION ll-pica adep 命令用于给 linglong.yaml 文件添加包依赖。玲珑应用可能缺少包依赖，可以通过此命令在 linglong.yaml 文件添加对应的包

2026-10-16

ll-pica-convert

NAME ll-pica-convert - 将 deb 包转换为玲珑包 SYNOPSIS ll-pica convert [flags] DESCRIPTION ll-pica convert 命令用来生成玲珑需要使用的 linglong.yaml 文件，并将 deb 包转换为玲珑包。该命令支持从本地 deb 文件或通过 apt dow

2026-10-16

ll-pica-init

NAME ll-pica-init - 初始化转换包的配置信息 SYNOPSIS ll-pica init [flags] DESCRIPTION ll-pica init 命令用来初始化转换包的配置信息。该命令会读取 ~/.pica/config.json 文件来生成 package.yaml 配置文件，该文件是 ll-pica 转换

2026-10-16

转换配置文件简介

package.yaml 是 ll-pica 转换 deb 包的基础信息。如构建的 base、runtime 的版本，需要被转换的 deb 包。工程目录结构 {workdir} ├── package │ └── {appid} │ ├── linglong │ ├── linglong.yaml │ └── start.sh └──

2026-10-16

ll-pica

NAME ll-pica - 将 deb 包转换为玲珑包的工具 SYNOPSIS ll-pica subcommand DESCRIPTION ll-pica 命令提供将 deb 包转换为玲珑包的能力，生成构建玲珑应用需要的 linglong.yaml 文件，并依赖 ll-builder 来实现应用构建和导出。目前只支持转换符合应用商店打

2026-10-16

ll-pica-flatpak-convert

NAME ll-pica-flatpak-convert - 将 Flatpak 应用转换为玲珑应用 SYNOPSIS ll-pica-flatpak convert [flags] DESCRIPTION ll-pica-flatpak convert 命令用于将 Flatpak 应用转换为玲珑应用。该命令使用 ostree 命令拉取

2026-10-16

ll-pica-flatpak

NAME ll-pica-flatpak - 将 Flatpak 应用转换为玲珑应用 SYNOPSIS ll-pica-flatpak subcommand DESCRIPTION ll-pica-flatpak 命令用于将 Flatpak 应用转换为玲珑应用。该工具使用 ostree 命令拉取 Flatpak 应用数据，根据 metad

2026-10-16

如意玲珑显卡驱动说明

如意玲珑运行环境是与宿主机环境隔离的，运行如意玲珑程序时如果需要使用显卡硬件加速功能，需要满足两个条件：宿主机正确安装、配置了显卡驱动。在如意玲珑环境中安装对应的驱动包。已适配的显卡驱动列表 Mesa 开源驱动在应用依赖的 base 中已经携带了对应版本的 mesa，不需要额外的安装。mesa 开源驱动包括： amdgpu，新的

2026-10-16

org.deepin.Runtime 20.0.0 Develop Packages

libqt5core5a libqt5gui5 qt5-gtk-platformtheme qt5-flatpak-platformtheme libqt5network5 libqt5opengl5 libqt5sql5 libqt5sql5-mysql libqt5sql5-odbc libqt5sql5-psql libqt5sql

2026-10-16

org.deepin.base 23.1.0 Develop Packages

acl adduser adwaita-icon-theme apt at-spi2-common base-files base-passwd bash bc binutils binutils-common binutils-x86-64-linux-gnu bluez bluez-obexd bsdextrautils bsduti

2026-10-16

org.deepin.base 25.2.2 Binary Packages

acl 2.3.1-3 adduser 3.131-1deepin2 adwaita-icon-theme 48.1-1 at-spi2-common 2.50.0-1 base-files 25-6deepin4 base-passwd 3.6.5 bash 5.2.21-2.1 bc 1.07.1-deepin1 binutils 2

2026-10-16

org.deepin.base 25.2.2 Develop Packages

acl 2.3.1-3 adduser 3.131-1deepin2 adwaita-icon-theme 48.1-1 apt 2.8.0deepin5 at-spi2-common 2.50.0-1 autoconf 2.72-3 automake 1:1.17-4 autotools-dev 20240727.1 base-file

2026-10-16

org.deepin.foundation 20.0.0 Develop Packages

adduser adwaita-icon-theme apt base-files base-passwd bash bsdutils ca-certificates coreutils dash dbus dbus-user-session dconf-gsettings-backend dconf-service debconf de

2026-10-16

org.deepin.runtime.dtk 23.1.0 Develop Packages

libqt5core5a libqt5gui5 qt5-gtk-platformtheme qt5-flatpak-platformtheme libqt5network5 libqt5opengl5 libqt5sql5 libqt5sql5-mysql libqt5sql5-odbc libqt5sql5-psql libqt5sql

2026-10-16

org.deepin.runtime.dtk 25.2.2 Develop Packages

assistant-qt6 6.8.0-0deepin3 dbus-broker 29-3 dde-qt6integration 6.0.46 dde-qt6xcb-plugin 6.0.46 deepin-shortcut-viewer 5.5.6 designer-qt6 6.8.0-0deepin3 dpkg-dev 1.22.6d

2026-10-16

org.deepin.runtime.webengine 25.2.2 Develop Packages

assistant-qt6 6.8.0-0deepin3 dbus-broker 29-3 dde-qt6integration 6.0.46 dde-qt6xcb-plugin 6.0.46 deepin-shortcut-viewer 5.5.6 designer-qt6 6.8.0-0deepin3 dpkg-dev 1.22.6d

2026-10-16

base 和 runtime 介绍

在玲珑应用打包体系中，base 提供基础运行环境，runtime 提供应用框架支持，两者采用分层依赖关系。正确选型可确保应用跨发行版的兼容性，建议遵循以下选型原则： ‌base 优先原则‌：先选择应用已适配的发行版对应的base ‌runtime 继承原则‌：runtime必须和base保持兼容本文档将详细介绍 base 和 runti

2026-10-16

构建第一个如意玲珑应用

本章是开发者入门路线，将以 deepin-calculator 为例完成配置、构建、调试、运行验证和分发。如果您还没有安装或运行过如意玲珑应用，请先完成快速上手。首先确认命令是否可用： ll-builder --version 如果命令找不到，推荐使用安装脚本的 full 模式，同时安装如意玲珑和 ll-builder 构建工具： cu

2026-10-16

安装如意玲珑

deepin/UOS 的部分版本已经预装如意玲珑。请先执行 ll-cli --version；如果命令可用，可以直接继续快速上手。其他 Linux 发行版请按本页对应小节配置软件源并安装。普通用户至少需要安装 linglong-bin，构建应用的开发者还需要安装 linglong-builder。如意玲珑命令行工具主要包括： ll-cl

2026-10-16

ll-builder 工作流

ll-builder 是如意玲珑的应用构建工具。它读取项目中的 linglong.yaml，准备应用依赖和源码，在隔离环境中执行构建，并将构建结果保存到本地仓库，供后续调试、验证和分发。如果希望直接完成一次实际构建，请阅读构建第一个如意玲珑应用。本章重点说明各命令在完整开发流程中的位置，以及 ll-builder build 的工作原理

2026-10-16

通过 CLI 管理应用

假设您已经完成快速上手，能够通过 search、install、run 命令来搜索、安装和运行应用。本章将继续介绍如何使用 ll-cli 管理应用，主要分为以下两部分：管理已安装的应用，包括查看、升级和卸载应用。管理正在运行的应用，包括查看和停止应用。管理已安装的应用安装指定版本的应用先查询仓库中提供的全部版本： ll-cli

2026-10-16

通过 CLI 管理运行时

本章介绍如何使用 ll-cli 管理已安装的运行时（关于运行时应先了解 Base、Runtime 和 App 的分层关系，参见基础概念介绍）。主要面向需要排查依赖、控制磁盘占用或手动控制运行环境的高级用户。运行时通常由应用安装过程自动拉取并被多个应用共享，日常使用不需要单独操作运行时，只有在诊断兼容性问题、回收磁盘空间或修复异常依赖状态时

2026-10-16

快速上手

本章面向使用如意玲珑应用的终端用户。完成下面的步骤后，您将能够使用 ll-cli 搜索、安装和运行应用。准备 ll-cli deepin/UOS 的部分版本已预装 ll-cli。先在终端确认当前版本： ll-cli --version 如果提示找不到命令，可以使用下面的一行命令快速安装： curl -fsSL https://get.l

2026-10-16

如意玲珑发布日志

1.14 版本 🚀 新功能调试模式： ll-cli run 新增 --debug 模式，通过 gdbserver 启动应用，并支持 --debug-listen、--debug-debuginfod 和 --debug-symbol-dir 选项，便于直接连接调试器。依赖与体积分析：新增 ll-cli analyze depends

2026-10-16

概述

如意玲珑是统信软件自研的开源软件包格式，定义了新的应用程序管理范式，覆盖了应用程序从开发到分发，再到运行的全生命周期。入门如果您是第一次使用如意玲珑，推荐阅读快速上手，了解如何通过如意玲珑搜索、安装和运行应用。如果您是应用开发者，想了解玲珑包格式，或者通过玲珑包格式分发应用，推荐从构建第一个如意玲珑应用开始，完成一次完整的构建流程。

2026-10-16

常见运行问题

应用运行读取 /usr/share下应用安装资源文件，为什么读取失败？如意玲珑应用是在容器环境中运行，应用数据会挂载到 /opt/apps/<appid>/下，/usr/share目录下只会存在系统数据，不会存在应用相关数据。因此直接读取 /usr/share 会失败。建议处理：采用 XDG_DATA_DIRS 环境变量读取资源，/op

2026-10-16

常见构建问题

cmake类型构建，出现-lxxx失败，但ldconfig与pkg-config均能查询到该库信息。链接库路径不在常规路径，新路径为/runtime/lib。添加环境变量 LIBRARY_PATH=<libpath>，目前构建环境已默认包含该环境变量。构建时link静态库失败，要求重新使用fPIC构建。构建静态库时使用-fPIC参

2026-10-16

常见问题

ll-pica 生成的 linglong.yaml 文件的默认配置在哪里？ ll-pica 配置文件在 ~/.pica/config.json。 ll-pica 无法转换，wine、安卓、输入法、安全类软件吗？如意玲珑应用目前不支持这类应用，ll-pica 也无法转换。为什么需要使用音频的软件没有声音？提示 not found li