Manifests

linglong.yaml is the description file of a Linglong project, which stores the relevant information required for building. Such as the name, version, source address, build dependencies, etc., of the build product.

Project directory structure

{project-root}
├── linglong.yaml
└── linglong

{user-home}
└── .cache
    └── linglong-builder
        ├── repo
        └── layers

Field definitions

App meta info

package:
  id: org.deepin.calculator
  name: deepin-calculator
  version: 5.7.21.0
  kind: app
  description: |
    calculator for deepin os.

name	description
description	Detailed description of the build product
id	Unique name of the build product
kind	The type of build product: app, runtime, representing Application and Runtime
version	version of the build product, require a four-digit number.

Base

The minimum root filesystem.

name	description
id	Unique name of the base
version	Base version, A three-digit number can be loosely matched with a potential fourth digit

Runtime

Describes the build and run dependencies of the application.

runtime: org.deepin.Runtime/23.0.1

name	description
id	Unique name of the runtime
version	Runtime version, A three-digit number can be loosely matched with a potential fourth digit

Source

Describes the source information.

source:
  kind: git
  url: https://github.com/linuxdeepin/deepin-calculator.git
  version: master
  commit: d7e207b4a71bbd97f7d818de5044228c1a6e2c92
  patch:
    - patches/fix-install-prefix-path.patch
    - patches/fix-lib-install-path.patch

name	description
kind	Source code type, optional types local, archive, git
url	Source address, fill in when the type is archive or git
version	Source branch version, fill in when the type is git
digest	The Hash value of archive file encrypted using sha256 algorithm, fill in when the type is git
commit	The hash value of a source code commit, fill in when the type is git
patch	Source patch path

Build rules

Describes the build rules.

build: |
  qmake -makefile PREFIX=${PREFIX} LIB_INSTALL_DIR=${PREFIX}/lib/${TRIPLET}
  make
  make install

name	description
build	build rules at build time

Variables

Describes the variables that can be used by the build.

name	description
PREFIX	One of the environment variables, which can be used under the variable and build fields; provide the installation path when buildingTRIPLET, such as /opt/apps/org.deepin.calculator
TRIPLET	One of the environment variables, which can be used under the variable and build fields; provide a triple containing architecture information, such as x86_64-linux-gnu

Complete example

Build Root FileSystem

git clone git@github.com:linglongdev/org.deepin.foundation.git
cd org.deepin.foundation
bash build_base.sh eagle amd64

该项目用来构建玲珑使用的根文件系统。eagle 指发行版代号，amd64 指架构。

Distribution version	Arch
eagle (uos 20)	amd64、arm64、loongarch64
beige (deepin 23)	amd64、arm64

Build runtime

git clone git@github.com:linglongdev/org.deepin.Runtime.git -b v23
cd org.deepin.Runtime
./depend-deb-list.sh | ./tools/download_deb_depend.bash
ll-builder build --skip-fetch-source

On the basis of the rootfs, add fundamental environments such as Qt.

Build app

calculator

version: "1"

package:
  id: org.deepin.calculator
  name: deepin-calculator
  version: 5.7.21.0
  kind: app
  description: |
    calculator for deepin os.

command:
  - /opt/apps/org.deepin.demo/files/bin/deepin-calculator

base: org.deepin.foundation/23.0.0
runtime: org.deepin.Runtime/23.0.1

sources:
  - kind: git
    url: https://github.com/linuxdeepin/deepin-calculator.git
    version: master
    commit: d7e207b4a71bbd97f7d818de5044228c1a6e2c92

  - kind: git
    url: https://github.com/linuxdeepin/dde-qt-dbus-factory.git
    version: master

build: |
  # build dde-qt-dbus-factory
  cd /project/linglong/sources/dde-qt-dbus-factory.git
  qmake -makefile \
        PREFIX=${PREFIX} \
        LIB_INSTALL_DIR=${PREFIX}/lib/${TRIPLET} \
        INSTALL_ROOT=${PREFIX}

  make
  make install

  # build calculator
  cd /project/linglong/sources/deepin-calculator.git
  cmake -Bbuild \
        -DCMAKE_INSTALL_PREFIX=${PREFIX} \
        -DCMAKE_INSTALL_LIBDIR=${PREFIX}/lib/${TRIPLET}
        -DCMAKE_BUILD_TYPE=Release \
        -DCMAKE_SAFETYTEST_ARG="CMAKE_SAFETYTEST_ARG_OFF" \
        -DAPP_VERSION=5.7.21 \
        -DVERSION=5.7.21

  cmake --build build
  cmake --build build --target install