前期，我们已分别发布如意玲珑在 deepin V23 与 UOS V20、openEuler 24.03发行版的操作指南，本文，我们将为大家详细介绍 Ubuntu 24.04、Debian 12、openKylin 2.0rc 发行版操作指南。

另外，我们还有线上的玲珑应用构建入门课程，帮助开发者迅速掌握如意玲珑软件的构建技巧，实现一次构建，软件跨平台的无缝部署，最大化软件开发效率。

如意玲珑坚持开源精神，为开发者、用户以及开源爱好者搭建了一个共同成长的平台，共同促进Linux生态系统的繁荣与发展。近日，如意玲珑成熟度再度提升，六大发行版兼容适配进展如下：

• deepin V23：已支持在 RC 版本上运行，并已集成至即将发布的deepin V23 正式版中，成为 deepin V23 的核心软件包格式。已支持CPU架构包括 X86、ARM、Loong64；
• UOS V20：UOS 1070 版本已支持运行如意玲珑环境及如意玲珑应用，将正式集成到 UOS 1071 版本发布，已支持 CPU 架构包括 X86、ARM、Loong64；
• openEuler 24.03：环境已集成至 EUR 仓库，需要手动添加使用 ；
• Ubuntu 24.04、Debian 12、openKylin 2.0rc 发行版：已提供独立的如意玲珑环境仓库，可手动获取如意玲珑仓库源并安装运行环境。

以上发行版使用手册均可在如意玲珑官网获取，官网提供的使用手册是一份全面的教程资源，它指导广大开发者、用户和开源爱好者从入门到精通，全面掌握如意玲珑的使用，涵盖安装、配置、开发、调试等关键环节，助力大家一步步成为如意玲珑的专家。

一、安装如意玲珑

本文适用于如意玲珑1.5.6版本, 请使用 ll-cli --version 检查您的如意玲珑程序版本。

1、如意玲珑组成

• ll-builder 用来构建和调试如意玲珑应用，由 linglong-builder 提供；
• ll-box 沙箱容器，由 linglong-box 提供；
• ll-cli 管理和运行如意玲珑应用，由 linglong-bin 提供。

2、Ubuntu 24.04 获取如意玲珑仓库源及安装运行

• 添加如意玲珑仓库源并更新仓库信息

sudo bash -c "echo 'deb [trusted=yes] 
https://download.opensuse.org/repositories/
home:/kamiyadm/xUbuntu_24.04/ ./' > /etc/apt/sources.list.d/linglong.list"
sudo apt update

• 安装如意玲珑环境

sudo apt install linglong-builder linglong-box linglong-bin

3、debian 12 获取如意玲珑仓库源及安装运行

• 添加如意玲珑仓库源并更新仓库信息

sudo bash -c "echo 'deb [trusted=yes] 
https://download.opensuse.org/repositories/home:/kamiyadm/Debian_12/ ./' > 
/etc/apt/sources.list.d/linglong.list"
sudo apt update

• 安装如意玲珑环境

sudo apt install linglong-builder linglong-box linglong-bin

4、openKylin 2.0rc 获取如意玲珑仓库源及安装运行

• 添加如意玲珑仓库源并更新仓库信息

sudo bash -c "echo 'deb [trusted=yes] 
https://ci.deepin.com/repo/obs/linglong:/multi_distro/openkylin2.0_repo/ ./' > 
/etc/apt/sources.list.d/linglong.list"sudo apt update

• 安装如意玲珑环境

sudo apt install linglong-builder linglong-box linglong-bin

5、安装桌面环境（可选）

如果想运行 gui 类型应用，需要安装桌面环境，仅运行终端类型应用不需要安装桌面环境。这里以安装 DDE 为例，也支持在其他桌面环境下使用，如 KDE，GNOME 。

sudo dnf install dde
sudo systemctl set-default graphical.target

6、重启系统

sudo reboot

二、使用如意玲珑

1、使用构建工具 ll-builder

1.1 创建项目

创建如意玲珑项目命令：ll-builder create

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

ll-builder create --help

ll-builder create 命令的帮助信息如下：

Usage: ll-builder [options] create <org.deepin.demo>


Options:
  -v, --verbose  show detail log
  -h, --help     Displays help on commandline options.
--help-all     Displays help including Qt specific options.
Arguments:
create         create build template project
name           project name

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

ll-builder create org.deepin.hello

命令输出如下：

org.deepin.hello/
└── linglong.yaml

1.2 编辑 linglong.yaml

linglong.yaml 文件语法的版本：version: "1"

软件包元信息配置：

package:
  id: org.deepin.hello
  name: hello
  version: 0.0.0.1
  kind: app
  description: /
    simple  demo.

基础环境，最小的根文件系统：

base: org.deepin.foundation/23.0.0

如意玲珑应用的启动命令：

command: [echo, -e, hello world]

在容器内构建项目需要的命令：

build: /  
echo 'hello' #some operation to build this project

完整的linglong.yaml配置内容如下：

version: "1"


package:
  id: org.deepin.hello
  name: your name #set your application name
  version: 0.0.0.1 #set your version
  kind: app
  description: /
    your description #set a brief text to introduce your application.


command: [echo, -e, hello world] #the commands that your application need to run.


base: org.deepin.foundation/23.0.0 #set the base environment, this can be changed.


#set the runtime environment if you need, a example of setting deepin runtime is as follows.
#runtime:
#org.deepin.Runtime/23.0.1


#set the source if you need, a simple example of git is as follows.
#sources:
#  - kind: git
#    url: https://github.com/linuxdeepin/linglong-builder-demo.git
#    version: master\n
#    commit: a3b89c3aa34c1aff8d7f823f0f4a87d5da8d4dc0


build: /
  echo 'hello' #some operation to build this project

1.3 构建应用

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

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

ll-builder build --help

ll-builder build命令的帮助信息如下：

Usage: ll-builder [options] build
linglong build command tools
Examples:
ll-builder build -v
ll-builder build -v -- bash -c "echo hello"


Options:
  -v, --verbose         show detail log (deprecated, use QT_LOGGING_RULES)
  -h, --help            Displays help on commandline options.
--help-all            Displays help including Qt specific options.
--exec <command>      run exec than build script
--offline             only use local files. This implies --skip-fetch-source
                        and --skip-pull-depend
--skip-fetch-source   skip fetch sources
--skip-pull-depend    skip pull dependency
--skip-run-container  skip run container. This implies skip-commit-output
--skip-commit-output  skip commit build output
--arch <arch>         set the build arch


Arguments:
  build                 build project

ll-builder build 命令必须运行在工程的根目录，即 linglong.yaml 文件所在位置。以如意玲珑项目 org.deepin.demo 为例，构建如意玲珑应用主要步骤如下：

• 进入到 org.deepin.demo 项目工程目录：

cd org.deepin.demo

• 执行 ll-builder build 命令将开始构建如意玲珑应用：

ll-builder build

构建完成后，构建内容将自动提交到本地 ostree 缓存中。

1.4 验证应用

ll-builder run 命令用来运行验证应用。

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

ll-builder run --help

ll-builder run 命令的帮助信息如下：

Usage: ll-builder [options] run


Options:
  -v, --verbose  show detail log
  -h, --help     Displays this help.
  --exec <exec>  run exec than build script


Arguments:
  run            run project

在 linglong.yaml 文件所在位置，执行 ll-builder run 即可运行该应用。

示例项目 org.deepin.demo 运行结果如下：

hello

也可从构建缓存中导出成离线文件，通过客户端工具ll-cli安装使用。

1.5 导出离线文件

ll-builder 提供了子命令 export 来导出离线文件（.uab/.layer）。

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

ll-builder export --help

ll-builder export 命令的帮助信息如下：

Usage: ll-builder [options]


Options:
  -v, --verbose      show detail log (deprecated, use QT_LOGGING_RULES)
  -h, --help         Displays help on commandline options.
--help-all         Displays help including Qt specific options.
  -f, --file <path>  file path of the linglong.yaml (default is ./linglong.yaml)
  -i, --icon <path>  uab icon (optional)
  -l, --layer        export layer file

在 linglong.yaml 文件所在位置，执行以下命令即可将构建缓存导出离线文件。

ll-builder export --layer

执行成功后，将在当前目录下，生成两个以 .layer 结尾的文件：

org.deepin.demo_0.0.0.1_x86_64_develop.layer
org.deepin.demo_0.0.0.1_x86_64_binary.layer

包含binary（此前这部分名为runtime）的部分为应用的主要运行内容，develop 在 binary 的基础上保留调试环境（如调试符号）。

2、使用客户端 ll-cli

2.1 安装如意玲珑应用

2.1.1 使用 ll-cli install 安装

首先查看 ll-cli install 命令的帮助信息：

ll-cli install --help

ll-cli install 命令的帮助信息如下：

linglong CLI
A CLI program to run application and manage linglong pagoda and tiers.


Usage:
    ll-cli [--json] --version
    ll-cli [--json] run APP [--no-dbus-proxy] [--dbus-proxy-cfg=PATH] ( [--file=FILE] | [--url=URL] ) [--] [COMMAND...]
    ll-cli [--json] ps
    ll-cli [--json] exec PAGODA [--working-directory=PATH] [--] COMMAND...
    ll-cli [--json] enter PAGODA [--working-directory=PATH] [--] [COMMAND...]
    ll-cli [--json] kill PAGODA
    ll-cli [--json] [--no-dbus] install TIER
    ll-cli [--json] uninstall TIER [--all] [--prune]
    ll-cli [--json] upgrade TIER
    ll-cli [--json] search [--type=TYPE] [--dev] TEXT
    ll-cli [--json] [--no-dbus] list [--type=TYPE]
    ll-cli [--json] repo modify [--name=REPO] URL
    ll-cli [--json] repo show
    ll-cli [--json] info TIER
    ll-cli [--json] content APP
Arguments:
    APP     Specify the application.
    PAGODA  Specify the pagodas (container).
    TIER    Specify the tier (container layer).
    URL     Specify the new repo URL.
    TEXT    The text used to search tiers.


Options:
    -h --help                 Show help information of ll-cli.
--version                 Show version.
--json                    Use json to output command result, you can get the description of the output refer to linglong api documentation(/usr/share/linglong/api/api.json).
--no-dbus                 Use peer to peer DBus, this is used only in case that DBus daemon is not available.
--no-dbus-proxy           Do not enable linglong-dbus-proxy.
--dbus-proxy-cfg=PATH     Path of config of linglong-dbus-proxy.
--file=FILE               you can refer to https://linglong.dev/guide/ll-cli/run.html to use this parameter.
--url=URL                 you can refer to https://linglong.dev/guide/ll-cli/run.html to use this parameter.
--working-directory=PATH  Specify working directory.
--type=TYPE               Filter result with tiers type. One of "runtime", "app" or "all". [default: app]
--state=STATE             Filter result with the tiers install state. Should be "local" or "remote". [default: local]
--prune                   Remove application data if the tier is an application and all version of that application has been removed.
--dev                     include develop tiers in result.
Subcommands:
    run        Run an application.
    ps         List all pagodas.
    exec       Execute command in a pagoda.
    enter      Enter a pagoda.
kill       Stop applications and remove the pagoda.
install    Install tier(s).
uninstall  Uninstall tier(s).
upgrade    Upgrade tier(s).
search     Search for tiers.
list       List known tiers.
    repo       Display or modify information of the repository currently using.
    info       Display the information of layer
content    Display the exported files of application

从如意玲珑仓库安装应用，以百度网盘为例：

ll-cli install com.baidu.baidunetdisk

ll-cli install 命令需要输入应用完整的 id，若仓库有多个版本则会默认安装最高版本。安装指定版本需在 appid 后附加对应版本号：

ll-cli install com.baidu.baidunetdisk/4.17.7.0

应用安装完成后，客户端会显示安装结果。

2.1.2 从本地通过离线文件安装应用

以构建示例 org.deepin.demo 为例。

• 安装 .layer 文件：

ll-cli install ./org.deepin.demo_0.0.0.1_x86_64_binary.layer

• 查看安装是否成功命令：

 ll-cli list | grep org.deepin.demo

2.2 运行如意玲珑应用

如果有桌面环境的情况下，可以通过双击启动器下的图标运行应用，或通过终端命令行运行，使用run命令运行应用:

ll-cli run org.deepin.demo

以上便是 Ubuntu 24.04、Debian 12、openKylin 2.0rc 发行版操作指南的全部内容，感兴趣的朋友赶紧试试吧。