Skip to content

TIP

This document is applicable to version 1.5.x, Please use the command ll-cli --version to check your linyaps program version.


convert appimage format( .appimage or .AppImage ) pkg to linglong format( .layer or .uab ) pkg

Use ll-builder convert to convert appimage format( .appimage or .AppImage ) pkg to linglong format( .layer or .uab ) pkg.

View the help information for the ll-builder convert command:

bash
ll-builder convert --help

Here is the output:

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
  -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, you can generate
                                             convert config file by use -o
                                             option

The ll-builder convert command will generate a directory according to specified app name( --name option), it will as a root directory of the linglong project, where the linglong.yaml file is located. and it supports two convert methods:

  1. you can use --file option to convert to linglong pkg according to specified appimage file;
  2. you can use --url and --hash option to convert to linglong pkg according to specified appimage url and hash value;

you can use --output option to generate config file( linglong.yaml ) of linglong project and a script of build linglong .layer(.uab) then you can execute script file to generate after you modify the linglong.yaml file. if you do not specify this option, it will export linglong .layer or linglong .uab directly.

Take converting BrainWaves into linglong .layer through --url as an example, the main steps as follows:

Specify the relevant parameters of the linglong package you want to convert, you can acquire io.github.brainwaves_0.15.1_x86_64_runtime.layer or io.github.brainwaves_0.15.1_x86_64_runtime.uab wait a moment.

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" -v

Take converting BrainWaves-0.15.1.AppImage into linglong.layer through --file as an example, the main steps as follows:

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" -v