Sitemap

2026-10-16

Building Linglong Apps with CI/CD

This chapter explains how to automate the build of Linglong apps in two ways: with GitHub Actions and with Docker.

2026-10-16

Convert from deb Manually

This chapter uses the amd64 deb package of Google Antigravity to show how to unpack a deb in linglong.yaml, reorganize the application directory, correct desktop entries…

2026-10-16

Understanding a Build Configuration Example

This chapter uses linglong.yaml from the master branch of the Linyaps repository to explain how a real project organizes package information, sources, build commands, and…

2026-10-16

Linyaps Application Packaging Specification

The keywords MUST, MUST NOT, REQUIRED, SHALL, SHALL NOT, RECOMMENDED, MAY, and OPTIONAL[^rfc2119-keywords] in this document shall be interpreted as described in RFC 2119.

2026-10-16

Build Configuration File Introduction

linglong.yaml is the description file for Linyaps project engineering, which records relevant information needed for building, such as build artifact names, versions…

2026-10-16

Module Splitting

When building with Linyaps, an application can be split into multiple modules, each containing part of the build artifacts.

2026-10-16

Linyaps Multi-Architecture Build Guide

The current Linyaps packaging tool supports the following CPU architectures:

2026-10-16

Debugging Linyaps Applications

This tutorial uses an example project with the application ID org.deepin.demo. Prepare and build the application as shown below before debugging it.

2026-10-16

Linyaps Documentation Index

This document lists the documents currently included in the navigation outline of the English guide directory.

2026-10-16

Additional Documentation Topics

This directory contains additional documentation and advanced topics for Linyaps development.

2026-10-16

Application Runtime Configuration

Application runtime configuration is the file that describes how the Linyaps runtime module loads the application.

2026-10-16

Bundle Format

Green software refers to binaries that do not install any files to the system.

2026-10-16

Reference (Ref)

Component: A component is generally equivalent to artifacts/component/module/package in other systems. In Linyaps, we use "layer" to represent a component.

2026-10-16

Root Filesystem (Rootfs)

As per the OCI runtime specification, the runtime starts from a rootfs, but in Linyaps, it prepares rootfs in ll-box.

2026-10-16

ll-cli Runtime Configuration

The ll-cli runtime configuration adjusts application behavior and the container environment, including environment variables, mounts, devices, extensions, and desktop…

2026-10-16

System Helper

Users without privileges can mount erofs filesystems to directories using the following D-Bus call:

2026-10-16

uab Build

Creating a runnable uab file from a Linyaps-oriented project requires the following configuration files:

2026-10-16

Unit Testing

Linyaps utilizes GoogleTest (gtest) as its unit testing framework. Simply include your test code and test data in the test/ directory at the project root.

2026-10-16

Basic Knowledge of Linyaps Application Build Projects

Before officially starting to build a Linyaps application project, we need to have a certain understanding of the basic knowledge regarding Linyaps application building.

2026-10-16

Adapting Qt5-Based Open Source Application -- qBittorrent to Support Automated Linyaps Application Build Projects

Continuing from the previous chapter, we will explore how to adapt the linglong.yaml to support automated build versions.

2026-10-16

Compiling Qt5-Based Open Source Application -- qBittorrent in Linyaps Container

After learning the Basic Knowledge of Linyaps Application Build Projects in the previous chapter, we are about to enter the practical classroom and use the knowledge we…

2026-10-16

Adapting Qt5-based Open Source Application--qBittorrent to Support Automated Linyaps Application Build Project

After learning from the previous chapter "Compiling Qt5-based Open Source Application--qBittorrent in Linyaps Container", we have roughly understood how to compile the…

2026-10-16

Advanced Linyaps Application Compatibility Testing -- Linyaps Application Automated Testing Suite

As you may have noticed, in our previous Linyaps application compilation, we manually installed packages and launched applications to test compatibility However, this…

2026-10-16

Linyaps Repository Mirror Function Design

The enable-mirror and disable-mirror commands have been added to ll-cli and ll-builder to enable and disable mirror functionality.

2026-10-16

Repositories

A repository is a remote service used by Linyaps to store and distribute applications and runtime environments.

2026-10-16

UAB Application Publishing

This document supplements the relevant content for application publishing using UAB (Universal Application Bundle).

2026-10-16

Basic Concepts

This chapter explains how Linyaps works from four perspectives: package kinds, runtime environments, storage and containers, and system architecture.

2026-10-16

Linyaps Graphics Driver CDI Adaptation Guide

The runtime container of a Linyaps application is isolated from the host system, so graphics cards and other hardware devices must be injected into the container in a…

2026-10-16

ll-appimage-convert-convert

The ll-appimage-convert convert command generates a directory based on the specified application name, which serves as the root directory of the Linyaps project, i.e.…

2026-10-16

ll-appimage-convert

The ll-appimage-convert command is used to convert AppImage package formats (.appimage or .AppImage) to Linyaps package formats (.layer or .uab).

2026-10-16

ll-builder-build

The ll-builder build command is used to build Linyaps applications.

2026-10-16

ll-builder-create

The ll-builder create command creates a corresponding folder in the current directory based on the input project name, and generates the required linglong.yaml template…

2026-10-16

Basic export

ll-builder export exports packages from the local build cache. By default it creates a distribution-mode UAB for installation and distribution.

2026-10-16

ll-builder-extract

The ll-builder extract command is used to extract Linyaps layer files to a specified directory.

2026-10-16

ll-builder-import

The ll-builder import command is used to import Linyaps layer files to the build repository.

2026-10-16

ll-builder-list

The ll-builder list command is used to list built applications.

2026-10-16

ll-builder

ll-builder is a tool provided for application developers to build Linyaps applications.

2026-10-16

ll-builder-push

The ll-builder push command is used to push Linyaps packages to the Linyaps remote repository.

2026-10-16

ll-builder-remove

The ll-builder remove command removes one or more build results from the local build repository. Specify each result using the complete ref shown by ll-builder list.

2026-10-16

ll-builder-repo

The ll-builder repo command is used to display and manage Linyaps repositories.

2026-10-16

ll-builder-run

The ll-builder run command reads the runtime environment information related to the program based on the configuration file, constructs a container environment, and…

2026-10-16

ll-cli-analyze

ll-cli analyze analyzes the disk usage of installed modules and application dependency relationships. A subcommand is required.

2026-10-16

ll-cli-content

Use ll-cli content to display application exported files.

2026-10-16

ll-cli-enter

The ll-cli enter command can enter the interior of a running container. This command allows users to execute specified commands in the running application container.

2026-10-16

ll-cli-info

Use ll-cli info to display information about installed applications or runtimes.

2026-10-16

ll-cli-install

The ll-cli install command is used to install Linyaps applications. This command supports installing applications or runtimes through application names, .layer files, or .

2026-10-16

ll-cli-kill

The ll-cli kill command can forcefully exit running Linyaps applications. This command is used to terminate running application processes.

2026-10-16

ll-cli-list

The ll-cli list command can view installed Linyaps applications.

2026-10-16

ll-cli

ll-cli is a package manager frontend for managing Linyaps application installation, uninstallation, viewing, launching, termination, debugging, updating, and other…

2026-10-16

ll-cli-prune

Use ll-cli prune to remove unused minimal systems or runtimes.

2026-10-16

ll-cli-ps

The ll-cli ps command can view running Linyaps applications. This command displays all currently running Linyaps applications in the system and their related information.

2026-10-16

ll-cli-repo

The ll-cli repo command is used to manage remote repositories.

2026-10-16

ll-cli-run

The ll-cli run command can start a Linyaps application.

2026-10-16

ll-cli-search

The ll-cli search command can query application information from Linyaps remote repositories.

2026-10-16

ll-cli-uninstall

The ll-cli uninstall command removes installed Linyaps applications.

2026-10-16

ll-cli-upgrade

The ll-cli upgrade command can update Linyaps applications.

2026-10-16

ll-pica-adep

The ll-pica adep command is used to add package dependencies to the linglong.yaml file.

2026-10-16

ll-pica-convert

The ll-pica convert command is used to generate the linglong.yaml file needed by Linyaps and convert deb packages to Linyaps packages.

2026-10-16

ll-pica-init

The ll-pica init command is used to initialize conversion package configuration information.

2026-10-16

Conversion Configuration File Introduction

package.yaml is the basic information file for ll-pica to convert deb packages.

2026-10-16

ll-pica

The ll-pica command provides the ability to convert deb packages to Linyaps packages, generating the linglong.yaml file needed to build Linyaps applications, and relies…

2026-10-16

ll-pica-flatpak-convert

The ll-pica-flatpak convert command is used to convert Flatpak applications to Linyaps applications.

2026-10-16

ll-pica-flatpak

The ll-pica-flatpak command is used to convert Flatpak applications to Linyaps applications.

2026-10-16

Linyaps Graphics Driver Guide

The Linyaps runtime environment is isolated from the host system environment.

2026-10-16

Introduction to Base and Runtime

In the Linyaps packaging system, a Base provides the fundamental runtime environment and a Runtime provides application-framework support.

2026-10-16

Build Your First Linyaps Application

This developer introduction uses deepin-calculator to complete configuration, building, debugging, runtime validation, and distribution.

2026-10-16

Install Linyaps

Some deepin and UOS releases already include Linyaps. Run ll-cli --version first; if the command is available, you can continue to Quick Start.

2026-10-16

ll-builder Workflow

ll-builder is the Linyaps application build tool.

2026-10-16

Manage Applications with the CLI

This chapter assumes that you have completed the Quick Start and can use search, install, and run to search for, install, and run applications. It covers two areas:

2026-10-16

Manage Runtimes with the CLI

This chapter explains how to manage installed runtimes with ll-cli.

2026-10-16

Quick Start

This chapter is intended for end users of Linyaps applications.

2026-10-16

Linyaps Release Notes

GPU Support: The application runtime now supports graphics processing unit (GPU) capabilities to improve computing performance and rendering efficiency.

2026-10-16

Overview

Linyaps is an open source package format developed by UnionTech Software.

2026-10-16

Common Runtime Issues

Why does the application fail to read resource files under /usr/share during runtime?

2026-10-16

Common Build Issues

For cmake type builds, -lxxx fails but both ldconfig and pkg-config can query the library information.

2026-10-16

Common Issues

Where is the default configuration for the linglong.yaml file generated by ll-pica?

2026-10-16

使用 CI/CD 构建玲珑应用

本章介绍如何通过 GitHub Actions 和 Docker 两种方式自动化构建玲珑应用。

2026-10-16

手动从 deb 转换

本章以 Google Antigravity 的 amd64 deb 软件包为例，介绍如何在 linglong.yaml 中解包 deb、重新组织应用目录、修正桌面入口并补充运行依赖。

2026-10-16

构建配置示例解读

本章以 Linyaps 仓库 master 分支中的 linglong.yaml 为例，解读一个真实项目如何组织包信息、源码、构建命令和构建依赖。为便于逐行核对，本页摘录固定到 2bd8bf49 提交。

2026-10-16

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

本文中的关键词必须、禁止、必要的、应当、不应、推荐的、允许以及可选的[^rfc2119-keywords]的解释见于RFC 2119中的描述。

2026-10-16

构建配置文件简介

linglong.yaml 是如意玲珑项目的描述文件，记录构建所需信息。如构建产物的名称、版本、源码地址、构建依赖等。

2026-10-16

模块拆分

在如意玲珑构建时，一个应用可以拆分成多个模块，每个模块包含部分构建产物，例如调试符号放到 develop 模块，翻译文件放到 lang-* 模块等。这样用户可以按需安装，缩减应用体积。

2026-10-16

玲珑多架构构建指南

当前玲珑打包工具支持以下 CPU 架构：

2026-10-16

调试如意玲珑应用

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

2026-10-16

如意玲珑文档索引

本文档记录中文 guide 目录当前纳入导航大纲的文档。文档按读者角色分为“入门指南”“用户手册”和“开发者手册”；文件仍按内容类型存放。

2026-10-16

Application run conf

Application run conf is the file how linglong runtime module load the app,

2026-10-16

捆绑包格式

绿色软件，指的是一些不向系统安装任何文件的二进制程序。

2026-10-16

引用（Ref）

组件：组件通常等同于其他系统中的 artifacts/component/module/package 等，在玲珑中，我们使用 layer 来表示一个组件。

2026-10-16

Rootfs

根据 OCI 运行时规范，运行时从 rootfs 开始，但在玲珑中，它在 ll-box 中准备 rootfs。因此我们将构建 rootfs 的信息放在 ll-box 的注释中。

2026-10-16

ll-cli 运行时配置

ll-cli 运行时配置用于调整应用运行行为或所在容器环境的配置，包括环境变量、挂载点、设备、扩展和桌面集成等。该功能面向熟悉容器与主机安全边界的高级用户和系统管理员。

2026-10-16

系统助手

无特权的用户可以通过以下方式将 erofs 挂载到目录：

2026-10-16

uab 构建

从面向玲珑构建的项目中创建出一个能够运行的uab文件需要以下几个配置文件：

2026-10-16

单元测试

如意玲珑使用 gtest 进行单元测试，测试代码和测试数据位于项目根目录的 test/ 目录中。

2026-10-16

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

在正式开始构建一个玲珑应用工程前，我们需要对玲珑应用构建的基础知识有一定的认知，以此协助我们更好地决定在启动构建工程前需要准备哪些材料、进行哪一类型的操作。

2026-10-16

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

书接上文, 我们继续探讨如何将 linglong.yaml 适配为支持自动构建的版本由于上一环节我们已经确定了可以正常完成编译构建任务所使用的构建规则, 因此我们本节主要讨论如何利用 git 功能完成下列自动操作

2026-10-16

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

在学习上一章节玲珑应用构建工程基础知识后, 我们即将步入实操课堂, 利用所学知识去正式构建一款玲珑应用. 今天, 我们将演示进入玲珑容器并将一款开源图形应用 qBittorrent 的源代码编译为二进制文件并测试运行

2026-10-16

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

在学习上一章节在玲珑容器中编译基于Qt5的开源应用--qBittorrent 后, 我们已经大概了解了在玲珑容器中通过怎么样的操作可以将基于Qt5的开源应用--qBittorrent项目源代码编译为可以运行的二进制程序文件.

2026-10-16

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

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

2026-10-16

玲珑仓库 mirror 功能设计

在ll-cli和ll-builder中添加了enable-mirror和disable-mirror命令，用于启用和禁用镜像功能。

2026-10-16

仓库

仓库是如意玲珑存储和分发应用程序及运行环境的远程服务。客户端从仓库查询软件包元数据，并在安装时拉取所需内容。安装如意玲珑后，系统会预置默认仓库；用户也可以同时配置来自官方的、社区的或者自托管的多个仓库。

2026-10-16

基础概念介绍

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

2026-10-16

显卡驱动 CDI 适配指南

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

2026-10-16

ll-appimage-convert-convert

ll-appimage-convert convert 命令根据指定的应用名称生成一个目录，该目录会作为如意玲珑项目的根目录，即 linglong.yaml 文件所在的位置。它支持两种转换方法：

2026-10-16

ll-appimage-convert

ll-appimage-convert 命令用于将 AppImage 包格式（.appimage 或 .AppImage）转换为如意玲珑包格式（.layer 或 .uab）。该工具会生成构建如意玲珑应用需要的 linglong.yaml 文件，并依赖 ll-builder 来实现应用构建和导出。

2026-10-16

ll-builder-build

ll-builder build 命令用来构建如意玲珑应用。构建完成后，构建内容将自动提交到本地 ostree 缓存中。

2026-10-16

ll-builder-create

ll-builder create 命令根据输入的项目名称在当前目录创建对应的文件夹，同时生成构建所需的 linglong.yaml 模板文件。

2026-10-16

基本导出

ll-builder export 默认将本地构建缓存中的包导出为用于安装和分发的 distribution 模式 UAB。使用 --uabx 可生成只包含应用自身、可直接执行的 UABX。也可以导出为已弃用的 linglong layer 文件格式。

2026-10-16

ll-builder-extract

ll-builder extract 命令用于将如意玲珑 layer 文件解压到指定目录。

2026-10-16

ll-builder-import

ll-builder import 命令用于导入如意玲珑 layer 文件到构建仓库。

2026-10-16

ll-builder-list

ll-builder list 命令用于列出已构建的应用程序。

2026-10-16

ll-builder

ll-builder 是为应用开发者提供的一款构建如意玲珑应用的工具。它支持在独立容器内构建应用，并包含完整的推送发布流程。

2026-10-16

ll-builder-push

ll-builder push 命令用来将如意玲珑软件包推送至如意玲珑远程仓库。命令根据项目配置自动推送所有模块或指定的模块到远程仓库。

2026-10-16

ll-builder-remove

ll-builder remove 命令用于从本地构建仓库删除一个或多个构建结果。每个构建结果必须使用 ll-builder list 输出的完整 ref 指定。

2026-10-16

ll-builder-repo

ll-builder repo 命令用于显示和管理如意玲珑仓库。

2026-10-16

ll-builder-run

ll-builder run 命令根据配置文件读取该程序相关的运行环境信息，构造一个容器环境，并在容器中执行该程序而无需安装。

2026-10-16

ll-cli-analyze

ll-cli analyze 用于分析已安装模块的磁盘占用和应用依赖关系。必须指定一个子命令。

2026-10-16

ll-cli-content

使用 ll-cli content 显示应用导出文件。该命令用于显示已安装应用程序导出的文件路径，包括桌面文件、元信息文件等。

2026-10-16

ll-cli-enter

ll-cli enter 命令可以进入正在运行的容器内部。该命令允许用户在正在运行的应用程序容器中执行指定的命令。

2026-10-16

ll-cli-info

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

2026-10-16

ll-cli-install

ll-cli install 命令用来安装如意玲珑应用。该命令支持通过应用名、.layer 文件或 .uab 文件安装应用程序或运行时。

2026-10-16

ll-cli-kill

ll-cli kill 命令可以强制退出正在运行的玲珑应用。该命令用于终止正在运行的应用程序进程。

2026-10-16

ll-cli-list

ll-cli list 命令可以查看已安装的玲珑应用。该命令用于显示系统中已安装的应用程序、运行时和基础环境的详细信息。

2026-10-16

ll-cli

ll-cli 是一个包管理器前端，用于管理如意玲珑应用的安装、卸载、查看、启动、关闭、调试、更新等操作。它提供了完整的应用程序生命周期管理功能。

2026-10-16

ll-cli-prune

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

2026-10-16

ll-cli-ps

ll-cli ps 命令可以查看正在运行的如意玲珑应用。该命令显示当前系统中所有正在运行的玲珑应用程序及其相关信息。

2026-10-16

ll-cli-repo

ll-cli repo 命令用于管理远程仓库。该命令提供了一系列子命令来添加、修改、删除、显示和配置仓库信息。

2026-10-16

ll-cli-run

ll-cli run 命令可以启动一个如意玲珑应用。该命令支持通过应用名运行应用程序，也可以在容器中执行命令而不是运行应用程序。

2026-10-16

ll-cli-search

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

2026-10-16

ll-cli-uninstall

ll-cli uninstall 命令可以卸载已安装的玲珑应用。Base 和 Runtime 默认受卸载保护，未使用的 Base 和 Runtime 应使用 ll-cli prune 清理。

2026-10-16

ll-cli-upgrade

ll-cli upgrade 命令可以更新玲珑应用。该命令用于将已安装的应用程序或运行时升级到远程仓库中的最新版本。

2026-10-16

ll-pica-adep

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

2026-10-16

ll-pica-convert

ll-pica convert 命令用来生成玲珑需要使用的 linglong.yaml 文件，并将 deb 包转换为玲珑包。该命令支持从本地 deb 文件或通过 apt download 命令从仓库下载 deb 包进行转换。

2026-10-16

ll-pica-init

ll-pica init 命令用来初始化转换包的配置信息。该命令会读取 ~/.pica/config.json 文件来生成 package.yaml 配置文件，该文件是 ll-pica 转换 deb 包的基础信息，包含构建的 base、runtime 的版本，以及需要被转换的 deb 包信息。

2026-10-16

转换配置文件简介

package.yaml 是 ll-pica 转换 deb 包的基础信息。如构建的 base、runtime 的版本，需要被转换的 deb 包。

2026-10-16

ll-pica

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

2026-10-16

ll-pica-flatpak-convert

ll-pica-flatpak convert 命令用于将 Flatpak 应用转换为玲珑应用。该命令使用 ostree 命令拉取 Flatpak 应用数据，根据 metadata 中定义的 runtime 对应生成玲珑的 base 环境。

2026-10-16

ll-pica-flatpak

ll-pica-flatpak 命令用于将 Flatpak 应用转换为玲珑应用。该工具使用 ostree 命令拉取 Flatpak 应用数据，根据 metadata 中定义的 runtime 对应生成玲珑的 base 环境，并生成构建玲珑应用需要的 linglong.yaml 文件。

2026-10-16

如意玲珑显卡驱动说明

如意玲珑运行环境是与宿主机环境隔离的，运行如意玲珑程序时如果需要使用显卡硬件加速功能，需要满足两个条件：

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…

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…

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…

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…

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…

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…

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…

2026-10-16

base 和 runtime 介绍

在玲珑应用打包体系中，base 提供基础运行环境，runtime 提供应用框架支持，两者采用分层依赖关系。正确选型可确保应用跨发行版的兼容性，建议遵循以下选型原则：

2026-10-16

构建第一个如意玲珑应用

本章是开发者入门路线，将以 deepin-calculator 为例完成配置、构建、调试、运行验证和分发。如果您还没有安装或运行过如意玲珑应用，请先完成快速上手。

2026-10-16

安装如意玲珑

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

2026-10-16

ll-builder 工作流

ll-builder 是如意玲珑的应用构建工具。它读取项目中的 linglong.yaml，准备应用依赖和源码，在隔离环境中执行构建，并将构建结果保存到本地仓库，供后续调试、验证和分发。

2026-10-16

通过 CLI 管理应用

假设您已经完成快速上手，能够通过 search、install、run 命令来搜索、安装和运行应用。本章将继续介绍如何使用 ll-cli 管理应用，主要分为以下两部分：

2026-10-16

通过 CLI 管理运行时

本章介绍如何使用 ll-cli 管理已安装的运行时（关于运行时应先了解 Base、Runtime 和 App 的分层关系，参见基础概念介绍）。主要面向需要排查依赖、控制磁盘占用或手动控制运行环境的高级用户。

2026-10-16

快速上手

本章面向使用如意玲珑应用的终端用户。完成下面的步骤后，您将能够使用 ll-cli 搜索、安装和运行应用。

2026-10-16

如意玲珑发布日志

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

2026-10-16

概述

如意玲珑是统信软件自研的开源软件包格式，定义了新的应用程序管理范式，覆盖了应用程序从开发到分发，再到运行的全生命周期。

2026-10-16

常见运行问题

应用运行读取 /usr/share下应用安装资源文件，为什么读取失败？

2026-10-16

常见构建问题

cmake类型构建，出现-lxxx失败，但ldconfig与pkg-config均能查询到该库信息。

2026-10-16

常见问题

ll-pica 生成的 linglong.yaml 文件的默认配置在哪里？

1.5.0

Debug App

The following tutorial uses the linglong-builder-demo project mentioned in the "Building Tools" section as an example. We put the project in /path/to/project.

1.5.0

Run FAQ

When the application runs to read the application installation resource file under /usr/share, why does the reading fail?

1.5.0

Build FAQ

-lxxx failed in cmake type build, but ldconfig and pkg-config can query the library information.

1.5.0

Build App

Use ll-builder build to build a Linglong application.

1.5.0

convert `appimage` format( `.appimage` or `.AppImage` ) pkg to linglong format( `.layer` or `.uab` ) pkg

View the help information for the ll-builder convert command:

1.5.0

Create Linglong project

Use ll-builder create to create a Linglong project.

1.5.0

Initialize Linglong Projects

The source code is a cmake project, and choose the build type as cmake (see cmake.yaml for the template content).

1.5.0

Export Layer File

Use ll-builder export to check out the build content and generate layer file.

1.5.0

App to store

Create a Linglong project and use ll-builder to build a Linglong app locally.

1.5.0

ll-builder Introduction

ll-builder is a tool for developers for building Linglong applications.

1.5.0

Manifests

linglong.yaml is the description file of a Linglong project, which stores the relevant information required for building.

1.5.0

Push UAB to Remote Repositories

Use the ll-builder push command to push Linglong packages to Linglong remote repositories.

1.5.0

Run compiled App

Use ll-builder run to run the compiled executable program.

1.5.0

Attach To Container

Use ll-cli exec to enter the inside of the running Linglong container.

1.5.0

Install Linglong Apps

Use ll-cli install to install Linglong apps.

1.5.0

ll-cli Introduction

ll-cli is the command line tool of Linglong, used to install, uninstall, check, run, close, debug, and update Linglong applications.

1.5.0

Force Quit Running App

Use ll-cli kill to force quit running Linglong apps.

1.5.0

List Installed Apps

Use ll-cli list to view the installed Linglong apps.

1.5.0

View Running Apps

Use ll-cli ps to view running Linglong Apps.

1.5.0

Search Apps From Remote

Use ll-cli search to search app meta info from remote repository.

1.5.0

Run App

Use ll-cli run command to start a Linglong application.

1.5.0

Uninstall App

Use ll-cli uninstall to uninstall Linglong apps.

1.5.0

Update Linglong App

Use ll-cli update to update Linglong apps.

1.5.0

Install Linglong Environment

Use uname -r to check the kernel version:

1.5.0

Introduction

Linglong, an open source package format developed by UnionTech Software, is designed to manage, distribute, create a sandbox for packages, and integrate development tools…

1.5.0

调试玲珑应用

以下教程以“构建工具”一节中提到的 linglong-builder-demo 项目为例。我们将项目放在 /path/to/project。参考教程操作时注意对路径进行替换。

1.5.0

常见运行问题

应用运行读取/usr/share下应用安装资源文件，为什么读取失败？

1.5.0

常见构建问题

cmake类型构建，出现-lxxx失败，但ldconfig与pkg-config均能查询到该库信息。

1.5.0

构建应用

ll-builder build命令用来构建玲珑应用。

1.5.0

转换 `appimage` 包格式( `.appimage` 或 `.AppImage` ) 到玲珑包格式( `.layer` 或 `.uab` )

查看 ll-builder convert 命令的帮助信息：

1.5.0

创建项目

ll-builder create命令用来创建玲珑项目。

1.5.0

demo示例

源码为qmake工程，填写build 类型为qmake（模板内容见qmake.yaml）。

1.5.0

导出 layer 文件

ll-builder export命令用来检出构建内容, 生成 layer 文件。

1.5.0

上架应用到商店

创建一个玲珑工程，使用ll-builder在本地构建出玲珑应用。

1.5.0

ll-builder简介

ll-builder是为应用开发者提供的一款构建玲珑应用工具。

1.5.0

构建配置文件简介

linglong.yaml 是玲珑项目工程的描述文件，记录构建所需的相关信息。如构建产物的名称、版本、源码地址、构建依赖等。

1.5.0

推送uab到远程仓库

ll-builder push命令用来将玲珑软件包推送至玲珑远程仓库。

1.5.0

运行编译后的应用

ll-builder run命令可以运行编译后的可执行程序。

1.5.0

进入容器内部

ll-cli exec命令可以进入正在运行的容器内部。

1.5.0

安装应用

ll-cli install命令用来安装玲珑应用。

1.5.0

ll-cli简介

ll-cli是一个包管理器前端，用于管理玲珑应用的安装、卸载、查看、启动、关闭、调试、更新等操作。

1.5.0

强制退出应用

ll-cli kill命令可以强制退出正在运行的玲珑应用。

1.5.0

列出已安装的应用

ll-cli list命令可以查看已安装的玲珑应用。

1.5.0

查看运行中的应用

ll-cli ps命令可以查看正在运行的玲珑应用。

1.5.0

从远程仓库查询应用

ll-cli search命令可以查询玲珑远程仓库中的应用信息。

1.5.0

运行应用

ll-cli run命令可以启动一个玲珑应用。

1.5.0

卸载应用

ll-cli uninstall命令可以卸载玲珑应用。

1.5.0

更新应用

ll-cli update命令可以更新玲珑应用。

1.5.0

安装玲珑环境

使用 uname -r 查看内核版本。

1.5.0

简介

玲珑是统信软件自研的开源软件包格式，用于替代 deb、rpm等包管理工具，实现了应用包管理、分发、容器、集成开发工具等功能。

1.6.3

Debug App

The following tutorial uses the linglong-builder-demo project mentioned in the "Building Tools" section as an example. We put the project in /path/to/project.

1.6.3

Run FAQ

When the application runs to read the application installation resource file under /usr/share, why does the reading fail?

1.6.3

Build FAQ

-lxxx failed in cmake type build, but ldconfig and pkg-config can query the library information.

1.6.3

FAQ

Where is the default configuration located for the linglong.yaml file generated by ll-pica?

1.6.3

Build App

Use ll-builder build to build a Linglong application.

1.6.3

convert `appimage` format( `.appimage` or `.AppImage` ) pkg to linglong format( `.layer` or `.uab` ) pkg

View the help information for the ll-builder convert command:

1.6.3

Create Linglong project

Use ll-builder create to create a Linglong project.

1.6.3

Initialize Linglong Projects

The source code is a cmake project, and choose the build type as cmake (see cmake.yaml for the template content).

1.6.3

Export layer file or uab file

Use ll-builder export to check out the build content and generate layer file or uab file.

1.6.3

App to store

Create a Linglong project and use ll-builder to build a Linglong app locally.

1.6.3

ll-builder Introduction

ll-builder is a tool for developers for building Linglong applications.

1.6.3

Manifests

linglong.yaml is the description file of a Linglong project, which stores the relevant information required for building.

1.6.3

Push UAB to Remote Repositories

Use the ll-builder push command to push Linglong packages to Linglong remote repositories.

1.6.3

Run compiled App

Use ll-builder run to run the compiled executable program.

1.6.3

Attach To Container

Use ll-cli exec to enter the inside of the running Linglong container.

1.6.3

Install Linglong Apps

Use ll-cli install to install Linglong apps.

1.6.3

ll-cli Introduction

ll-cli is the command line tool of Linglong, used to install, uninstall, check, run, close, debug, and update Linglong applications.

1.6.3

Force Quit Running App

Use ll-cli kill to force quit running Linglong apps.

1.6.3

List Installed Apps

Use ll-cli list to view the installed Linglong apps.

1.6.3

View Running Apps

Use ll-cli ps to view running Linglong Apps.

1.6.3

Search Apps From Remote

Use ll-cli search to search app meta info from remote repository.

1.6.3

Run App

Use ll-cli run command to start a Linglong application.

1.6.3

Uninstall App

Use ll-cli uninstall to uninstall Linglong apps.

1.6.3

Update Linglong App

Use ll-cli upgrade to upgrade Linglong apps.

1.6.3

Add dependency

Linglong applications may lack package dependencies, which can currently be addressed by adding the corresponding package dependencies in the linglong.yaml file.

1.6.3

Conversion application

The ll-pica convert command is used to generate the linglong.yaml file required by Linglong.

1.6.3

Initialization configuration

The ll-pica init command is used to initialize the configuration information for the conversion package.

1.6.3

ll-pica Introduction

This tool currently provides the capability to convert DEB packages into Linglong packages.

1.6.3

Manifests · ll-pica

The package.yaml file serves as the foundation for ll-pica to convert packages into DEB format.

1.6.3

Build Linglong applications

Taking deepin-calculator as an example, introduce the process of building a Linglong package from source code.

1.6.3

Install linglong

Update the repository and install Linglong.

1.6.3

Summary

Linglong, an open source package format developed by UnionTech Software, is designed to manage, distribute, create a sandbox for packages, and integrate development tools…

1.6.3

调试玲珑应用

以下教程以“构建工具”一节中提到的 linglong-builder-demo 项目为例。我们将项目放在 /path/to/project。参考教程操作时注意对路径进行替换。

1.6.3

常见运行问题

应用运行读取 /usr/share下应用安装资源文件，为什么读取失败？

1.6.3

常见构建问题

cmake类型构建，出现-lxxx失败，但ldconfig与pkg-config均能查询到该库信息。

1.6.3

常见问题

ll-pica 生成的 linglong.yaml 文件的默认配置在哪里？

1.6.3

构建应用

ll-builder build命令用来构建玲珑应用。

1.6.3

转换 `appimage` 包格式( `.appimage` 或 `.AppImage` ) 到玲珑包格式( `.layer` 或 `.uab` )

查看 ll-builder convert 命令的帮助信息：

1.6.3

创建项目

ll-builder create命令用来创建玲珑项目。

1.6.3

demo示例

源码为qmake工程，填写build 类型为qmake（模板内容见qmake.yaml）。

1.6.3

导出 layer 文件或 uab 文件

ll-builder export命令用来检出构建内容, 生成 layer 或 uab 文件。

1.6.3

上架应用到商店

创建一个玲珑工程，使用ll-builder在本地构建出玲珑应用。

1.6.3

ll-builder简介

ll-builder是为应用开发者提供的一款构建玲珑应用工具。

1.6.3

构建配置文件简介

linglong.yaml 是玲珑项目工程的描述文件，记录构建所需的相关信息。如构建产物的名称、版本、源码地址、构建依赖等。

1.6.3

推送uab到远程仓库

ll-builder push命令用来将玲珑软件包推送至玲珑远程仓库。

1.6.3

运行编译后的应用

ll-builder run命令可以运行编译后的可执行程序。

1.6.3

进入容器内部

ll-cli exec命令可以进入正在运行的容器内部。

1.6.3

安装应用

ll-cli install命令用来安装玲珑应用。

1.6.3

ll-cli简介

ll-cli是一个包管理器前端，用于管理玲珑应用的安装、卸载、查看、启动、关闭、调试、更新等操作。

1.6.3

强制退出应用

ll-cli kill命令可以强制退出正在运行的玲珑应用。

1.6.3

列出已安装的应用

ll-cli list命令可以查看已安装的玲珑应用。

1.6.3

查看运行中的应用

ll-cli ps命令可以查看正在运行的玲珑应用。

1.6.3

从远程仓库查询应用

ll-cli search命令可以查询玲珑远程仓库中的应用信息。

1.6.3

运行应用

ll-cli run命令可以启动一个玲珑应用。

1.6.3

卸载应用

ll-cli uninstall命令可以卸载玲珑应用。

1.6.3

更新应用

ll-cli upgrade命令可以更新玲珑应用。

1.6.3

添加依赖

玲珑应用可能缺少包依赖，目前可以通过在 linglong.yaml 文件添加对应的包依赖。

1.6.3

转换应用

ll-pica convert 命令用来生成玲珑需要使用的 linglong.yaml 文件。

1.6.3

初始化配置

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

1.6.3

ll-pica 简介

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

1.6.3

转换配置文件简介 · ll-pica

package.yaml 是 ll-pica 转换 deb 包的基础信息。如构建的 base、runtime 的版本，需要被转换的 deb 包。

1.6.3

构建玲珑应用

以 deepin-calculator 为例，介绍从源码构建玲珑包的过程。

1.6.3

安装玲珑

本工具目前提供 deb 包转换为玲珑包的能力，生成构建玲珑应用需要的 linglong.yaml 文件，并依赖 ll-builder 来实现应用构建和导出。

1.6.3

概述

玲珑是统信软件自研的开源软件包格式，用于替代 deb、rpm等包管理工具，实现了应用包管理、分发、容器、集成开发工具等功能。

2026-01-27

重磅！XDG 正式支持如意玲珑(Linyaps)

在 Linux 桌面世界，有一套奠定一切互操作性基础的“通用语言”——由 freedesktop.org 组织制定并维护的 XDG 规范。

2026-01-22

当 BMF 遇见玲珑：一款支持 AI 的音视频转换工具这样落地

你是否曾为音视频转换工具安装复杂、依赖繁琐而头疼？是否期待一款既功能强大、又易于分发的一站式处理工具？

2025-12-05

线下活动 | 这周末COSCon’25：北京的小伙伴，来展位坐坐！

中国开源年会 COSCon 是业界最具影响力的开源盛会之一，由开源社在 2015 年首次发起，2016 年正式得以命名。九年来，中国开源年会以其独特的中立社区定位及日益增加的影响力，吸引了越来越多国内外企业、高校、开源组织和社区的大力支持。

2025-11-12

如意玲珑社区测试源上线，软硬件“追新”零等待！

“如意玲珑社区测试源”是由社区爱好者@mozixun、@罐子联合打造的第三方社区共享项目，本质是一个针对如意玲珑应用的补充仓库。

2025-09-29

[项目分享]Runtime顶级更新: Tauri和Flutter应用支持原生构建

在我不懈的努力下,玲珑内GTK4的运行环境支持做出来了: https://github.com/LFRon/org.deepin.runtime.gtk4

2025-09-29

打破发行版适配壁垒！这个如意玲珑社区 SIG 的成果有点行！

如果常使用 Linux，你大概率会被一个问题困扰：软件跨发行版适配太折腾。明明是同款常用工具，在 A 发行版里一键安装就能用，到了 B 发行版却要对着依赖报错反复调试，半天才能让软件正常跑起来，而使用了Flatpak和Snap又嫌体积占用太大打开速度太慢 —— 这几乎是所有 Linux 用户的共同痛点，也是Linux应用打包维护者的痛点。

2025-09-21

[玲珑适配教程]浅谈使用ll-pica工具快速转换flatpak思路及方法

什么是pica ？pica 怎么用？

2025-09-06

[玲珑适配教程]使用ll-pica工具快速转换flatpak应用并进行投递

在进行转换工作前，你需要以下网站和应用：

2025-09-03

[玲珑适配教程]详细介绍：实现将商店wine格式包打包成玲珑格式包

近期论坛开展2025年第1期「玲珑应用迁移与开发征募赛」，奖金丰厚，希望大家多多参与，别错过薅官方羊毛大好机会，因个人进段时间线下工作比较忙，不能很好参与活动，现在把自己略懂的一点知识跟大家分享。如有错误，请多多指教。

2025-08-25

[玲珑适配教程]详细介绍：实现利用统信兼容引擎打包转化成玲珑包

上一期地址：https://bbs.deepin.org/post/290919

2025-08-22

[玲珑适配教程]访问github-linglongdev项目以学习玲珑打包的技巧

与flathub的工程仓库类似，在github上也有集中存放如意玲珑包工程的项目：linglongdev，链接为https://github.com/orgs/linglongdev 。

2025-08-15

「如意玲珑应用迁移活动」全新启动！有奖征集玲珑应用

为进一步丰富如意玲珑应用生态，提升桌面应用兼容性与用户体验，现启动2025年第1期「玲珑应用迁移与开发征募赛」，面向开发者征集如意玲珑格式应用。本次活动通过批量转制、定向攻坚，覆盖不同类型应用的适配需求，诚邀广大开发者参与，共同推动玲珑生态建设。

2025-07-30

[经验分享] 如意玲珑qt5程序报错无法找到Qt platform plugin “dxcb” 的解决方案

apt download libxcb-damage0 libxcb-composite0 libqt5xdg3 libqt5xdgiconloader3 dde-qt5integration dde-qt5xcb-plugin

2025-07-22

在银河麒麟 V10SP1 上浅尝 “如意玲珑” 应用（开源 Linux 软件格式包），生态体验良好

最近把主力系统换成银河麒麟后， “找应用难、装应用更难” 成了日常痛点 —— 要么适配版本少，要么装的时候一堆依赖报错，折腾半天还未必能用。直到偶遇如意玲珑，才算把这些坎儿慢慢趟平了。分享下真实体验，给同样用银河麒麟的朋友避坑～

2025-07-15

如意玲珑 v1.9.5 来了！新增支持 Arch Linux、Wine 应用也能玲珑化了

如意玲珑是一款 Linux 跨发行版的独立包管理工具集，一直以简化 Linux 应用分发、提升跨平台兼容性为核心目标，给开发者和用户搭起高效的应用生态桥梁。在如意玲珑社区和开发者的深度参与下，我们在持续打磨优化，持续提升容器化技术的稳定性、优化开发者的工作流体验、拓展生态覆盖能力。

2025-06-16

[经验分享]跟着我，5分钟就可以在Cachy OS上使用玲珑软件

如意玲珑Linyaps（简称：玲珑）是一种新型的独立包管理工具集，致力于治理Linux系统下传统软件包格式复杂、交叉的依赖关系导致的各种兼容性问题，以及过于松散的权限管控导致的安全风险。（项目地址：https://github.com/OpenAtom-Linyaps）

2025-06-05

5月24日成都Meetup 回顾 | 从“小工具”到“大生态”，这场活动透露了哪些开源密码？

初夏的蓉城，技术与热情交织。 5 月 24 日，由 deepin（深度）社区与openEuler 社区联合主办，如意玲珑社区承办的 openEuler & deepin Meetup 活动在成都成功举办。

2025-05-22

报名开启 | deepin Meetup 成都站，与如意玲珑共探开源生态！

2025 年 5 月 24 日（周六），一场聚焦「开源生态共建」的技术聚会将在成都启幕，欢迎各位爱好者与我们一同聊聊对于开源、开发等一切问题的想法和探索。

2025-05-14

Linyaps v1.8.1 Release: Enhanced Build Capabilities & Step-by-Step Update Guide

The stable version of Linyaps v1.8.1 is now officially released to repositories.

2025-05-14

如意玲珑 v1.8.1 版本发布，构建能力进一步增强 | 内含更新教程

如意玲珑 v1.8.1 稳定版本已正式推仓发布，这次更新主要涉及构建工具链优化、多系统支持扩展和稳定性提升等方面。

2025-03-12

[如意玲珑应用构建指南]（二）：在玲珑容器中编译基于 Qt5 的开源应用

通过《如意玲珑应用构建指南（一）：规范体系与配置文件全解析》的学习后，相信大家已经对玲珑应用构建工程基础知识有了一定的了解。在接下来的系列推文中，我们将深入实操环节，带大家利用所学知识正式构建玲珑应用。

2025-03-12

[项目教程]玲珑杀手Go-layer子命令：高效构建玲珑应用，降低磁盘压力

在玲珑杀手Go最近更新的v1.4.x版本中，引入了全新的layer子命令，该命令独立于ll-builder之外实现了对玲珑layer文件的构建、打包、挂载/卸载和解析功能，无需生成~/.cache/linglong-builder构建缓存浪费存储空间，也不会产生大量无用的文件复制，大幅增强了玲珑应用的构建体验。

2025-03-07

[项目教程]玲珑杀手Go：全新玲珑应用本地构建系统，附Ubuntu源GIMP迁移示例

本项目是 Linglong Killer Self-Service (ll-killer 玲珑杀手) 的Go语言重构版本，将原本构建阶段的shell脚本重新用Go实现以更可靠地在本地离线运行，并添加了许多增强功能。

2025-03-06

WHLUG | 玲珑社区应用自测工具链产品解读&演示

2025 年 3 月 1 日下午，由 deepin（深度）社区与华中科技大学开放原子开源俱乐部携手举办的 WHLUG（武汉 Linux 用户组）线下沙龙在华中科技大学圆满落幕。

2025-02-28

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

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

2025-02-27

[生态教程]基本不需要依赖的Linux安装包如何快速转成玲珑包

在开始这个教程之前,首先我们要搞清楚玲珑容器内是如何工作的,这里我用一张图来解释

2025-02-26

[生态教程]如何手动打包玲珑应用(deb、appimage等)

此篇教程适用于将deb, appimage, 打包好的二进制包转为如意玲珑包的学习。

2025-01-18

[项目分享]玲珑杀手：玲珑应用自助打包系统分享

这几天研究了下如何突破玲珑限制，根除玲珑打包问题。相信任何一个尝试过打包玲珑应用的人都曾被玲珑容器的路径限制和依赖库问题弄得焦头烂额，相当令人抓狂。这些问题是玲珑生态的发展的巨大阻碍，为了解决这些困难，ll-killer就此诞生。

2025-01-15

如意玲珑（Linyaps）社区 2024 年度盘点

2024年，如意玲珑社区在社区发展及软件生态建设领域迈出了坚实的步伐。作为开放原子开源基金会的孵化项目，在这一年里稳步推进各项工作，在多个关键层面取得了切实的成果。以下是对本年度社区工作的回顾总结。

2024-12-17

(5)Advanced Compatibility Testing for Linyaps Applications – Linyaps Automated Testing Toolchains

As observed in previous chapters, we have manually installed Linyaps packages and launched applications to verify compatibility.

2024-12-17

(4)Adapting Qt5-based Open-Source Application qBittorrent into an Automated Linyaps Packaging Project

Building on the previous chapter, we now explore how to adapt linglong.yaml for automated builds.

2024-12-17

(3)Adapting Qt5-based Open-Source Application qBittorrent into an Automated Linyaps Packaging Project

Following the previous chapter “Compiling Qt5-based Open-Source Application qBittorrent in Linyaps Container”, we now complete the final steps of Linyaps Packaging Basics…

2024-12-17

(2)Compiling Qt5-based Open-Source Application qBittorrent in Linyaps Container

After studying the previous chapter “Basic Knowledge of Linyaps Application Packaging”, we will now apply this knowledge to package a real-world application.

2024-12-17

(1)Basic Knowledge of Linyaps Application Packaging

Before formally starting a Linyaps application packaging project, it is essential to understand the foundational concepts of Linyaps application packaging.

2024-12-09

[玲珑本体] 玲珑1.7.2 Ubuntu系正式发布

本文转自社区论坛 by mozixun | 原文链接

2024-11-28

[经验分享]在玲珑容器里编译的程序可以打包成deb包来运行

为了补偿部分朋友无法见证如意玲珑与 OpenTenBase 开源社区“跨界”分享的现场演示, 我这里简单将操作过程向各位展示一遍

2024-11-22

[生态教程]OpenTenBase 基于玲珑容器编译并在业务环境安装

有听过如意玲珑——新时代Linux桌面应用分发和治理方案的朋友应该知道如意玲珑方案众多核心特性之一就是: “通过隔离技术，彻底解决系统与应用、应用与应用之间因升级引起的兼容性冲突问题。”

2024-11-20

[解决方案]打包浏览器Thorium遇到的一些问题以及解决方案

既然Ubuntu默认内置了snap的firefox(但是打开真的慢),deepin内置了玲珑版deepin浏览器,于是我也来掺和一下打包地表最快的Chromium浏览器

2024-11-18

11月16日如意玲珑走进天津中德大学，首场高校技术沙龙圆满结束！

11月16日下午，如意玲珑社区在开放原子校源行公益项目、deepin社区和OpenTenBase社区的支持下，成功走进天津中德应用技术大学，举办了一场围绕开源通识、技术、社区的互动式实践教学Meetup。

2024-11-06

[生态教程]如何仅用几行代码将微信4.0公测版转换成玲珑格式？

前几天微信Linux推出了全新4.x版本,坊间传闻这次重大版本更新,在跨发行版体验上有了质的飞跃[Doge]. 在我安装试用前，早在坊间有传闻说主要特性有这几项:

2024-10-24

自行编译的Ubuntu 24.10如意玲珑本体及ll-pica

deepin刚刚发布了拿捏Flatpak的转制工具,然而并没有把最新玲珑推给Ubuntu,于是我来推一下

2024-10-24

技术动态 | 如意玲珑1.6.3新版本已发布，支持Flatpak转制

有人曾问小编道：如意玲珑主要是希望解决什么问题？

2024-10-21

用户分享 | 探索国产系统之如意玲珑

在使用 Deepin/UOS 系统时，我注意到应用商店新增了一个“玲珑应用”的类别。经过一番了解，发现这是一种最新研发的国产软件包格式——如意玲珑。那么，什么是如意玲珑？为什么要开发这样一种全新的软件包格式？这篇文章就带大家深入探索如意玲珑的世界。

2024-10-11

如意玲珑应用商店正式上线！

今天，如意玲珑社区迎来了一个新的里程碑——如意玲珑应用商店正式上线！

2024-09-30

[如意玲珑生态指南] 应用构建教程(7) Ubuntu 24.04 + Qt apps

在完成前面运行演示之后,我们即将开始展示 Qt based 应用玲珑化编译构建的效果，这里的完整解释是以Qt5运行库为核心运行库的应用及其源码。我们这里选取 LibreCAD. 对于一般图形化应用而言，一套良好的体验应当还包括desktop文件以及图标文件，这样以保证普通用户可以通过启动器启动应用。

2024-09-30

[如意玲珑生态指南] 应用构建教程(6) openKylin 2.0 + Electron

在完成前面tar归档格式应用玲珑化转制演示之后,我们即将开始展示Electron应用玲珑化转制的效果。我们这里选取一款 Electron based的应用思源笔记,为了保障高度的规范化和为以后可能的自动化预留发展空间,我这边后面演示的项目均具备规范性特征，包括但不限于:目录规范性、构建流程规范性等。

2024-09-30

[如意玲珑生态指南] 应用构建教程(5) openKylin 2.0 + tar

在完成前面运行演示之后,我们即将开始展示tar归档格式应用玲珑化转制的效果，这里的完整解释是使用tar归档格式压缩、封装的Linux应用二进制文件。我们这里选取一款 Java based的应用几何画板5,为了保障高度的规范化和为以后可能的自动化预留发展空间,我这边后面演示的项目均具备规范性特征，包括但不限于:目录规范性、构建流程规范性等。

2024-09-18

如意玲珑（Linyaps）社区运营报告（2024年8月）

1）新增支持CPU架构——龙芯loong64，如意玲珑主程序已支持 x86_64、arm64、loongarch64和loong64

2024-09-14

[如意玲珑生态指南] 运行及安装(4) Ubuntu 24.04

在安装玲珑环境之前,你的系统环境应该满足以下要求:

2024-09-13

[如意玲珑生态指南] 运行及安装(3) openKylin 2.0

在安装玲珑环境之前,你的系统环境应该满足以下要求:

2024-09-11

[生态教程]基于Python的Appimage转玲珑包GUI程序

1. 选择appimage文件，点击open

2024-09-06

[解决方案]关于近期安装玲珑应用后系统XDG相关组件性能下降的解决方案

内容来自：社区论坛 by Ziggy 原文链接

2024-09-05

[生态教程]如何将Python程序转换为玲珑包

激活虚拟环境后，会把screenpen-venv/bin目录加入PATH环境变量

2024-09-02

[如意玲珑生态指南] 运行及安装(2) openEuler 24.03 LTS

在安装玲珑环境之前,你的系统环境应该满足以下要求:

2024-09-02

[如意玲珑生态指南] 运行及安装(1) #deepin 23

由于deepin 23正式版已默认预装玲珑环境,因此不需要像第三方发行版一般自行安装玲珑所需的软件包。但鉴于玲珑主程序目前采用滚动更新的模式以及玲珑主程序定期随内测更新而进行迭代，此处建议加入deepin 23内测通道并保持系统为最新状态，即可体验玲珑方案的最新特性以及得到及时的问题修复。尽管如此，你还是需要确保系统满足以下要求:

2024-09-02

[如意玲珑生态指南] 应用构建教程(4) openEuler 24.03 LTS + Java

在完成前面Appimage应用转制之后,我们即将开始展示Java应用玲珑化转制的效果。我们这里选取一款Java based的应用”几何画板5″,为了保障高度的规范化和为以后可能的自动化预留发展空间,我这边后面演示的项目均具备规范性特征，包括但不限于:目录规范性、构建流程规范性等。

2024-09-02

[如意玲珑生态指南] 应用构建教程(3) openEuler 24.03 LTS + Appimage

在完成前面的运行演示之后，我们现在来看看在openEuler 24.03 LTS上构建玲珑应用的效果。对于本次课程规划来说,咱们接下来主要是演示应用appimage以及java应用的玲珑化转制

2024-09-02

[如意玲珑生态指南] 应用构建教程(2) #C++兼容性

在本章节开始前,简单介绍下目前玲珑生态提供的runtime状态.目前提供了20、23版本的Runtime以及Foundation用于构建及运行程序,部分场景下需要维护者根据实际情况或报错信息选择合适的Runtime以及Foundation.在选择适合当前项目的Runtime以及Foundation前,你需要特别关注不同版本之间的重要差异…

2024-09-02

[如意玲珑生态指南] 应用构建教程(1) #ll-pica & adep

ll-pica为玲珑应用构建工具体系中的一款辅助工具，目前提供 deb 包转换为玲珑包的能力，生成构建玲珑应用需要的 linglong.yaml 文件，并依赖 ll-builder 来实现应用构建和导出。

2024-08-23

如意玲珑正式集成至deepin 23，生态适配超千款

8月15日，开源社区deepin在线上举办了主题为“聚AI而生大有不同”新品发布会，正式对外发布开源操作系统deepin 23，带来了全新DDE视界、 AI For OS、“如意玲珑”应用生态、全球首款信创IDE“deepin-IDE”等诸多重磅更新。

2024-08-12

[详细介绍]玲珑是什么?它从哪里来,又要到哪里去?

本文会比较详细地描述玲珑是什么,它诞生的背景和它要解决的问题

2024-08-12

如意玲珑（Linyaps）社区运营报告（第一期）

开放原子如意玲珑（OpenAtom Linyaps）是一种新型的独立包管理工具集，专注于解决Linux系统下由传统软件包格式的复杂性和交叉依赖关系引起的兼容性问题。

2024-07-31

技术动态 | 玲珑 1.5.8-1 新版本已发布

玲珑新版本 1.5.8-1 已经发布，一起来看看都有什么新变动。

2024-07-16

如意玲珑(Linyaps)官宣！品牌升级&项目最新进展同步

7月13日，在上海站的deepin meetup如意玲珑专场上，我们正式宣布了项目全新的品牌名称——如意玲珑（Linyaps）（以下简称“玲珑”），同时，我们也分享了项目已于2024年5月24日与开放原子开源基金会完成捐赠协议签署的消息，目前如意玲珑已成为基金会的正式孵化期项目。

2024-07-10

玲珑大爆料！deepin Meetup（上海站）议程抢先看！

本文于 2024 年 7 月 10 日发布，介绍 2024 年 7 月 13 日上海 Meetup；原报名方式不代表当前报名。

2024-07-10

“玲珑”应用迁移赛精彩回顾：开启开源生态新篇章！

玲珑是由统信软件于2024年5月正式捐赠给开放原子开源基金会孵化及运营的开源项目，是一种新型的独立包管理工具集，旨在解决Linux系统下由传统软件包格式的复杂性和交叉依赖关系引起的兼容性问题，以及由于权限管控过于松散而带来的安全风险。

2024-07-01

【入门教程】玲珑10分钟快速构建指南！

玲珑作为一种新型的独立包管理工具集，玲珑主要提供分层与隔离的运行环境，解决传统包管理系统强依赖导致的兼容性问题，以及权限松散导致的安全问题。当前，玲珑已支持 4 个发行版，包括 deepin、统信 UOS 以及 Debian 和 Ubuntu。

2024-07-01

【解决方案】玲珑打包报 java: not found 解决方法

本文转载自 deepin论坛-玲珑专区-原文链接作者：deepin-superuser

2024-07-01

【解决方案】玲珑打包报 start.sh:行2: ./xxx: No such file or directory 解决方案

本文转载自 deepin论坛-玲珑专区-原文链接作者：deepin-superuser

2024-07-01

【解决方案】玲珑打包报 xxx.so: version `GLIBC_2.38′ not found 解决方案

本文转载自 deepin论坛-玲珑专区-原文链接作者：root

2024-07-01

【解决方案】玲珑包-python解释器错误的解决办法

本文转载自 deepin论坛-玲珑专区-原文链接作者：HelloWorld!

2024-06-27

【入门教程】从源代码开始构建玲珑格式应用

本文以构建 desktop-entry-editor 为例，该项目依赖较为简单，仅需玲珑官方文档中默认提供的基础运行环境即可成功构建运行。

2024-06-12

加入UOS开发者网站，探索编程世界的无限可能

在这个日新月异的技术时代，你是否想跟上时代的步伐，率先成为自主生态建设的佼佼者？现在，机会就在你的眼前。我们诚邀您登录UOS开发者网站，加入UOS大家庭，获取开发者授权权益，一起探索编程的无尽魅力。（获取更多内容，欢迎扫描文末二维码，加入社群，与志同道合者交流、分享）

2024-05-22

玲珑生态共建 | 2024年第1期 “玲珑”应用迁移与开发征募赛

活动日期为 2024 年 5 月 23 日至 6 月 30 日，以下条件不代表 2026 年正在招募。

2023-12-25

玲珑赛罢，中国操作系统应用生态迈入新阶段

近期，开放原子开源大赛在江苏无锡圆满落幕。作为焦点赛道，由统信软件联合开放原子基金会大赛举办的玲珑赛道吸引超过全球100支参赛队伍参与，展现了开源社区的活力和热情。

2023-08-30

征集令！2023开源和信息消费大赛“玲珑赛道”邀你来战

8月29日，2023开源和信息消费大赛新闻发布会在北京召开。本次大赛聚焦开源和信息消费发展趋势和应用需求，旨在以赛促学、以赛促用，进一步发掘消费潜力，激发市场活力，改善消费环境，擦亮示范招牌，普及开源文化，培育选拔优秀开源人才，赋能行业和经济高质量发展。

2023-08-29

何为“玲珑”，它从哪里来又要到哪里去？

Linux 操作系统一直以其开源性质和灵活性而闻名，而要使 Linux 系统能够顺利安装并运行所需的软件，最关键的部分就是软件包管理器。

2023-06-15

统信软件王耀华：创新没有一帆风顺，只有开源才能让基础软件走向世界

今天，在第十八届开源中国开源世界高峰论坛上，统信软件终端操作系统产线总经理、深度社区（deepin）负责人王耀华发表了题为“打造深度开源社区，共建中国开发者生态”的主题演讲。

2023-06-11

统信软件正式向开放原子开源基金会捐赠「玲珑」！

在2023开放原子全球开源峰会上

2022-10-04

深入探索deepin自研包格式——“玲珑”

玲珑——统信软件自研的开源软件包格式，用于与dpkg、rpm等包管理工具共同实现应用包管理、分发、沙箱、集成开发等功能。

2026-02-13

linyaps-appstore

Suitable for: Users who don't know how to install Linyaps environment, don't want to manually install Linyaps environment, using UOS 1070, or have older systems (below…

2026-02-06

玲珑商店社区版安装说明

适用发行版：glibc 2.28+ 的发行版（Debian 10+、Ubuntu 18.04+、Fedora 等）

2025-04-11

Get Involved

Follow standard GitHub workflow: Fork → Develop → Pull Request

2025-04-07

contact us

Email：tongxinruanjianlinglong@uniontech.cn

2025-04-07

Linyaps Simple Store SIG

Welcome to the Linyaps Simple Store SIG! We focus on developing and operating the Linyaps Store, including:

2025-04-07

Linyaps Generic-Linux SIG

Welcome to the Linyaps Generic-Linux SIG! This group is dedicated to enabling Linyaps to run smoothly on distributions beyond deepin and desktop environments beyond DDE…

2025-04-07

Linyaps Packaging SIG

Welcome to the Linyaps Packaging SIG, a special interest group dedicated to enriching the Linyaps application ecosystem.

2025-04-07

linglong SIG

This SIG focuses on discussions related to the “Linyaps” containerized package management tool.

2025-04-03

Community Charter

The Linyaps Community (“the Community”) is an open-source community established by enterprises, institutions, social organizations, and individual developers based on…

2025-04-03

SIG Participation Guide

A SIG is a group focused on a specific interest area, contributing its outputs back to the broader community.

2024-11-19

如意玲珑跨发行版移植开发

欢迎来到Linyaps Generic-Linux SIG,本小组致力于让玲珑能在deepin以外的发行版以及DDE以外的桌面环境上正常运行玲珑以及其应用,促进Linux玲珑应用生态的发展

2024-10-31

生态贡献者

按原始月份查看玲珑生态贡献记录、贡献者名称与软件上架和更新数量。

2024-10-16

玲珑生态共建小组

欢迎来到Linyaps Packaging SIG，一个专注于丰富玲珑应用生态的特别兴趣小组。我们致力于进行玲珑格式包应用的构建，并持续优化软件的构建及分发流程，促进Linux生态的发展。

2024-09-20

玲珑生态贡献指南

加入 linyaps-packaging SIG 参与玲珑应用贡献，成为玲珑社区核心贡献者

2024-08-29

课程中心

浏览玲珑安装、应用构建、格式转换和调试课程，按主题打开原始视频与配套文章。

2024-06-20

贡献指引

参与玲珑产品的开发为技术发展做贡献

2024-06-04

关于玲珑

目前项目已正式捐赠给开放原子开源基金会（OpenAtom Foundation），处于项目孵化期

2024-06-04

如意玲珑SIG参与指南

SIG 即 Special Interest Group，特殊兴趣小组。每个 SIG 围绕其对应的一个兴趣目标进行活动的开展，并将其活动成果回馈给整个社区。

2024-06-04

联系我们 Contact Us

联系我们 / Contact Us

2024-06-04

社区章程

工作委员会：制定及修改玲珑项目群开源治理制度、决定项目运营计划、制定项目发展方向、审定项目收支预算及决算等工作。

2024-06-04

如意玲珑应用商店SIG

欢迎来到简易玲珑商店(Linyaps Simple Store SIG)小组。

2024-06-04

如意玲珑主程序开发SIG

本 SIG 主要进行“玲珑”容器化包管理工具相关的讨论。

2026-10-17

Choose the right Linglong Store installer

Match the CPU, Linux package system and release channel before downloading the desktop store.

2026-10-17

选对玲珑商店安装包

先确认处理器、发行版与发布通道，再下载桌面商店。

2026-10-17

From a web-store click to a Linux application

Understand the boundary between a browser, a desktop handler, ll-cli and the application window.

2026-10-17

从网页商店点击到 Linux 应用启动

分清浏览器、桌面处理程序、ll-cli 与应用窗口之间的边界。

2026-10-17

Diagnose an empty store or a failed installation

Separate catalog availability, repository inspection, installation and launch before choosing a repair.

2026-10-17

诊断商店空白与安装失败

先分清目录请求、仓库检查、安装和启动，再选择修复方式。

2026-10-17

Verify a store download with the release checksum

Match a versioned filename, a published SHA256 and your local file without confusing integrity with compatibility.

2026-10-17

用发布校验值核对商店下载文件

把版本、准确文件名、发布方 SHA256 与本地文件对应起来，区分完整性和兼容性。

2024-05-22

2024 Linyaps application migration and development challenge

Rules, dates, submission procedure and incentive conditions from the May–June 2024 call.

2024-07-10

Shanghai deepin Meetup, 13 July 2024: Linyaps agenda

The two announced talks, project timeline and community participation at the July 2024 Shanghai event.

2026

Linux 应用，清晰展开。

寻找应用、理解分层，或构建第一个软件包。从具体任务进入如意玲珑 Linyaps 生态。

2026-10-17

第一次使用玲珑：从版本检查开始

每次只改变一个条件，给安装、运行和桌面集成分别留下可验证的结果。

2026-10-17

按任务选择 Linux 应用格式

比较 Linyaps、Flatpak、Snap 与 AppImage 时，先列出真实需求，再检查权限、运行时和更新路径。

2026-10-17

把故障变成可复现的问题

区分安装、构建与运行故障，先整理最小证据，再修改系统。

2026-10-17

让命令与版本保持一致

用一份迁移工作表，比较 Linglong 不同文档世代的工作流程。

2026

命令规划器

使用经过格式校验的应用 ID，预览 ll-cli 工作流程。网站不执行任何命令。

2026

来源、版本与许可

了解文档、社区记录和新增图示的来源。

2026

隐私与本地工具

了解网站交付、搜索、剪贴板与命令规划器如何处理数据。

2026

浏览完整文档

1.14.x 文档

2026

版本参考

1.5.0 / 1.6.3

2026

实践指南

寻找应用、理解分层，或构建第一个软件包。从具体任务进入如意玲珑 Linyaps 生态。

2026

来自社区

项目动态、应用适配经验与社区记录。发布日期保留原文时间。

2026

搜索玲珑资料

试试 ll-cli run、Qt、runtime、安装或应用 ID。

2026

Linux apps. Unpacked.

Find an application, understand its layers, or build your first package. A practical way into the Linglong / Linyaps ecosystem.

2026-10-17

Your first Linyaps session

Start with a version check. Make one change at a time, and keep a way to verify the result.

2026-10-17

Choose a package format by the job

A practical comparison of Linyaps, Flatpak, Snap and AppImage — with the questions that matter before adoption.

2026-10-17

A useful bug report, without the guesswork

Separate installation, build and launch failures. Collect a small reproducible example before changing the machine.

2026-10-17

Use the right reference for your version

A migration worksheet for moving between Linglong documentation generations.

2026

Command planner

Preview a documented ll-cli workflow using a validated application ID. No commands run on this website.

2026

Sources, versions and attribution

Where the documentation, community records and new diagrams come from.

2026

Privacy and local tools

How website delivery, search, clipboard and the command planner handle data.

2026

Explore documentation

1.14.x documentation

2026

Version reference

1.5.0 / 1.6.3

2026

Practical field guides

Find an application, understand its layers, or build your first package. A practical way into the Linglong / Linyaps ecosystem.

2026

From the community

Project announcements, practical packaging notes and community records. Publication dates belong to the original material.

2026

Search the field guide

Try ll-cli run, Qt, runtime, install or a package ID.

2026

Sitemap

Find an application, understand its layers, or build your first package. A practical way into the Linglong / Linyaps ecosystem.