Explore documentation

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

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.

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

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

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.

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: busctl --system call org.deepin.linglong.SystemHelper \…

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…

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

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

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…

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…

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…

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…

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.

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…

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…

2026-10-16

ll-builder-remove

NAME ll-builder-remove - Remove built applications SYNOPSIS ll-builder remove [options] ref...

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…

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…

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.

2026-10-16

ll-cli-enter

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

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…

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…

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.

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.

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…

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.

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.

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.

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…

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.

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…

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…

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

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…

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…

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.

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.

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

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.

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? The ll-pica configuration file is located at ~/.pica/config.json.