Search the field guide

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?

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.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…

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.

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.

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…

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.

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

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

Diagnose an empty store or a failed installation

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

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.

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