Appearance

Return to top
On this page

TIP

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


Create Linglong project

Use ll-builder create to create a Linglong project.

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

bash
ll-builder create --help

Here is the output:

text
Usage: ll-builder [options] create <org.deepin.demo>

Options:
  -v, --verbose show detail log
  -h, --help Displays help on commandline options.
  --help-all Displays help including Qt specific options.

Arguments:
  create create build template project
  name project name

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.hello

Here is the output:

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

Edit linglong.yaml

The syntax version of the linglong.yaml file.

yaml
version: "1"

App meta info

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

Base

The minimum root filesystem.

yaml
base: org.deepin.foundation/23.0.0

Runtime

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

yaml
runtime: org.deepin.Runtime/23.0.1

Command

Linglong 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.foundation/23.0.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:
#org.deepin.Runtime/23.0.1

#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