转换 appimage
包格式( .appimage
或 .AppImage
) 到玲珑包格式( .layer
或 .uab
)
使用 ll-builder convert
转换 appimage 包格式( .appimage
或 .AppImage
)为玲珑包格式( .layer
或 .uab
)
查看 ll-builder convert
命令的帮助信息:
ll-builder convert --help
ll-builder convert
命令的帮助信息如下:
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
文件所在的位置。它支持两种转换方法:
- 你可以使用
--file
选项将指定的appimage
文件转换为玲珑包文件; - 你可以使用
--url
和--hash
选项将指定的appimage url
和hash
值转换为玲珑包文件; - 你可以使用
--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
包文件。
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
为例,主要步骤如下:
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"
转换完成的目录结构如下:
io.github.brainwaves
└── io.github.brainwaves_x86_64_0.15.1.0_main.uab
以通过 --file
选项将 BrainWaves-0.15.1.AppImage
转换为玲珑 .layer
为例,主要步骤如下:
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
转换完成的目录结构如下:
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 文件和运行应用参考:安装应用