如意玲珑支持发行版再添新成员，openEuler 安装使用如意玲珑操作指南

    如意玲珑（Linyaps）项目已与开放原子开源基金会完成捐赠协议签署，目前如意玲珑已成为基金会的正式孵化期项目。

    如意玲珑是开源软件包格式，用于替代deb、rpm等包管理工具，实现应用包管理、分发、容器、集成开发工具等功能。作为一种新型的独立包管理工具集，如意玲珑主要提供分层与隔离的运行环境，来解决传统包管理系统强依赖导致的兼容性问题，以及权限松散导致的安全问题。减少不同操作系统下分发时的打包次数，做到“一个架构，一次构建”，为Linux生态发展提供了坚实的基础。

    如意玲珑发行版适配进展

    在openEuler系统上如意玲珑已集成到Eur仓库，添加该仓库后，用户手动安装使用；

    在UOS1070系统上添加如意玲珑外网仓库到系统仓库后，用户手动安装使用；

    如意玲珑已集成到deepinV23系统，用户可直接使用；

    目前适配了openKylin、麒麟专业版、Ubuntu24.04和Debian12。对于即将发布的1.6版本，将提供各发行版的独立仓库，用户可以手动添加使用。

    近日，如意玲珑官网使用手册新增openEuler添加如意玲珑仓库源介绍，诚邀您抢先体验。

    openEuler安装如意玲珑

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

    1、如意玲珑组成

    ll-builder用来构建和调试如意玲珑应用，由linglong-builder提供；

    ll-box沙箱容器，由linglong-box提供；

    ll-cli管理和运行如意玲珑应用，由linglong-bin提供。

    2、openEuler添加如意玲珑仓库源并更新仓库信息

    sudocurl-o/etc/yum.repos.d/linglong.repo-Lhttps://eur.openEuler.openatom.cn/coprs/kamiyadm/linglong/repo/openEuler-24.03_LTS/kamiyadm-linglong-openEuler-24.03_LTS.repo
    sudodnfupdate

    3、安装玲珑环境

    sudodnfinstalllinglong-builderlinglong-boxlinglong-bin

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

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

    sudodnfinstalldde
    sudosystemctlset-defaultgraphical.target

    5、重启系统

    sudoreboot

    openEuler使用如意玲珑

    1、使用构建工具ll-builder

    1.1创建项目

    创建如意玲珑项目命令：

    ll-buildercreate

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

ll-buildercreate--help
    ll-buildercreate命令的帮助信息如下：
    Usage:ll-builder[options]create<org.deepin.demo>
    Options:
    -v,--verboseshowdetaillog
    -h,--helpDisplayshelponcommandlineoptions.
    --help-allDisplayshelpincludingQtspecificoptions.
    Arguments:
    createcreatebuildtemplateproject
    nameprojectname

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

    ll-buildercreateorg.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:/
    simpledemo.

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

    base:org.deepin.foundation/23.0.0

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

    command:[echo,-e,helloworld]

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

    build:/

    echo'hello'#someoperationtobuildthisproject

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

  version:"1"
    package:
    id:org.deepin.hello
    name:yourname#setyourapplicationname
    version:0.0.0.1#setyourversion
    kind:app
    description:/
    yourdescription#setabrieftexttointroduceyourapplication.
    command:[echo,-e,helloworld]#thecommandsthatyourapplicationneedtorun.
    base:org.deepin.foundation/23.0.0#setthebaseenvironment,thiscanbechanged.
    #settheruntimeenvironmentifyouneed,aexampleofsettingdeepinruntimeisasfollows.
    #runtime:
    #org.deepin.Runtime/23.0.1
    #setthesourceifyouneed,asimpleexampleofgitisasfollows.
    #sources:
    #-kind:git
    #url:https://github.com/linuxdeepin/linglong-builder-demo.git
    #version:master\n
    #commit:a3b89c3aa34c1aff8d7f823f0f4a87d5da8d4dc0
    build:/
    echo'hello'#someoperationtobuildthisproject

    1.3构建应用

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

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

    ll-builderbuild--help

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

    --exec<command>runexecthanbuildscript
    --offlineonlyuselocalfiles.Thisimplies--skip-fetch-source
    and--skip-pull-depend
    --skip-fetch-sourceskipfetchsources
    --skip-pull-dependskippulldependency
    --skip-run-containerskipruncontainer.Thisimpliesskip-commit-output
    --skip-commit-outputskipcommitbuildoutput
    --archsetthebuildarch
    Arguments:
    buildbuildproject

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

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

    cdorg.deepin.demo

    ●执行ll-builderbuild命令将开始构建如意玲珑应用：

    ll-builderbuild

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

    1.4验证应用

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

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

    ll-builderrun--help
    ll-builderrun命令的帮助信息如下：
    Usage:ll-builder[options]run
    Options:
    -v,--verboseshowdetaillog
    -h,--helpDisplaysthishelp.
    --exec<exec>runexecthanbuildscript
    Arguments:
    runrunproject

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

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

    hello

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

    1.5导出离线文件

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

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

    ll-builderexport--help
    ll-builderexport命令的帮助信息如下：
    Usage:ll-builder[options]
    Options:
    -v,--verboseshowdetaillog(deprecated,useQT_LOGGING_RULES)
    -h,--helpDisplayshelponcommandlineoptions.
    --help-allDisplayshelpincludingQtspecificoptions.
    -f,--file<path>filepathofthelinglong.yaml(defaultis./linglong.yaml)
    -i,--icon<path>uabicon(optional)
    -l,--layerexportlayerfile

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

    ll-builderexport--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-cliinstall安装

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

    ll-cliinstall--help

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

linglongCLI
    ACLIprogramtorunapplicationandmanagelinglongpagodaandtiers.
    Usage:
    ll-cli[--json]--version
    ll-cli[--json]runAPP[--no-dbus-proxy][--dbus-proxy-cfg=PATH]([--file=FILE]|[--url=URL])[--][COMMAND...]
    ll-cli[--json]ps
    ll-cli[--json]execPAGODA[--working-directory=PATH][--]COMMAND...
    ll-cli[--json]enterPAGODA[--working-directory=PATH][--][COMMAND...]
    ll-cli[--json]killPAGODA
    ll-cli[--json][--no-dbus]installTIER
    ll-cli[--json]uninstallTIER[--all][--prune]
    ll-cli[--json]upgradeTIER
    ll-cli[--json]search[--type=TYPE][--dev]TEXT
    ll-cli[--json][--no-dbus]list[--type=TYPE]
    ll-cli[--json]repomodify[--name=REPO]URL
    ll-cli[--json]reposhow
    ll-cli[--json]infoTIER
    ll-cli[--json]contentAPP
    Arguments:
    APPSpecifytheapplication.
    PAGODASpecifythepagodas(container).
    TIERSpecifythetier(containerlayer).
    URLSpecifythenewrepoURL.
    TEXTThetextusedtosearchtiers.
    Options:
    -h--helpShowhelpinformationofll-cli.
    --versionShowversion.
    --jsonUsejsontooutputcommandresult,youcangetthedescriptionoftheoutputrefertolinglongapidocumentation(/usr/share/linglong/api/api.json).
    --no-dbusUsepeertopeerDBus,thisisusedonlyincasethatDBusdaemonisnotavailable.
    --no-dbus-proxyDonotenablelinglong-dbus-proxy.
    --dbus-proxy-cfg=PATHPathofconfigoflinglong-dbus-proxy.
    --file=FILEyoucanrefertohttps://linglong.dev/guide/ll-cli/run.htmltousethisparameter.
    --url=URLyoucanrefertohttps://linglong.dev/guide/ll-cli/run.htmltousethisparameter.
    --working-directory=PATHSpecifyworkingdirectory.
    --type=TYPEFilterresultwithtierstype.Oneof"runtime","app"or"all".[default:app]
    --state=STATEFilterresultwiththetiersinstallstate.Shouldbe"local"or"remote".[default:local]
    --pruneRemoveapplicationdataifthetierisanapplicationandallversionofthatapplicationhasbeenremoved.
    --devincludedeveloptiersinresult.
    Subcommands:
    runRunanapplication.
    psListallpagodas.
    execExecutecommandinapagoda.
    enterEnterapagoda.
    killStopapplicationsandremovethepagoda.
    installInstalltier(s).
    uninstallUninstalltier(s).
    upgradeUpgradetier(s).
    searchSearchfortiers.
    listListknowntiers.
    repoDisplayormodifyinformationoftherepositorycurrentlyusing.
    infoDisplaytheinformationoflayer
    contentDisplaytheexportedfilesofapplication

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

    ll-cliinstallcom.baidu.baidunetdisk

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

    ll-cliinstallcom.baidu.baidunetdisk/4.17.7.0

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

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

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

    安装.layer文件：

  ll-cliinstall./org.deepin.demo_0.0.0.1_x86_64_binary.layer

    查看安装是否成功命令：

    ll-clilist|greporg.deepin.demo

    2.2运行玲珑应用

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

  ll-clirunorg.deepin.demo

    如意玲珑生态共建

    已有数十家企业、数十位个人开发者参与如意玲珑应用生态贡献，目前已成功适配超过2000款玲珑应用，这些应用将逐步上架至如意玲珑网页版商店、deepin以及统信应用商店，为广大用户提供更丰富的选择和更便捷的体验。诚挚邀请广大伙伴及用户加入如意玲珑生态共建，携手推动Linux生态的进步和发展。