Appearance

Return to top
On this page

TIP

此文档适用于 1.6.x, 请使用 ll-cli --version 检查您的玲珑程序版本。


Tips: 此文档适用于1.6.3以下的玲珑版本，1.6.3以上的版本可参考文档：转换appimage应用包格式

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

使用 ll-builder convert 转换 appimage 包格式( .appimage 或 .AppImage )为玲珑包格式( .layer 或 .uab )

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

bash
ll-builder convert --help

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

text
Usage: apps/ll-builder/ll-builder [options] convert

Options:
  -v, --verbose                              show detail log
  -h, --help                                 Displays help on commandline
                                             options.
  --help-all                                 Displays help including Qt
                                             specific options.
  -f, --file <*.deb,*.AppImage(*.appimage)>  app package file, it not required option,
                                             you can ignore this option when you
                                             set -u option
  -u, --url <pkg url>                        pkg url, it not required option,
                                             you can ignore this option when you
                                             set -f option
  --hs, --hash <pkg hash value>              pkg hash value, it must be used
                                             with --url option
  -i, --id <app id>                          the unique name of the app
  -n, --name <app description>               the description the app
  -V, --version <app version>                the version of the app
  -d, --description <app description>        detailed description of the app
  --icon <path>                              uab icon (optional)
  -l, --layer                                export layer file
  -o, --output <script name>                 not required option, it will
                                             generate linglong.yaml and
                                             script,you can modify
                                             linglong.yaml,then enter the
                                             directory(app name) and execute the
                                             script to generate the linglong
                                             .layer(.uab)

Arguments:
  convert                                    convert app with (deb,AppImage(appimage)) format to
                                             linglong format, the default format is uab
                                             if you want to export a layer file
                                             you can use the --layer option
                                             you can generate convert config file by use -o option

ll-builder convert 命令会根据指定的应用名称（ --name 选项）生成一个目录，该目录会作为玲珑项目的根目录，即 linglong.yaml 文件所在的位置。它支持两种转换方法：

  1. 你可以使用 --file 选项将指定的 appimage 文件转换为玲珑包文件；
  2. 你可以使用 --url 和 --hash 选项将指定的 appimage url 和 hash 值转换为玲珑包文件;
  3. 你可以使用 --layer 选项导出 .layer 格式文件，否则将默认导出 .uab 格式文件。

Tips: 在玲珑版本大于1.5.7时，convert 默认导出 uab 包，如果想要导出 layer 文件，需要加上 --layer 参数

你可以使用 --output 选项生成玲珑项目的配置文件( linglong.yaml )和构建玲珑 .layer ( .uab )的脚本文件 然后你可以执行该脚本去生成对应的玲珑包当你修改 linglong.yaml 配置文件后。如果不指定该选项，将直接导出对应的玲珑包。

以通过 --url 选项将 BrainWaves appimage 文件转换为玲珑 .layer 文件为例，主要步骤如下：

指定要转换的玲珑包的相关参数，稍等片刻后你就可以得到 io.github.brainwaves_0.15.1_x86_64_runtime.layer 或者 io.github.brainwaves_0.15.1_x86_64_runtime.uab 包文件。

bash
ll-builder convert --url "https://github.com/makebrainwaves/BrainWaves/releases/download/v0.15.1/BrainWaves-0.15.1.AppImage" --hash "04fcfb9ccf5c0437cd3007922fdd7cd1d0a73883fd28e364b79661dbd25a4093" --name "io.github.brainwaves" --id "io.github.brainwaves" --version "0.15.1" --description "io.github.brainwaves"

以通过 --file 选项将 BrainWaves-0.15.1.AppImage 转换为玲珑 .uab 为例，主要步骤如下：

bash
ll-builder convert -f ~/Downloads/BrainWaves-0.15.1.AppImage --name "io.github.brainwaves" --id "io.github.brainwaves" --version "0.15.1" --description "io.github.brainwaves"

转换完成的目录结构如下:

text
io.github.brainwaves
└── io.github.brainwaves_x86_64_0.15.1.0_main.uab

以通过 --file 选项将 BrainWaves-0.15.1.AppImage 转换为玲珑 .layer 为例，主要步骤如下：

bash
ll-builder convert -f ~/Downloads/BrainWaves-0.15.1.AppImage --name "io.github.brainwaves" --id "io.github.brainwaves" --version "0.15.1" --description "io.github.brainwaves" --layer

转换完成的目录结构如下:

text
io.github.brainwaves
├── io.github.brainwaves_0.15.1.0_x86_64_binary.layer
└── io.github.brainwaves_0.15.1.0_x86_64_develop.layer

.uab 或 .layer 文件验证 导出的.uab或者.layer需要安装后进行验证，安装 layer 文件和运行应用参考：安装应用