Linyaps

English

简体中文

English

简体中文

Appearance

TIP

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


Build Example Demo ​

Initialize a Linglong Application Project ​

bash
ll-builder create org.deepin.demo

Edit the linglong.yaml Configuration File ​

Configure Package Metadata ​

yaml
package:
  id: org.deepin.demo
  name: demo
  kind: app
  version: 1.0.0.0
  description: |
    A simple demo app.

Configure Application Startup Command ​

yaml
command:
  - demo

Configure Base System and Runtime Environment ​

yaml
base: org.deepin.base/23.1.0
runtime: org.deepin.runtime.dtk/23.1.0

Configure Source Code Information ​

Use Git to Fetch the Source Code

yaml
sources:
  - kind: git
    url: "https://github.com/linuxdeepin/linglong-builder-demo.git"
    commit: master
    name: linglong-builder-demo

Configure Build Rules ​

yaml
cd /project/linglong/sources/linglong-builder-demo
rm -rf build || true
mkdir build
cd build
qmake ..
make
make install

Complete linglong.yaml Configuration File ​

yaml
version: "1"

package:
  id: org.deepin.demo
  name: demo
  kind: app
  version: 1.0.0.0
  description: |
    A simple demo app.

command:
  - demo

base: org.deepin.base/23.1.0
runtime: org.deepin.runtime.dtk/23.1.0

sources:
  - kind: git
    url: "https://github.com/linuxdeepin/linglong-builder-demo.git"
    commit: master
    name: linglong-builder-demo

build: |
  cd /project/linglong/sources/linglong-builder-demo
  rm -rf build || true
  mkdir build
  cd build
  qmake ..
  make
  make install

For more details on configuration file fields, please refer to Configuration File Description

Execute the Build Process ​

In the root directory of the Linglong project, execute the build command:

bash
ll-builder build

Run the Application ​

After a successful build, execute the run command in the Linglong project directory. The application can be run directly without installation.

bash
ll-builder run

Export Build Artifacts ​

In the root directory of the Linglong project, execute the export command to check out the build content.

bash
ll-builder export --layer

The directory structure after export is as follows:

text
├── linglong
├── linglong.yaml
├── org.deepin.demo_1.0.0.0_x86_64_binary.layer
└── org.deepin.demo_1.0.0.0_x86_64_develop.layer

More Reference Examples ​

qt5 - qt5 application

dtk5 - dtk5 + qmake

dtk5 - dtk5 + cmake

dtkdeclarative5 - dtk5 + qml

electron - electron + vue example

plantuml - a Java application for drawing flowcharts programmatically

org.sumatrapdfreader - a Wine application, a PDF reader

More Complete Examples ​

Complete Example - a complete example that includes how to build an application, export build content, install, and run.