Manifests

linglong.yaml is the description file of a linyaps 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.dtk/23.1.0

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 and retrieve it in the 'linglong/sources' directory of the same level path as linglong.yaml.

The kind is Git

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

name	description
kind	git, Download using the Git tool
url	Source address, fill in when the type is archive or git
version	Source repository branches
commit	The hash value of a source code commit, fill in when the type is git

The kind is file

sources:
  kind: file
  url: https://github.com/linuxdeepin/deepin-calculator/archive/refs/tags/6.5.4.tar.gz
  digest: 9675e27395891da9d9ee0a6094841410e344027fd81265ab75f83704174bb3a8

name	description
kind	git, Download file
url	File download address
digest	The hash value of the file is encrypted using the sha256 algorithm

The kind is archive

sources:
  kind: archive
  url: https://github.com/linuxdeepin/deepin-calculator/archive/refs/tags/6.5.4.tar.gz
  digest: 9675e27395891da9d9ee0a6094841410e344027fd81265ab75f83704174bb3a8

name	description
kind	archive, Download the compressed file tar.tz and it will automatically decompress
url	File download address
digest	The hash value of the file is encrypted using the sha256 algorithm

The kind is dsc

sources:
  kind: dsc
  url: https://cdn-community-packages.deepin.com/deepin/beige/pool/main/d/deepin-calculator/deepin-calculator_6.0.1.dsc
  digest: ce47ed04a427a887a52e3cc098534bba53188ee0f38f59713f4f176374ea2141

name	description
kind	dsc, Source code package description file
url	File download address
digest	The hash value of the file is encrypted using the sha256 algorithm

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

The project is designed to construct the root filesystem utilized by linyaps, with "eagle" referring to the codename of the distribution and "amd64" indicating the architecture.

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.calculator/files/bin/deepin-calculator

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

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
    commit: d952e1913172c5507af080f644a654f9ba5fed95

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