Explore the field guideDocumentationField guidesCommunitySearchStoreJournal

2024-09-02

Application building, part 3: openEuler 24.03 LTS and AppImage

Follow the AppImage conversion example on openEuler 24.03 LTS, including the original project configuration and commands.

After completing the previous running demonstration, let's now take a look at the effect of building Linyaps applications on openEuler 24.03 LTS.
For this course planning, we will mainly demonstrate the Linyaps conversion of appimage and java applications.

Appimage application Linyaps transformation

ll-builder is a Linyaps application building tool provided for application developers. It is used to provide a containerized application construction environment to facilitate developers to build consistent applications in different environments. Currently, ll-builder supports converting Appimage applications that can successfully run on the current system to Linyaps application format.
Appimage application Linyaps conversion is mainly implemented through the "ll-builder convert" module. You can obtain a detailed help manual through "ll-builder convert –help"

[ziggy@localhost /]$ ll-builder convert --help
Usage: ll-builder [options] convert

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 <*.deb,*.AppImage(*.appimage)>  app package file, it not required
                                             option, you can ignorethis option
                                             when you set --url option and
                                             --hash option
  -u, --url <pkg url>                        pkg url, it not required option,
                                             you can ignorethis 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)
  -l, --layer                                export layer file
  --icon <path>                              uab icon (optional)

Arguments:
  convert                                    convert app with
                                             (deb,AppImage(appimage)) format to
                                             linglong format, you can generate
                                             convert config file by use -o
                                             option

After summarizing the above parameters, we can refer to the commonly used conversion formulas:

[ziggy@localhost /]$ ll-builder convert -f $appimage_file --name "$app_name" --id "$app_id" --version "$app_version" --description "$app_description" --layer -v

Appimage application Linyaps transformation

Parameter description:

Parameters Explanation
$appimage_file Full path to Appimage application file
$app_name Application name
$app_id App id after converting Appimage to Linyaps application
$app_version Appimage converted to Linyaps application version
$app_description Application Description
–layer After the Linyaps application is built, export it to a layer file
-v Show detailed process when building

Specific examples:

ll-builder convert -f /home/ziggy/linglong-build/appimage/LM_Studio-0.2.31.AppImage --name "LM-Studio" --id "ai.lmstudio" --version "0.2.31" --description "Discover, download, and run local LLMs." --layer -v

After the conversion is completed, you can refer to the above ".layer" independent online installation file" installation method to test whether the build is successful.

English edition: Linglong editorial · 18 October 2026. Original publication: 2024-09-02.