Appearance

Return to top
On this page

TIP

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


Create linyaps project

Use ll-builder create to create a linyaps project.

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

bash
ll-builder create --help

Here is the output:

text
Create linyaps build template project
Usage: ll-builder create [OPTIONS] NAME

Positionals:
  NAME TEXT REQUIRED          Project name

Options:
  -h,--help                   Print this help message and exit
  --help-all                  Expand all help

The ll-builder create command creates a folder in the current directory according to the project name, and generates the linglong.yaml template file required for the build. Here is an example:

bash
ll-builder create org.deepin.demo

Here is the output:

text
org.deepin.demo/
└── linglong.yaml

Edit linglong.yaml

The syntax version of the linglong.yaml file.

yaml
version: "1"

App meta info

yaml
package:
  id: org.deepin.demo
  name: hello
  version: 0.0.0.1
  kind: app
  description: |
    simple Qt demo.

Base

The minimum root filesystem.

yaml
base: org.deepin.base/23.1.0

Runtime

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

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

Command

linyaps application startup command.

yaml
command: [echo, -e, hello world]

Source

Use git source code

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

Build

The commands required to build the project.

yaml
build: |
  cd /project/linglong/sources/linglong-builder-demo.git
  qmake demo.pro
  make -j${JOBS}
  make install

Completed linglong.yaml config

The contents of the linglong.yaml file are as follows:

yaml
version: "1"

package:
  id: @ID@
  name: your name #set your application name
  version: 0.0.0.1 #set your version
  kind: app
  description: |
    your description #set a brief text to introduce your application.

command: [echo, -e, hello world] #the commands that your application need to run.

base: org.deepin.base/23.1.0 #set the base environment, this can be changed.

#set the runtime environment if you need, a example of setting deepin runtime is as follows.
#runtime:
#runtime: org.deepin.runtime.dtk/23.1.0

#set the source if you need, a simple example of git is as follows.
#sources:
#  - kind: git
#    url: https://github.com/linuxdeepin/linglong-builder-demo.git
#    version: master\n
#    commit: a3b89c3aa34c1aff8d7f823f0f4a87d5da8d4dc0

build: |
  echo 'hello' #some operation to build this project