网站地图 — Linglong

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. Building with GitHub Actions linglong-builder-action is

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, sou

2026-10-16

Module Splitting

When building with Linyaps, an application can be split into multiple modules, each containing part of the build artifacts. For example, debug symbols go to the develop m

2026-10-16

Linyaps Multi-Architecture Build Guide

Supported Architectures The current Linyaps packaging tool supports the following CPU architectures: x86_64 arm64 (aarch64) loong64 loongarch64 (Loongson old world) sw64

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. For your own applicat

2026-10-16

Linyaps Documentation Index

This document lists the documents currently included in the navigation outline of the English guide directory. Documents are grouped by audience into Getting Started, Use

2026-10-16

Additional Documentation Topics

This directory contains additional documentation and advanced topics for Linyaps development. Available Documents Bundle Format: Detailed information about the Linyaps bu

2026-10-16

Application Runtime Configuration

Application runtime configuration is the file that describes how the Linyaps runtime module loads the application. The configuration is machine-specific, and the user can

2026-10-16

Bundle Format

Introduction Green software refers to binaries that do not install any files to the system. The fundamental constraints of green software are: Path independence: Has noth

2026-10-16

Reference (Ref)

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

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. Therefore, we put the information for constructing r

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 int

2026-10-16

System Helper

Users without privileges can mount erofs filesystems to directories using the following D-Bus call: busctl --system call org.deepin.linglong.SystemHelper \ /org/deepin/li

2026-10-16

uab Build

Creating a runnable uab file from a Linyaps-oriented project requires the following configuration files: linglong.yaml: The Linyaps project configuration file that determ

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. Since certain t

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. Since we have already determined the build rules

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 h

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 Qt

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 rai

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. When mirror functionality is enabled fo

2026-10-16

Repositories

A repository is a remote service used by Linyaps to store and distribute applications and runtime environments. Clients query package metadata from repositories and pull

2026-10-16

UAB Application Publishing

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

2026-10-16

Basic Concepts

This chapter explains how Linyaps works from four perspectives: package kinds, runtime environments, storage and containers, and system architecture. You do not need to m

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 con

2026-10-16

ll-appimage-convert-convert

NAME ll-appimage-convert-convert - Convert AppImage packages to Linyaps package format SYNOPSIS ll-appimage-convert convert [flags] DESCRIPTION The ll-appimage-convert co

2026-10-16

ll-appimage-convert

NAME ll-appimage-convert - Convert AppImage packages to Linyaps package format SYNOPSIS ll-appimage-convert subcommand DESCRIPTION The ll-appimage-convert command is used

2026-10-16

ll-builder-build

NAME ll-builder-build - Build Linyaps project SYNOPSIS ll-builder build [options] [command...] DESCRIPTION The ll-builder build command is used to build Linyaps applicati

2026-10-16

- kind: git

NAME ll-builder-create - Create Linyaps build template SYNOPSIS ll-builder create [options] name DESCRIPTION The ll-builder create command creates a corresponding folder

2026-10-16

Basic export

NAME ll-builder-export - Export Linyaps layer or UAB file SYNOPSIS ll-builder export [options] DESCRIPTION ll-builder export exports packages from the local build cache.

2026-10-16

ll-builder-extract

NAME ll-builder-extract - Extract Linyaps layer file to directory SYNOPSIS ll-builder extract [options] file directory DESCRIPTION The ll-builder extract command is used

2026-10-16

ll-builder-import

NAME ll-builder-import - Import Linyaps layer file to build repository SYNOPSIS ll-builder import [options] file DESCRIPTION The ll-builder import command is used to impo

2026-10-16

ll-builder-list

NAME ll-builder-list - List built applications SYNOPSIS ll-builder list [options] DESCRIPTION The ll-builder list command is used to list built applications. OPTIONS -h,

2026-10-16

ll-builder

NAME ll-builder - Linyaps application build tool SYNOPSIS ll-builder [options] subcommand DESCRIPTION ll-builder is a tool provided for application developers to build Li

2026-10-16

ll-builder-push

NAME ll-builder-push - Push Linyaps applications to remote repository SYNOPSIS ll-builder push [options] DESCRIPTION The ll-builder push command is used to push Linyaps p

2026-10-16

ll-builder-remove

NAME ll-builder-remove - Remove built applications SYNOPSIS ll-builder remove [options] ref... DESCRIPTION The ll-builder remove command removes one or more build results

2026-10-16

ll-builder-repo

NAME ll-builder-repo - Display and manage repositories SYNOPSIS ll-builder repo [options] subcommand DESCRIPTION The ll-builder repo command is used to display and manage

2026-10-16

ll-builder-run

NAME ll-builder-run - Run the built application SYNOPSIS ll-builder run [options] [command...] DESCRIPTION The ll-builder run command reads the runtime environment inform

2026-10-16

ll-cli-analyze

NAME ll-cli-analyze - Analyze installed applications SYNOPSIS ll-cli analyze subcommand [options] DESCRIPTION ll-cli analyze analyzes the disk usage of installed modules

2026-10-16

ll-cli-content

NAME ll-cli-content - Display application exported files SYNOPSIS ll-cli content [options] app DESCRIPTION Use ll-cli content to display application exported files. This

2026-10-16

ll-cli-enter

NAME ll-cli-enter - Execute commands in the currently running sandbox SYNOPSIS ll-cli enter [options] instance command... DESCRIPTION The ll-cli enter command can enter t

2026-10-16

ll-cli-info

NAME ll-cli-info - Display information about installed applications or runtimes SYNOPSIS ll-cli info [options] app DESCRIPTION Use ll-cli info to display information abou

2026-10-16

ll-cli-install

NAME ll-cli-install - Install applications or runtimes SYNOPSIS ll-cli install [options] app DESCRIPTION The ll-cli install command is used to install Linyaps application

2026-10-16

ll-cli-kill

NAME ll-cli-kill - Stop running applications SYNOPSIS ll-cli kill [options] app DESCRIPTION The ll-cli kill command can forcefully exit running Linyaps applications. This

2026-10-16

ll-cli-list

NAME ll-cli-list - List installed applications or runtimes SYNOPSIS ll-cli list [options] DESCRIPTION The ll-cli list command can view installed Linyaps applications. Thi

2026-10-16

ll-cli

NAME ll-cli - Linyaps command-line tool for managing applications and runtimes SYNOPSIS ll-cli [global-options] subcommand [subcommand-options] DESCRIPTION ll-cli is a pa

2026-10-16

ll-cli-prune

NAME ll-cli-prune - Remove unused minimal system or runtime SYNOPSIS ll-cli prune [options] DESCRIPTION Use ll-cli prune to remove unused minimal systems or runtimes. Thi

2026-10-16

ll-cli-ps

NAME ll-cli-ps - List running applications SYNOPSIS ll-cli ps [options] DESCRIPTION The ll-cli ps command can view running Linyaps applications. This command displays all

2026-10-16

ll-cli-repo

NAME ll-cli-repo - Display or modify current repository information SYNOPSIS ll-cli repo subcommand [options] DESCRIPTION The ll-cli repo command is used to manage remote

2026-10-16

ll-cli-run

NAME ll-cli-run - Run applications SYNOPSIS ll-cli run [options] app [command...] DESCRIPTION The ll-cli run command can start a Linyaps application. This command support

2026-10-16

ll-cli-search

NAME ll-cli-search - Search for applications/runtimes containing specified keywords from remote repositories SYNOPSIS ll-cli search [options] keywords DESCRIPTION The ll-

2026-10-16

ll-cli-uninstall

NAME ll-cli-uninstall - Uninstall applications or runtimes SYNOPSIS ll-cli uninstall [options] app DESCRIPTION The ll-cli uninstall command removes installed Linyaps appl

2026-10-16

ll-cli-upgrade

NAME ll-cli-upgrade - Upgrade applications or runtimes SYNOPSIS ll-cli upgrade [options] [app] DESCRIPTION The ll-cli upgrade command can update Linyaps applications. Thi

2026-10-16

ll-pica-adep

NAME ll-pica-adep - Add package dependencies to linglong.yaml file SYNOPSIS ll-pica adep [flags] DESCRIPTION The ll-pica adep command is used to add package dependencies

2026-10-16

ll-pica-convert

NAME ll-pica-convert - Convert deb packages to Linyaps packages SYNOPSIS ll-pica convert [flags] DESCRIPTION The ll-pica convert command is used to generate the linglong.

2026-10-16

ll-pica-init

NAME ll-pica-init - Initialize conversion package configuration information SYNOPSIS ll-pica init [flags] DESCRIPTION The ll-pica init command is used to initialize conve

2026-10-16

Conversion Configuration File Introduction

package.yaml is the basic information file for ll-pica to convert deb packages. It contains information such as the base and runtime versions to be built, and the deb pac

2026-10-16

ll-pica

NAME ll-pica - Tool for converting deb packages to Linyaps packages SYNOPSIS ll-pica subcommand DESCRIPTION The ll-pica command provides the ability to convert deb packag

2026-10-16

ll-pica-flatpak-convert

NAME ll-pica-flatpak-convert - Convert Flatpak applications to Linyaps applications SYNOPSIS ll-pica-flatpak convert [flags] DESCRIPTION The ll-pica-flatpak convert comma

2026-10-16

ll-pica-flatpak

NAME ll-pica-flatpak - Convert Flatpak applications to Linyaps applications SYNOPSIS ll-pica-flatpak subcommand DESCRIPTION The ll-pica-flatpak command is used to convert

2026-10-16

Linyaps Graphics Driver Guide

The Linyaps runtime environment is isolated from the host system environment. When running Linyaps applications that require graphics hardware acceleration, two condition

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. They form a layered dependency

2026-10-16

Build Your First Linyaps Application

This developer introduction uses deepin-calculator to complete configuration, building, debugging, runtime validation, and distribution. If you have not installed or run

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. The installer below will u

2026-10-16

ll-builder Workflow

ll-builder is the Linyaps application build tool. It reads linglong.yaml from a project, prepares application dependencies and source code, runs the build in an isolated

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: Manag

2026-10-16

Manage Runtimes with the CLI

This chapter explains how to manage installed runtimes with ll-cli. Before continuing, read Basic Concepts to understand the layered relationship among Base, Runtime, and

2026-10-16

Quick Start

This chapter is intended for end users of Linyaps applications. After completing the steps below, you will be able to use ll-cli to search for, install, and run applicati

2026-10-16

Linyaps Release Notes

Version 1.14 🚀 New Features Debug Mode: ll-cli run now supports --debug mode, which launches the application under gdbserver, with --debug-listen, --debug-debuginfod, and

2026-10-16

Overview

Linyaps is an open source package format developed by UnionTech Software. It defines a new application-management paradigm that covers the entire lifecycle from developme

2026-10-16

Common Runtime Issues

Why does the application fail to read resource files under /usr/share during runtime? Linyaps applications run in a container environment where application data is mounte

2026-10-16

Common Build Issues

For cmake type builds, -lxxx fails but both ldconfig and pkg-config can query the library information. The link library path is not in the conventional path, the new path

2026-10-16

Common Issues

Where is the default configuration for the linglong.yaml file generated by ll-pica? The ll-pica configuration file is located at ~/.pica/config.json. Can ll-pica convert

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

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. Make sure t

1.5.0

Run FAQ

When the application runs to read the application installation resource file under /usr/share, why does the reading fail? Linglong applications run in a container, and th

1.5.0

Build FAQ

-lxxx failed in cmake type build, but ldconfig and pkg-config can query the library information. The link library path is not a regular path, the new path is /runtime/lib

1.5.0

Build App

Use ll-builder build to build a Linglong application. View the help information for the ll-builder build command: ll-builder build --help Here is the output: Usage: ll-bu

1.5.0

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

Use ll-builder convert to convert appimage format( .appimage or .AppImage ) pkg to linglong format( .layer or .uab ) pkg. View the help information for the ll-builder con

1.5.0

Create Linglong project

Use ll-builder create to create a Linglong project. View the help information for the ll-builder create command: ll-builder create --help Here is the output: Usage: ll-bu

1.5.0

Initialize Linglong Projects

Initialize Linglong Projects ll-builder create org.deepin.calculator Edit linglong.yaml Fill in the meta information of packages package: id: org.deepin.calculator name:

1.5.0

Export Layer File

Use ll-builder export to check out the build content and generate layer file. View the help information for the ll-builder export command: ll-builder export --help Here i

1.5.0

App to store

Main process Create a Linglong project and use ll-builder to build a Linglong app locally. Submit a pull request to the https://github.com/linuxdeepin/linglong-hub reposi

1.5.0

ll-builder Introduction

ll-builder is a tool for developers for building Linglong applications. The main functions are as follows: Supports building in a standalone sandbox. Provides a list of s

1.5.0

Manifests

linglong.yaml is the description file of a Linglong project, which stores the relevant information required for building. Such as the name, version, source address, build

1.5.0

Push UAB to Remote Repositories

Use the ll-builder push command to push Linglong packages to Linglong remote repositories. View the help information for the ll-builder push command: ll-builder push --he

1.5.0

Run compiled App

Use ll-builder run to run the compiled executable program. View the help information for the ll-builder run command: ll-builder run --help Here is the output: Usage: ll-b

1.5.0

Attach To Container

Use ll-cli exec to enter the inside of the running Linglong container. View the help information for the ll-cli exec command: ll-cli exec --help Here is the output: Usage

1.5.0

Install Linglong Apps

Use ll-cli install to install Linglong apps. View the help information for the ll-cli install command: ll-cli install --help Here is the output: Usage: ll-cli [options] i

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. View the help information for the ll-

1.5.0

Force Quit Running App

Use ll-cli kill to force quit running Linglong apps. View the help information for the ll-cli kill command: ll-cli kill --help Here is the output: Usage: ll-cli [options]

1.5.0

List Installed Apps

Use ll-cli list to view the installed Linglong apps. View the help information for the ll-cli list command: ll-cli list --help Here is the output: Usage: ll-cli [options]

1.5.0

View Running Apps

Use ll-cli ps to view running Linglong Apps. View the help information for the ll-cli ps command: ll-cli ps --help Here is the output: Usage: ll-cli [options] ps Options:

1.5.0

Search Apps From Remote

Use ll-cli search to search app meta info from remote repository. View the help information for the ll-cli search command: ll-cli search --help Here is the output: Usage:

1.5.0

Run App

Use ll-cli run command to start a Linglong application. See help for the ll-cli run command: ll-cli run --help View the help information for the ll-cli run command: Usage

1.5.0

Uninstall App

Use ll-cli uninstall to uninstall Linglong apps. View the help information for the ll-cli uninstall command: ll-cli uninstall --help Here is the output: Usage: ll-cli [op

1.5.0

Update Linglong App

Use ll-cli update to update Linglong apps. View the help information for the ll-cli update command: ll-cli update --help Here is the output: Usage: ll-cli [options] updat

1.5.0

Install Linglong Environment

Kernel version requirement Use uname -r to check the kernel version: uname -r Here is the output: 5.10.101-amd64-desktop Kernel version requirement >=4.19. The 4.19 kerne

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。参考教程操作时注意对路径进行替换。由于玲珑应用运行在容器中，想要在宿主机上对其进行调试，我们需要在容器中使用 gdbserver 运行应用，所以首先需要安装 gdbserver。我们可以使用发行版

1.5.0

常见运行问题

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

1.5.0

常见构建问题

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

1.5.0

构建应用

ll-builder build命令用来构建玲珑应用。查看 ll-builder build命令的帮助信息： ll-builder build --help ll-builder build命令的帮助信息如下： Usage: ll-builder [options] build linglong build command tools

1.5.0

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

使用 ll-builder convert 转换 appimage 包格式( .appimage 或 .AppImage )为玲珑包格式( .layer 或 .uab ) 查看 ll-builder convert 命令的帮助信息： ll-builder convert --help ll-builder convert 命令的帮助信息如

1.5.0

创建项目

ll-builder create命令用来创建玲珑项目。查看 ll-builder create命令的帮助信息： ll-builder create --help ll-builder create命令的帮助信息如下： Usage: ll-builder [options] create <org.deepin.demo> Option

1.5.0

demo示例

初始化玲珑工程 ll-builder create org.deepin.demo 编辑linglong.yaml 填写软件包元信息 package: id: org.deepin.demo name: deepin-demo version: 0.0.1 kind: app description: | simple Qt demo.

1.5.0

导出 layer 文件

ll-builder export命令用来检出构建内容, 生成 layer 文件。查看 ll-builder export命令的帮助信息： ll-builder export --help ll-builder export命令的帮助信息如下： Usage: ll-builder [options] Options: -v, --ver

1.5.0

上架应用到商店

主要流程创建一个玲珑工程，使用ll-builder在本地构建出玲珑应用。将玲珑工程以pull request（PR）方式提交到https://github.com/linuxdeepin/linglong-hub项目。项目维护者审核内容通过后，将触发构建流程，构建成功后内容将被提交到玲珑测试仓库。应用通过测试后将会合并PR，并将应

1.5.0

ll-builder简介

ll-builder是为应用开发者提供的一款构建玲珑应用工具。主要功能如下：支持在独立容器内构建。提供 sdk 开发套件列表。查看ll-builder命令的帮助信息： ll-builder --help ll-builder 命令的帮助信息如下： Usage: ll-builder [options] subcommand [su

1.5.0

构建配置文件简介

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

1.5.0

推送uab到远程仓库

ll-builder push命令用来将玲珑软件包推送至玲珑远程仓库。查看ll-builder push命令的帮助信息： ll-builder push --help ll-builder push命令的帮助信息如下： Usage: ll-builder [options] push <filePath> Options: -v, --

1.5.0

运行编译后的应用

ll-builder run命令可以运行编译后的可执行程序。查看ll-builder run命令的帮助信息： ll-builder run --help ll-builder run命令的帮助信息如下： Usage: ll-builder [options] run Options: -v, --verbose show detail

1.5.0

进入容器内部

ll-cli exec命令可以进入正在运行的容器内部。查看ll-cli exec命令的帮助信息： ll-cli exec --help ll-cli exec命令的帮助信息如下： Usage: ll-cli [options] exec 9c41c0af2bad4617aea8485f5aaeb93a "bash" Options: -

1.5.0

安装应用

ll-cli install命令用来安装玲珑应用。查看ll-cli install命令的帮助信息： ll-cli install --help ll-cli install命令的帮助信息如下： Usage: ll-cli [options] install com.deepin.demo Options: -h, --help Disp

1.5.0

ll-cli简介

ll-cli是一个包管理器前端，用于管理玲珑应用的安装、卸载、查看、启动、关闭、调试、更新等操作。查看 ll-cli命令的帮助信息： ll-cli --help ll-cli命令的帮助信息如下： Usage: ll-cli [options] subcommand [sub-option] Options: -h --help Show

1.5.0

强制退出应用

ll-cli kill命令可以强制退出正在运行的玲珑应用。查看ll-cli kill命令的帮助信息： ll-cli kill --help ll-cli kill 命令的帮助信息如下： Usage: ll-cli [options] kill container-id Options: -h, --help Displays this

1.5.0

列出已安装的应用

ll-cli list命令可以查看已安装的玲珑应用。查看 ll-cli list命令的帮助信息： ll-cli list --help ll-cli list命令的帮助信息如下： Usage: ll-cli [options] list Options: -h, --help Displays help on commandline o

1.5.0

查看运行中的应用

ll-cli ps命令可以查看正在运行的玲珑应用。查看ll-cli ps命令的帮助信息： ll-cli ps --help ll-cli ps 命令的帮助信息如下： Usage: ll-cli [options] ps Options: -h, --help Displays help on commandline options. -

1.5.0

从远程仓库查询应用

ll-cli search命令可以查询玲珑远程仓库中的应用信息。查看 ll-cli search命令的帮助信息： ll-cli search --help ll-cli search命令的帮助信息如下： Usage: ll-cli [options] search com.deepin.demo Options: -h, --help

1.5.0

运行应用

ll-cli run命令可以启动一个玲珑应用。查看 ll-cli run命令的帮助信息： ll-cli run --help ll-cli run命令的帮助信息如下： Usage: ll-cli [options] run com.deepin.demo Options: -h, --help Displays help on comm

1.5.0

卸载应用

ll-cli uninstall命令可以卸载玲珑应用。查看ll-cli uninstall命令的帮助信息： ll-cli uninstall --help ll-cli uninstall命令的帮助信息如下： Usage: ll-cli [options] uninstall com.deepin.demo Options: -h, -

1.5.0

更新应用

ll-cli update命令可以更新玲珑应用。查看ll-cli update命令的帮助信息： ll-cli update --help ll-cli update命令的帮助信息如下： Usage: ll-cli [options] update com.deepin.demo Options: -h, --help Displays

1.5.0

安装玲珑环境

内核版本使用 uname -r 查看内核版本。 uname -r 输出如下： 5.10.101-amd64-desktop 内核版本要求>=4.19。 x86架构4.19内核需要开启user namespace。 deb包安装教程 deepin v23 deepin v23 已预装玲珑环境。 deb包下载 debian 11(bulls

1.5.0

简介

玲珑是统信软件自研的开源软件包格式，用于替代 deb、rpm等包管理工具，实现了应用包管理、分发、容器、集成开发工具等功能。当前包管理器存在的问题 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. Make sure t

1.6.3

Run FAQ

When the application runs to read the application installation resource file under /usr/share, why does the reading fail? Linglong applications run in a container, and th

1.6.3

Build FAQ

-lxxx failed in cmake type build, but ldconfig and pkg-config can query the library information. The link library path is not a regular path, the new path is /runtime/lib

1.6.3

FAQ

Where is the default configuration located for the linglong.yaml file generated by ll-pica? The configuration file for ll-pica is located at ~/.pica/config.json. Does ll-

1.6.3

Build App

Use ll-builder build to build a Linglong application. View the help information for the ll-builder build command: ll-builder build --help Here is the output: Usage: ll-bu

1.6.3

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

Use ll-builder convert to convert appimage format( .appimage or .AppImage ) pkg to linglong format( .layer or .uab ) pkg. View the help information for the ll-builder con

1.6.3

Create Linglong project

Use ll-builder create to create a Linglong project. View the help information for the ll-builder create command: ll-builder create --help Here is the output: Usage: ll-bu

1.6.3

Initialize Linglong Projects

Initialize Linglong Projects ll-builder create org.deepin.calculator Edit linglong.yaml Fill in the meta information of packages package: id: org.deepin.calculator name:

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. View the help information for the ll-builder export command: ll-builder export -

1.6.3

App to store

Main process Create a Linglong project and use ll-builder to build a Linglong app locally. Submit a pull request to the https://github.com/linuxdeepin/linglong-hub reposi

1.6.3

ll-builder Introduction

ll-builder is a tool for developers for building Linglong applications. The main functions are as follows: Supports building in a standalone sandbox. Provides DTK softwar

1.6.3

Manifests

linglong.yaml is the description file of a Linglong project, which stores the relevant information required for building. Such as the name, version, source address, build

1.6.3

Push UAB to Remote Repositories

Use the ll-builder push command to push Linglong packages to Linglong remote repositories. View the help information for the ll-builder push command: ll-builder push --he

1.6.3

Run compiled App

Use ll-builder run to run the compiled executable program. View the help information for the ll-builder run command: ll-builder run --help Here is the output: Usage: ll-b

1.6.3

Attach To Container

Use ll-cli exec to enter the inside of the running Linglong container. View the help information for the ll-cli exec command: ll-cli exec --help Here is the output: Usage

1.6.3

Install Linglong Apps

Use ll-cli install to install Linglong apps. View the help information for the ll-cli install command: ll-cli install --help Here is the output: Usage: ll-cli [options] i

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. View the help information for the ll-

1.6.3

Force Quit Running App

Use ll-cli kill to force quit running Linglong apps. View the help information for the ll-cli kill command: ll-cli kill --help Here is the output: Usage: ll-cli [options]

1.6.3

List Installed Apps

Use ll-cli list to view the installed Linglong apps. View the help information for the ll-cli list command: ll-cli list --help Here is the output: Usage: ll-cli [options]

1.6.3

View Running Apps

Use ll-cli ps to view running Linglong Apps. View the help information for the ll-cli ps command: ll-cli ps --help Here is the output: Usage: ll-cli [options] ps Options:

1.6.3

Search Apps From Remote

Use ll-cli search to search app meta info from remote repository. View the help information for the ll-cli search command: ll-cli search --help Here is the output: Usage:

1.6.3

Run App

Use ll-cli run command to start a Linglong application. See help for the ll-cli run command: ll-cli run --help View the help information for the ll-cli run command: Usage

1.6.3

Uninstall App

Use ll-cli uninstall to uninstall Linglong apps. View the help information for the ll-cli uninstall command: ll-cli uninstall --help Here is the output: Usage: ll-cli [op

1.6.3

Update Linglong App

Use ll-cli upgrade to upgrade Linglong apps. View the help information for the ll-cli upgrade command: ll-cli upgrade --help Here is the output: Usage: ll-cli [options] u

1.6.3

Add dependency

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

1.6.3

Conversion application

Conversion application The ll-pica convert command is used to generate the linglong.yaml file required by Linglong. View the help information for the ll-cli convert comma

1.6.3

Initialization configuration

The ll-pica init command is used to initialize the configuration information for the conversion package. View the help information for the ll-cli init command: ll-pica in

1.6.3

ll-pica Introduction

This tool currently provides the capability to convert DEB packages into Linglong packages. Generate the required linglong.yaml file for building Linglong applications an

1.6.3

Manifests · ll-pica

The package.yaml file serves as the foundation for ll-pica to convert packages into DEB format. It encompasses essential information such as the base and runtime versions

1.6.3

Build Linglong applications

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

1.6.3

Install linglong

Linglong is composed of three parts. ll-builder is used to build and debug Linglong applications, provided by linglong-builder. ll-box is a sandbox container, provided by

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。参考教程操作时注意对路径进行替换。由于玲珑应用运行在容器中，想要在宿主机上对其进行调试，我们需要在容器中使用 gdbserver 运行应用，所以首先需要安装 gdbserver。我们可以使用发行版

1.6.3

常见运行问题

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

1.6.3

常见构建问题

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

1.6.3

常见问题

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

1.6.3

构建应用

ll-builder build命令用来构建玲珑应用。查看 ll-builder build命令的帮助信息： ll-builder build --help ll-builder build命令的帮助信息如下： Usage: ll-builder [options] build linglong build command tools

1.6.3

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

使用 ll-builder convert 转换 appimage 包格式( .appimage 或 .AppImage )为玲珑包格式( .layer 或 .uab ) 查看 ll-builder convert 命令的帮助信息： ll-builder convert --help ll-builder convert 命令的帮助信息如

1.6.3

创建项目

ll-builder create命令用来创建玲珑项目。查看 ll-builder create命令的帮助信息： ll-builder create --help ll-builder create命令的帮助信息如下： Usage: ll-builder [options] create <org.deepin.demo> Option

1.6.3

demo示例

初始化玲珑工程 ll-builder create org.deepin.demo 编辑linglong.yaml 填写软件包元信息 package: id: org.deepin.demo name: deepin-demo version: 0.0.1 kind: app description: | simple Qt demo.

1.6.3

导出 layer 文件或 uab 文件

ll-builder export命令用来检出构建内容, 生成 layer 或 uab 文件。查看 ll-builder export命令的帮助信息： ll-builder export --help ll-builder export命令的帮助信息如下： Usage: ll-builder [options] Options: -v,

1.6.3

上架应用到商店

主要流程创建一个玲珑工程，使用ll-builder在本地构建出玲珑应用。将玲珑工程以pull request（PR）方式提交到https://github.com/linuxdeepin/linglong-hub项目。项目维护者审核内容通过后，将触发构建流程，构建成功后内容将被提交到玲珑测试仓库。应用通过测试后将会合并PR，并将应

1.6.3

ll-builder简介

ll-builder是为应用开发者提供的一款构建玲珑应用工具。主要功能如下：支持在独立容器内构建。提供 DTK 开发套件。查看 ll-builder命令的帮助信息： ll-builder --help ll-builder 命令的帮助信息如下： Usage: ll-builder [options] subcommand [sub

1.6.3

构建配置文件简介

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

1.6.3

推送uab到远程仓库

ll-builder push命令用来将玲珑软件包推送至玲珑远程仓库。查看ll-builder push命令的帮助信息： ll-builder push --help ll-builder push命令的帮助信息如下： Usage: ll-builder [options] push <filePath> Options: -v, --

1.6.3

运行编译后的应用

ll-builder run命令可以运行编译后的可执行程序。查看 ll-builder run命令的帮助信息： ll-builder run --help ll-builder run命令的帮助信息如下： Usage: ll-builder [options] run Options: -v, --verbose show detail

1.6.3

进入容器内部

ll-cli exec命令可以进入正在运行的容器内部。查看ll-cli exec命令的帮助信息： ll-cli exec --help ll-cli exec命令的帮助信息如下： Usage: ll-cli [options] exec 9c41c0af2bad4617aea8485f5aaeb93a "bash" Options: -

1.6.3

安装应用

ll-cli install命令用来安装玲珑应用。查看 ll-cli install命令的帮助信息： ll-cli install --help ll-cli install命令的帮助信息如下： Usage: ll-cli [options] install com.deepin.demo Options: -h, --help Dis

1.6.3

ll-cli简介

ll-cli是一个包管理器前端，用于管理玲珑应用的安装、卸载、查看、启动、关闭、调试、更新等操作。查看 ll-cli命令的帮助信息： ll-cli --help ll-cli命令的帮助信息如下： Usage: ll-cli [options] subcommand [sub-option] Options: -h --help Show

1.6.3

强制退出应用

ll-cli kill命令可以强制退出正在运行的玲珑应用。查看ll-cli kill命令的帮助信息： ll-cli kill --help ll-cli kill 命令的帮助信息如下： Usage: ll-cli [options] kill container-id Options: -h, --help Displays this

1.6.3

列出已安装的应用

ll-cli list命令可以查看已安装的玲珑应用。查看 ll-cli list命令的帮助信息： ll-cli list --help ll-cli list命令的帮助信息如下： Usage: ll-cli [options] list Options: -h, --help Displays help on commandline o

1.6.3

查看运行中的应用

ll-cli ps命令可以查看正在运行的玲珑应用。查看ll-cli ps命令的帮助信息： ll-cli ps --help ll-cli ps 命令的帮助信息如下： Usage: ll-cli [options] ps Options: -h, --help Displays help on commandline options. -

1.6.3

从远程仓库查询应用

ll-cli search命令可以查询玲珑远程仓库中的应用信息。查看 ll-cli search命令的帮助信息： ll-cli search --help ll-cli search命令的帮助信息如下： Usage: ll-cli [options] search com.deepin.demo Options: -h, --help

1.6.3

运行应用

ll-cli run命令可以启动一个玲珑应用。查看 ll-cli run命令的帮助信息： ll-cli run --help ll-cli run命令的帮助信息如下： Usage: ll-cli [options] run com.deepin.demo Options: -h, --help Displays help on comm

1.6.3

卸载应用

ll-cli uninstall命令可以卸载玲珑应用。查看ll-cli uninstall命令的帮助信息： ll-cli uninstall --help ll-cli uninstall命令的帮助信息如下： Usage: ll-cli [options] uninstall com.deepin.demo Options: -h, -

1.6.3

更新应用

ll-cli upgrade命令可以更新玲珑应用。查看 ll-cli upgrade命令的帮助信息： ll-cli upgrade --help ll-cli upgrade命令的帮助信息如下： Usage: ll-cli [options] upgrade com.deepin.demo Options: -h, --help Dis

1.6.3

添加依赖

添加依赖玲珑应用可能缺少包依赖，目前可以通过在 linglong.yaml 文件添加对应的包依赖。 ll-pica adep 命令用来给 linglong.yaml 文件添加包依赖。查看 ll-pica adep 命令的帮助信息： ll-pica adep --help ll-pica adep 命令的帮助信息如下： Add depe

1.6.3

转换应用

转换应用 ll-pica convert 命令用来生成玲珑需要使用的 linglong.yaml 文件。查看 ll-pica convert 命令的帮助信息： ll-pica convert --help ll-pica convert 命令的帮助信息如下： Convert deb to uab Usage: ll-pica conve

1.6.3

初始化配置

ll-pica init 命令用来初始化转换包的配置信息。会读取 ~/.pica/config.json 文件来生成 package.yaml，查看 ll-pica init 命令的帮助信息： ll-pica init --help ll-pica init 命令的帮助信息如下： init config template Usage:

1.6.3

ll-pica 简介

本工具目前提供 deb 包转换为玲珑包的能力，生成构建玲珑应用需要的 linglong.yaml 文件，并依赖 ll-builder 来实现应用构建和导出。目前只支持转换符合应用商店打包规范的软件包。转换工具只是辅助工具，并不能保证被转换的应用一定能运行，可能软件本身依赖库的安装路径或其他配置路径与玲珑内部路径不统一，导致无法运行，需要

1.6.3

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

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

1.6.3

构建玲珑应用

以 deepin-calculator 为例，介绍从源码构建玲珑包的过程。玲珑应用的 appid 需要使用倒置域名的方式命名。创建项目 mkdir org.deepin.calculator 目录下创建 linglong.yaml 文件 touch org.deepin.calculator/linglong.yaml 进入目录 cd

1.6.3

安装玲珑

玲珑由三部分组成： ll-builder 用来构建和调试玲珑应用，由 linglong-builder 提供。 ll-box 沙箱容器，由 linglong-box 提供。 ll-cli 管理和运行玲珑应用，由 linglong-bin 提供。 deepin v23 sudo apt install linglong-builder li

1.6.3

概述

玲珑是统信软件自研的开源软件包格式，用于替代 deb、rpm等包管理工具，实现了应用包管理、分发、容器、集成开发工具等功能。当前包管理器存在的问题 deb、rpm都属于强依赖型的包管理系统，同时允许各个组件之间有复杂的交叉依赖（或循环依赖）关系。这使得维护包管理系统需要极强的专业知识，稍有不慎，就会导致系统彻底故障，无法修复。安装依赖

2026-01-27

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

在 Linux 桌面世界，有一套奠定一切互操作性基础的“通用语言”——由 freedesktop.org 组织制定并维护的 XDG 规范。 XDG 是 Linux 解决生态碎片化、建立统一资源访问规范的关键标准。无论是应用开发者还是发行版维护者，要让自己的产品在现代 Linux 桌面上运行良好，就必须遵循 XDG 标准。它是 Linux

2026-01-22

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

你是否曾为音视频转换工具安装复杂、依赖繁琐而头疼？是否期待一款既功能强大、又易于分发的一站式处理工具？近期，社区开发者 @Jack Lau 将应用 OpenConverter 适配成玲珑格式，使其能够以完整的形态无缝集成至玲珑 & deepin 生态中，真正实现了 “下载即用，无需配置” 的流畅体验。 OpenConverter：不只

2025-12-05

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

中国开源年会 COSCon 是业界最具影响力的开源盛会之一，由开源社在 2015 年首次发起，2016 年正式得以命名。九年来，中国开源年会以其独特的中立社区定位及日益增加的影响力，吸引了越来越多国内外企业、高校、开源组织和社区的大力支持。 2025 年，站在第十年的里程碑节点，将以 “众智开源 | Open Source, Open I

2025-11-12

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

“如意玲珑社区测试源”是由社区爱好者@mozixun、@罐子联合打造的第三方社区共享项目，本质是一个针对如意玲珑应用的补充仓库。作为一个纯社区爱好者贡献的项目，它完全依托社区自发力量构建，核心定位是 “官方源的互补与拓展”—— 不替代官方源，而是聚焦官方暂未覆盖的细分场景，通过灵活适配和快速迭代，为用户提供更丰富的玲珑应用使用选择，让玲

2025-09-29

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

作者：mozixun 原文链接：https://bbs.deepin.org/post/291068 在我不懈的努力下,玲珑内GTK4的运行环境支持做出来了: https://github.com/LFRon/org.deepin.runtime.gtk4 然后两天两夜研究爆改WebKit2gtk修复其链接问题,最终干了出来: https

2025-09-29

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

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

2025-09-21

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

作者：克亮原文链接：https://bbs.deepin.org/post/291716 什么是pica ？pica 怎么用？官方文档介绍：https://linyaps.org.cn/guide/ll-pica/introduction.html 玲珑pica是一套用于将不同格式的应用包（deb、AppImage、Flatpak）转

2025-09-06

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

作者：送葬人原文链接：https://bbs.deepin.org/post/291328 准备工作在进行转换工作前，你需要以下网站和应用： svg转换png工具图片裁剪工具 flathub 玲珑包使用文档最新版本的玲珑（截至2025.9.6，最新版本为1.9.9）运营给的自动化测试工具如果你准备参加论坛开展的2025年第1期

2025-09-03

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

作者：克亮原文链接>>> 近期论坛开展2025年第1期「玲珑应用迁移与开发征募赛」，奖金丰厚，希望大家多多参与，别错过薅官方羊毛大好机会，因个人进段时间线下工作比较忙，不能很好参与活动，现在把自己略懂的一点知识跟大家分享。如有错误，请多多指教。活动页面地址：https://bbs.deepin.org/post/290641 目前

2025-08-25

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

作者：克亮原文链接：https://bbs.deepin.org/post/291009 上一期地址：https://bbs.deepin.org/post/290919 接着上一期结尾，如何利用本地统信兼容引擎把下载好的EXE文件打包成deb后再转化成玲珑包的方法，其实也非常简单。我们跟随打包任务节奏走，针对官方发布的🍥 指定

2025-08-22

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

作者：MeGusta 原文链接：https://bbs.deepin.org/post/290895 与flathub的工程仓库类似，在github上也有集中存放如意玲珑包工程的项目：linglongdev，链接为https://github.com/orgs/linglongdev 。在这个项目里，存放着许多玲珑工程的清单文件 lin

2025-08-15

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

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

2025-07-30

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

本文作者：MeGusta 转载自：社区论坛方法如下： 1.从仓库下载deb包： apt download libxcb-damage0 libxcb-composite0 libqt5xdg3 libqt5xdgiconloader3 dde-qt5integration dde-qt5xcb-plugin 2.解压deb之后，获取并组

2025-07-22

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

最近把主力系统换成银河麒麟后， “找应用难、装应用更难” 成了日常痛点 —— 要么适配版本少，要么装的时候一堆依赖报错，折腾半天还未必能用。直到偶遇如意玲珑，才算把这些坎儿慢慢趟平了。分享下真实体验，给同样用银河麒麟的朋友避坑～一、先搞懂：如意玲珑是个啥？简单说，它是跨 Linux 发行版的应用生态：不管你用银河麒麟、Ubun

2025-07-15

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

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

2025-06-16

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

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

2025-06-05

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

初夏的蓉城，技术与热情交织。 5 月 24 日，由 deepin（深度）社区与openEuler 社区联合主办，如意玲珑社区承办的 openEuler & deepin Meetup 活动在成都成功举办。本次活动以 “共建开源生态” 为核心主题，汇聚技术专家与开源爱好者，聚焦文档生态、应用分发、AI 编程、开源工具与悬赏激励五大维度展开

2025-05-22

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

2025 年 5 月 24 日（周六），一场聚焦「开源生态共建」的技术聚会将在成都启幕，欢迎各位爱好者与我们一同聊聊对于开源、开发等一切问题的想法和探索。本次活动由 deepin（深度）社区和 openEuler 社区联合主办，如意玲珑社区承办，聚焦 AI 编程变革、Linux 应用分发、开源工具孵化、开源贡献等多种话题，邀请多位行业专

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. This update focuses on build toolchain optimizations, expanded multi-system support, and

2025-05-14

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

如意玲珑 v1.8.1 稳定版本已正式推仓发布，这次更新主要涉及构建工具链优化、多系统支持扩展和稳定性提升等方面。接下来将为大家详细介绍本次更新的具体内容、各发行版支持情况、仓库服务说明以及升级指南，助您顺利完成升级。一、如意玲珑v 1.8.1更新日志构建能力增强依赖管理优化：支持通过 apt 包管理器安装构建工具链依赖项；压

2025-03-12

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

通过《如意玲珑应用构建指南（一）：规范体系与配置文件全解析》的学习后，相信大家已经对玲珑应用构建工程基础知识有了一定的了解。在接下来的系列推文中，我们将深入实操环节，带大家利用所学知识正式构建玲珑应用。本篇作为“如意玲珑应用构建从入门到实战”系列的第二篇，我们将以开源图形应用 qBittorrent 为例，为大家将演示如何进入玲珑容器

2025-03-12

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

本文内容转自社区用户 System233 的项目 linglong-killer-self-service ，原文链接>>> 玲珑杀手Go – layer子命令：玲珑应用构建革命中的最后一块拼图前言在玲珑杀手Go最近更新的v1.4.x版本中，引入了全新的layer子命令，该命令独立于ll-builder之外实现了对玲珑layer文件的

2025-03-07

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

本文内容转自社区用户 System233 的项目 linglong-killer-self-service ，原文链接>>> ll-killer-go – 玲珑杀手Go 前言本项目是 Linglong Killer Self-Service (ll-killer 玲珑杀手) 的Go语言重构版本，将原本构建阶段的shell脚本重新用Go实

2025-03-06

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

2025 年 3 月 1 日下午，由 deepin（深度）社区与华中科技大学开放原子开源俱乐部携手举办的 WHLUG（武汉 Linux 用户组）线下沙龙在华中科技大学圆满落幕。本次活动聚集了 40 余位来自武汉本地的开源爱好者、华中科技大学、湖北大学的高校学生线下参与。活动围绕 4 个核心议题以及 1 个闪电演讲展开，期间参与者就相关主

2025-02-28

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

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

2025-02-27

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

内容转自社区论坛 by mozixun | 原文链接该教程适合AppImage/使用Electron框架构建等几乎不需要额外依赖的应用要稍微加一点的也可以在开始这个教程之前,首先我们要搞清楚玲珑容器内是如何工作的,这里我用一张图来解释了解了deb/rpm应用和玲珑容器内到底是怎么工作的区别之后才能对本文后面的讲解有清楚的认知一级

2025-02-26

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

内容转自社区论坛 by ^9星守辰^ | 原文链接此篇教程适用于将deb, appimage, 打包好的二进制包转为如意玲珑包的学习。官方有ll-pica转制工具,但一直觉得不好用,所以一直都是手动打包手动打包也很简单, 下面以打包appimage的微信为例第一次写, 不好地方请见谅, 欢迎大家补充纠正基础工作目录: basel

2025-01-18

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

本文内容转自社区用户 System233 的项目 linglong-killer-self-service ，原文链接>>> Linglong Killer Self-Service (ll-killer 玲珑杀手) 这几天研究了下如何突破玲珑限制，根除玲珑打包问题。相信任何一个尝试过打包玲珑应用的人都曾被玲珑容器的路径限制和依赖库问题弄

2025-01-15

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

2024年，如意玲珑社区在社区发展及软件生态建设领域迈出了坚实的步伐。作为开放原子开源基金会的孵化项目，在这一年里稳步推进各项工作，在多个关键层面取得了切实的成果。以下是对本年度社区工作的回顾总结。突出成果 1）生态发展多主流发行版集成适配：目前如意玲珑已稳定支持在 deepin、UOS、openEuler、Ubuntu、Debia

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. However, this raises a question: As the n

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. Having established functional build rules in the previous session, this

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. This tutoria

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. This knowledge

2024-12-09

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

本文转自社区论坛 by mozixun | 原文链接众所周知,不在deepin上使用玲珑软件包是最可靠的,因为我们跨发行版SIG组会排坑于是玲珑1.7出了问题后,官方进行了快速修复,到1.7.2已经基本稳定,正在等待与deepin其他组件一起发布内测,于是我们SIG组率先拉下了源代码并给Ubuntu系发行版都编译了一遍(因为现在SIG

2024-11-28

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

内容转自社区论坛 by Ziggy | 原文链接前言有听过如意玲珑–新时代Linux桌面应用分发和治理方案的朋友应该知道如意玲珑方案众多核心特性之一就是: “通过隔离技术，彻底解决系统与应用、应用与应用之间因升级引起的兼容性冲突问题。”基于此特性以及如意玲珑技术架构介绍, 我们可以大体知道如意玲珑方案主要通过沙箱、容器方案来对进行应用

2024-11-22

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

本文作者：Ziggy 前言有听过如意玲珑——新时代Linux桌面应用分发和治理方案的朋友应该知道如意玲珑方案众多核心特性之一就是: “通过隔离技术，彻底解决系统与应用、应用与应用之间因升级引起的兼容性冲突问题。” 基于此特性以及如意玲珑技术架构介绍, 我们可以大体知道如意玲珑方案主要通过沙箱、容器方案来对进行应用与系统间的隔离, 这意味

2024-11-20

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

内容转自社区论坛 by mozixun | 原文链接既然Ubuntu默认内置了snap的firefox(但是打开真的慢),deepin内置了玲珑版deepin浏览器,于是我也来掺和一下打包地表最快的Chromium浏览器因为我不大会用ll-pica工具,所以我以家常菜appimage版本入手,以SSE4通用版为例(也就是处理器有SSE

2024-11-18

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

11月16日下午，如意玲珑社区在开放原子校源行公益项目、deepin社区和OpenTenBase社区的支持下，成功走进天津中德应用技术大学，举办了一场围绕开源通识、技术、社区的互动式实践教学Meetup。此次活动吸引了天津中德应用技术大学150余名学生的热情参与，同时通过线上直播与更广泛的观众共享。活动内容涵盖了项目分享、实践课堂实操等

2024-11-06

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

内容转自公众号深度操作系统 by Ziggy 经验和模板加持下，几行代码就能轻松将微信转换成玲珑格式 PS: 本文干货较多,内容虽多但并非标题党,从小白成长为大神均需要悄悄成长! PS: 本文中提及微信程序所使用的开发技术或任何非官方通告的信息均与微信开发团队无关。无法保障信息准确性,一切内容请以微信官方及微信开发团队通告为准萌生想法

2024-10-24

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

原文转载自deepin论坛： [玲珑应用本体上传]Ubuntu 24.10玲珑安装包更新作者：mozixun deepin刚刚发布了拿捏Flatpak的转制工具,然而并没有把最新玲珑推给Ubuntu,于是我来推一下是时候发挥一下一人拉源码全员内测的优秀传统了,Ubuntu 24.10今日构建的玲珑和linglong-pica的deb包

2024-10-24

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

有人曾问小编道：如意玲珑主要是希望解决什么问题？小编答曰：为了促进Linux生态发展呀！那个人抬杠：Linux虽然发展得一般，但是生态一直很繁荣啊（笑而不语）确实繁荣，不信你看，光软件包格式就有：deb、rpm、Flatpak、Snap、AppImage…… 国际惯例，打不过就加入！于是有了我们的：如意玲珑！咱们全新加入了 1）

2024-10-21

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

本文内容转载自公众号：云水木石作者：陈正勇原文链接：https://mp.weixin.qq.com/s/VE41M9pCsEEMCJGyRwaroQ 在使用 Deepin/UOS 系统时，我注意到应用商店新增了一个“玲珑应用”的类别。经过一番了解，发现这是一种最新研发的国产软件包格式——如意玲珑。那么，什么是如意玲珑？为什么要开发

2024-10-11

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

今天，如意玲珑社区迎来了一个新的里程碑——如意玲珑应用商店正式上线！如意玲珑应用商店传送地址：https://store.linyaps.org.cn/ 这个由社区爱好者从0到1自发组织和开发的应用商店，作为如意玲珑社区最重要的组成部分之一，丰富了Linux软件生态，改善了用户在 Linux 系统上寻找和安装软件的体验，支持更多的软件包

2024-09-30

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

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

2024-09-30

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

在 openKylin 2.0 上构建玲珑应用原文转自：https://bbs.deepin.org/post/278740 作者：Ziggy Electron应用玲珑化转制在完成前面tar归档格式应用玲珑化转制演示之后,我们即将开始展示Electron应用玲珑化转制的效果。我们这里选取一款 Electron based的应用思源笔

2024-09-30

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

在 openKylin 2.0 上构建玲珑应用原文转载自：https://bbs.deepin.org/post/278738 作者：Ziggy tar归档格式应用玲珑化转制在完成前面运行演示之后,我们即将开始展示tar归档格式应用玲珑化转制的效果，这里的完整解释是使用tar归档格式压缩、封装的Linux应用二进制文件。我们这里选取一

2024-09-18

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

一、社区头条如意玲珑正式集成至发行版deepin 23，系统预装如意玲珑完整环境及组件，并且玲珑格式已成为系统预装应用商店的首选应用格式，用户可直接安装及管理玲珑格式应用。截止8月，已上架玲珑应用超千款。如意玲珑社区正式成立linglong SIG、Linyaps Packaging SIG。Linyaps Packaging SI

2024-09-14

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

在 Ubuntu 24.04 上安装玲珑环境系统要求在安装玲珑环境之前,你的系统环境应该满足以下要求: 系统版本: Ubuntu 24.04 LTS 平台: x86_64 其他: 需要提供图形化界面的桌面环境设置桌面环境玲珑环境主要服务于大部分具备图形化界面的应用,在体验前你最好具备一个可以使用的桌面环境。由于本次案例主要演示 U

2024-09-13

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

在 openKylin 2.0 上安装玲珑环境系统要求在安装玲珑环境之前,你的系统环境应该满足以下要求: 系统版本: openKylin 2.0 Release 平台: x86_64 安装&配置玲珑主程序软件包在安装 openKylin 2.0 之后,你现在就可以安装玲珑主程序了.详细可参考安装玲珑 openKylin 2.0上当前

2024-09-11

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

转载自论坛：基于Python的Appimage转玲珑包GUI程序作者：HelloWorld! deb下载使用环境：deepin23，安装玲珑构建环境，python3.12 图片：使用方法： 1. 选择appimage文件，点击open 2. 填写软件包名，应用名称，应用版本和描述，包名为4位数字，逗号分隔 3. 点击开始构建 4.

2024-09-06

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

内容来自：社区论坛 by Ziggy 原文链接背景近期收到了来自不同渠道deepin 23用户对于系统文件管理器或其他系统组件性能大幅下降的问题，在结合deepin开源社区热心用户的参考解决方案后deepin内部研发团队针对此问题进行了相关定位、方案评估。问题通过应用商店安装的部分玲珑应用会向系统玲珑的目录（/var/lib/li

2024-09-05

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

转载自论坛：[技术交流] 如何将Python程序转换为玲珑包作者：HelloWorld! 在deepin23上将简单的python程序迁移到玲珑以ScreenPen为例在全局系统上运行ScreenPen模块 python3 -m screenpen 安装依赖库pyqt5 pip3 install pyqt5 安装依赖库numpy p

2024-09-02

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

在openEuler 24.03 LTS上安装玲珑环境系统要求在安装玲珑环境之前,你的系统环境应该满足以下要求: 系统版本: openEuler 24.03 LTS 平台: x86_64 其他: 需要提供图形化界面的桌面环境设置桌面环境玲珑环境主要服务于大部分具备图形化界面的应用,在体验前你最好具备一个像DDE一样可以使用的桌面环

2024-09-02

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

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

2024-09-02

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

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

2024-09-02

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

在完成前面的运行演示之后，我们现在来看看在openEuler 24.03 LTS上构建玲珑应用的效果。对于本次课程规划来说,咱们接下来主要是演示应用appimage以及java应用的玲珑化转制 Appimage应用玲珑化转制 ll-builder是为应用开发者提供的一款构建玲珑应用工具，用于提供容器化的应用构建环境，方便开发者在不同的环境

2024-09-02

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

C++跨标准版本兼容性检测实例在本章节开始前,简单介绍下目前玲珑生态提供的runtime状态.目前提供了20、23版本的Runtime以及Foundation用于构建及运行程序,部分场景下需要维护者根据实际情况或报错信息选择合适的Runtime以及Foundation.在选择适合当前项目的Runtime以及Foundation前,你需要

2024-09-02

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

deepin 23平台上的Pica转制工具教程&adep模块运用实例 ll-pica为玲珑应用构建工具体系中的一款辅助工具，目前提供 deb 包转换为玲珑包的能力，生成构建玲珑应用需要的 linglong.yaml 文件，并依赖 ll-builder 来实现应用构建和导出。截止目前为止,Pica转换工具目前仅支持在deepin V23环境

2024-08-23

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

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

2024-08-12

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

原文作者：mozixun 原文地址：https://bbs.deepin.org/zh/post/276254 以下为正文部分：本文会比较详细地描述玲珑是什么,它诞生的背景和它要解决的问题文章参考了deepin官方对玲珑的大致介绍:https://www.deepin.org/zh/deepin-linglong/ 玲珑诞生的背景众

2024-08-12

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

开放原子如意玲珑（OpenAtom Linyaps）是一种新型的独立包管理工具集，专注于解决Linux系统下由传统软件包格式的复杂性和交叉依赖关系引起的兼容性问题。项目通过先进的隔离技术，将应用与系统完全解耦，从根本上解决因环境变化引发的应用兼容性问题，实现“一个架构，一次构建”，致力于简化软件开发流程、降低维护成本、加强数据安全，促进技

2024-07-31

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

玲珑新版本 1.5.8-1 已经发布，一起来看看都有什么新变动。 ? 软件包信息包名: linglong 版本: 1.5.8-1 ? 软件包仓库地址你可以从以下地址获取最新软件包，也可以通过V23内测版本升级进行同步更新： deb [trusted=yes] https://ci.deepin.com/repo/obs/deepin:

2024-07-16

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

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

2024-07-10

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

2020年，借鉴沙箱/容器的技术方案，玲珑原型的核心开发悄然完成； 2022年，作为 deepin 发行版未来的核心特性，玲珑随 deepin V23 预览版共同发布，初步具备可用性；同年，通过了开放原子开源基金会 TOC 技术评审，成为孵化筹备期项目； 2024年5月，玲珑正式与开放原子开源基金会签署捐赠协议，成为孵化期项目。目前，玲

2024-07-10

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

关于玲珑玲珑是由统信软件于2024年5月正式捐赠给开放原子开源基金会孵化及运营的开源项目，是一种新型的独立包管理工具集，旨在解决Linux系统下由传统软件包格式的复杂性和交叉依赖关系引起的兼容性问题，以及由于权限管控过于松散而带来的安全风险。从生态发展的角度来看，玲珑包通过实现“一个架构，一次构建”的目标，解决了软件在跨发行版构建中的

2024-07-01

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

玲珑作为一种新型的独立包管理工具集，玲珑主要提供分层与隔离的运行环境，解决传统包管理系统强依赖导致的兼容性问题，以及权限松散导致的安全问题。当前，玲珑已支持 4 个发行版，包括 deepin、统信 UOS 以及 Debian 和 Ubuntu。玲珑的隔离技术可以将应用与系统进行完全解耦，从而彻底解决系统与应用、应用与应用之间因升级和适配引

2024-07-01

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

本文转载自 deepin论坛-玲珑专区-原文链接作者：deepin-superuser 解决方案 1.补齐 JRE 相关依赖打开linglong.yaml我们可以发现，依赖中只添加了openjdk-11-jre，所以我们要补齐剩余的 ll-pica adep -d "ca-certificates-java,fonts-dejavu-

2024-07-01

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

本文转载自 deepin论坛-玲珑专区-原文链接作者：deepin-superuser 在打包的时候难免会遇到一些奇奇怪怪的错误，这里分享一下打包报 start.sh:行2: ./xxx: No such file or directory 的解决方案前置条件安装了最新版本的 linglong-pica 1.1.1-1 并且使用 a

2024-07-01

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

本文转载自 deepin论坛-玲珑专区-原文链接作者：root 在打包的时候难免会遇到一些奇奇怪怪的错误，这里分享一下打包报 xxx.so: version GLIBC_2.38′ not found` 的解决方案前置条件由于linglong容器提供rumtime的GNU libc 版本是2.37，但官方有木有提供linglong的

2024-07-01

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

本文转载自 deepin论坛-玲珑专区-原文链接作者：HelloWorld! 最近打包很多朋友都会遇到python解释器错误的问题,我们可以使用python虚拟环境解决这个问题.|文章末尾有python3.11的压缩包下载地址1:解压压缩包后就是python3的一个文件夹,将这个文件夹拷贝到files目录下,如果有python3的文件夹

2024-06-27

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

本文以构建 desktop-entry-editor 为例，该项目依赖较为简单，仅需玲珑官方文档中默认提供的基础运行环境即可成功构建运行。第一步：前期准备在终端中执行 sudo apt install linglong-builder --no-install-recommends 安装 ll-builder 工具（由于推荐安装依赖

2024-06-12

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

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

2024-05-22

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

1) 活动介绍本次「deepin生态共建小组」玲珑迁移专场活动诚邀所有开源爱好者加入，将众多开源软件迁移为“为兼容与安全而生”的独立软件包管理格式——玲珑格式，解决Linux系统下传统软件包格式复杂、交叉的依赖关系导致的各种兼容性问题，共同提升全球操作系统生态的安全性与稳定性。活动将提供最新的技术指导文档、玲珑包转换与构建工具等，希望

2023-12-25

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

近期，开放原子开源大赛在江苏无锡圆满落幕。作为焦点赛道，由统信软件联合开放原子基金会大赛举办的玲珑赛道吸引超过全球100支参赛队伍参与，展现了开源社区的活力和热情。过去，基于Linux的操作系统发行版，在实际应用中存在应用程序在操作系统版本间和不同发行版间不能兼容或无法保持持续兼容的问题，给用户的实际使用带来了非常大困扰。玲珑项目同

2023-08-30

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

8月29日，2023开源和信息消费大赛新闻发布会在北京召开。本次大赛聚焦开源和信息消费发展趋势和应用需求，旨在以赛促学、以赛促用，进一步发掘消费潜力，激发市场活力，改善消费环境，擦亮示范招牌，普及开源文化，培育选拔优秀开源人才，赋能行业和经济高质量发展。作为本次大赛开源板块的重要赛道之一，由统信软件承办的“玲珑赛道”同期正式启动项目征集

2023-08-29

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

前言：软件包管理器的演进 Linux 操作系统一直以其开源性质和灵活性而闻名，而要使 Linux 系统能够顺利安装并运行所需的软件，最关键的部分就是软件包管理器。顾名思义，Linux 软件包管理器是一种在 Linux 操作系统上用于安装、更新和卸载软件包的工具。它的历史可以追溯到上世纪 90 年代，此时 Linux 正处于起步阶段，软件

2023-06-15

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

今天，在第十八届开源中国开源世界高峰论坛上，统信软件终端操作系统产线总经理、深度社区（deepin）负责人王耀华发表了题为“打造深度开源社区，共建中国开发者生态”的主题演讲。王耀华表示，芯片卡脖子很要紧，但软件卡脖子也很要紧。必须用开源的模式把基础软件的根扎下去，才能让创新持续发生，让商业持续繁荣。回看半个世纪以来的软件发展历史，开源

2023-06-11

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

刚刚在2023开放原子全球开源峰会上统信软件正式宣布将玲珑项目代码、玲珑官网、玲珑商店等资产捐赠给开放原子开源基金会我们将与基金会汇聚更多产业力量，携手推动玲珑的发展，共建分发标准，加速生态建设！ “操作系统是软件产业的底座，开源是操作系统的核心’元器件’。当前，以开源方式加速操作系统技术创新已经成为主流共识。”统信软件高级副总

2022-10-04

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

玲珑是什么？玲珑——统信软件自研的开源软件包格式，用于与dpkg、rpm等包管理工具共同实现应用包管理、分发、沙箱、集成开发等功能。在deepin 23 Preview阶段，独立创新的包格式到来，将解决linux长久存在的依赖问题和安全问题。同样，它也将成为建立独立上游的基础。玲珑的诞生 “玲珑”的名称从何而来？八宝玲珑塔，蕴含芥子

2026-02-13

linyaps-appstore

Linyaps Store · Installation Guide Quick Install Multi-Platform Support Community Maintained Regularly Updated Developed and Maintained by Linyaps Simple Store SIG Automa

2026-02-06

玲珑商店社区版安装说明

玲珑应用商店社区版 · 安装指南快速安装多平台支持社区维护持续更新由 Linyaps Simple Store SIG 开发维护推荐方式下载 deb 安装包适用发行版：glibc 2.28+ 的发行版（Debian 10+、Ubuntu 18.04+、Fedora 等） Gitee Releases 访问 Gitee 发布

2025-04-11

Get Involved

Contribute to Linyaps Linyaps Community is an open-source community formed by enthusiasts, developers, advocates, and users. Ways to Contribute Promotion Invite others to

2025-04-07

contact us

Contact us Forum ：linyaps zone- CommunityEmail：tongxinruanjianlinglong@uniontech.cn

2025-04-07

Linyaps Simple Store SIG

Linyaps Simple Store SIG Group IntroductionWelcome to the Linyaps Simple Store SIG! We focus on developing and operating the Linyaps Store, including: Web-based StoreClie

2025-04-07

Linyaps Generic-Linux SIG

Linyaps Generic-Linux SIG Group IntroductionWelcome to the Linyaps Generic-Linux SIG! This group is dedicated to enabling Linyaps to run smoothly on distributions beyond

2025-04-07

Linyaps Packaging SIG

Linyaps Packaging SIG Group IntroductionWelcome to the Linyaps Packaging SIG, a special interest group dedicated to enriching the Linyaps application ecosystem. We focus

2025-04-07

linglong SIG

linglong SIG Group IntroductionThis SIG focuses on discussions related to the “Linyaps” containerized package management tool. Scope and ObjectivesActivities: Discussions

2025-04-03

Community Charter

Community Charter Community Philosophy The Linyaps Community (“the Community”) is an open-source community established by enterprises, institutions, social organizations,

2025-04-03

SIG Participation Guide

SIG Participation Guide A SIG is a group focused on a specific interest area, contributing its outputs back to the broader community. All SIGs operate transparently, allo

2024-11-19

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

Linyaps Generic-Linux SIG 跨发行版移植开发小组简介欢迎来到Linyaps Generic-Linux SIG,本小组致力于让玲珑能在deepin以外的发行版以及DDE以外的桌面环境上正常运行玲珑以及其应用,促进Linux玲珑应用生态的发展小组活动范围及目标提高玲珑跨平台与桌面环境兼容性,让玲珑及运行在玲珑上的

2024-10-31

生态贡献者

如意玲珑生态贡献者 Contributors join us 2025年6月贡献榜克亮 Junior Contributor 6月软件上架 9 款 mozixun Intermediate Contributor 6月软件更新 6 款玲泷沙 Junior Contributor 6月软件更新 3 款蓝色的猫 Junior Contr

2024-10-16

玲珑生态共建小组

玲珑生态共建小组（Linyaps Packaging SIG）小组简介欢迎来到Linyaps Packaging SIG，一个专注于丰富玲珑应用生态的特别兴趣小组。我们致力于进行玲珑格式包应用的构建，并持续优化软件的构建及分发流程，促进Linux生态的发展。小组活动范围及目标丰富玲珑应用生态，包括打包、构建和分发。推动软件打包标准化，提

2024-09-20

玲珑生态贡献指南

生态贡献指南加入 linyaps-packaging SIG 参与玲珑应用贡献，成为玲珑社区核心贡献者如意玲珑（Linyaps）是一种新型的独立包管理工具集，专注于解决Linux系统下由传统软件包格式的复杂性和交叉依赖关系引起的兼容性问题。项目通过先进的隔离技术，将应用与系统完全解耦，从根本上解决因环境变化引发的应用兼容性问题，实现“一

2024-08-29

课程中心

课程中心如意玲珑生态指南本课程将系统性地介绍如何在不同的Linux发行版上安装并运行玲珑环境，并通过具体构建案例的演示，详细讲解玲珑应用的构建流程，演示应用安装及调试方法。此外，教程还将深入探讨特殊场景下的构建解决方案，帮助具备初级编程基础的开发者跨越环境障碍，迅速掌握玲珑软件的构建技巧，实现一次构建，软件跨平台的无缝部署，最大化软件

2024-06-20

贡献指引

参与社区贡献如意玲珑社区（简称：玲珑社区）是一个由开源爱好者、软件开发者、社区倡导者以及广大玲珑用户共同组成的开源社区在如意玲珑社区，你可以贡献代码参与玲珑产品的开发为技术发展做贡献参与测试为产品提供问题反馈和使用建议参与活动组织和参与玲珑社区的活动贡献文档为玲珑社区提供开发文章和使用指南宣传推广撰写文章和剪辑视频

2024-06-04

关于玲珑

关于如意玲珑如意玲珑Linyaps（简称：玲珑）是一种新型的独立包管理工具集，致力于治理Linux系统下传统软件包格式复杂、交叉的依赖关系导致的各种兼容性问题，以及过于松散的权限管控导致的安全风险。公开项目地址目前项目已正式捐赠给开放原子开源基金会（OpenAtom Foundation），处于项目孵化期如意玲珑的由来八宝玲珑塔

2024-06-04

如意玲珑SIG参与指南

SIG参与指南 SIG 即 Special Interest Group，特殊兴趣小组。每个 SIG 围绕其对应的一个兴趣目标进行活动的开展，并将其活动成果回馈给整个社区。各个 SIG 组会以公开透明的形式进行相关的小组活动，以便对某个特定方向感兴趣的社区贡献者可以方便的参与到对应的兴趣组之中。签署贡献者协议参与技术贡献，需先签署贡献

2024-06-04

联系我们 Contact Us

联系我们 / Contact Us 论坛交流/Forum ：linyaps zone- Community联系邮箱/Email：tongxinruanjianlinglong@uniontech.cn 联系官方 / Contact Us 用户交流群 / WeChat Group 关注公众号 / WeChat Official Accoun

2024-06-04

社区章程

社区章程社区理念如意玲珑社区（Linyaps Community）（以下简称“社区”）是由企业单位、事业单位、社会团体、个人开发者等，基于共建、共治、共享原则组建的开源社区。社区立足开源，驱动创新。思想开放，与未来同行。致力于推动包管理工具集的开源与革新，为所有人提供自由、开放的交流平台，追求做最好的开源社区产品。社区发行和维护玲珑社

2024-06-04

如意玲珑应用商店SIG

Linyaps Simple Store SIG 如意玲珑应用商店SIG 小组简介欢迎来到简易玲珑商店(Linyaps Simple Store SIG)小组。本小组由前后端开发 Jokul、Shirosu、wuhan、caoyuee、 Yoloke、mozixun，页面设计Gyro，商店运营 superliya 等核心贡献者组成。我

2024-06-04

如意玲珑主程序开发SIG

linglong SIG 小组简介本 SIG 主要进行“玲珑”容器化包管理工具相关的讨论。活动范围与目标活动方式：于 Matrix 服务器以及相关项目的 Issue 区中进行相关讨论，讨论内容包括但不限于 bug 上报以及相关技术讨论。主要目标为推进与进行“玲珑”相关工具的开发与维护。小组章程友好地进行“玲珑”相关工具/技术方面的讨论讨论

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.