Usage: ll-builder [options] subcommand [sub-option]
Options:
-v, --verbose show detail log
-h, --help Displays help on commandline options.
--help-all Displays help including Qt specific options.
Arguments:
subcommand create
build
run
export
push
创建项目
ll-builder create命令用来创建玲珑项目。
查看 ll-builder create命令的帮助信息:
ll-builder create --help
ll-builder create命令的帮助信息如下:
Usage: ll-builder [options] create
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
Usage: ll-builder [options] build
Options:
-v, --verbose show detail log
-h, --help Displays help on commandline options.
--help-all Displays help including Qt specific options.
--exec run exec than build script
Arguments:
build build project
Usage: ll-builder [options] run
Options:
-v, --verbose show detail log
-h, --help Displays this help.
--exec run exec than build script
Arguments:
run run project
玲珑构建工具ll-builder简介
ll-builder
是为应用开发者提供的一款构建玲珑应用工具。主要功能如下:
查看
ll-builder
命令的帮助信息:ll-builder 命令的帮助信息如下:
创建项目
ll-builder create
命令用来创建玲珑项目。查看
ll-builder create
命令的帮助信息:ll-builder create
命令的帮助信息如下:ll-builder create
命令根据输入的项目名称在当前目录创建对应的文件夹,同时生成构建所需的linglong.yaml
模板文件。示例如下:ll-builder create org.deepin.demo
命令输出如下:编辑linglong.yaml
软件包元信息配置
运行时
依赖项
源码
使用git源码
选择构建模板
源码为qmake工程,填写build 类型为qmake(模板内容见qmake.yaml)。
完整的linglong.yaml配置
linglong.yaml
文件内容如下:构建应用
ll-builder build
命令用来构建玲珑应用。查看
ll-builder build
命令的帮助信息:ll-builder build
命令的帮助信息如下:ll-builder build
命令必须运行在工程的根目录,即linglong.yaml
文件所在位置。以玲珑项目
org.deepin.demo
为例,构建玲珑应用主要步骤如下:进入到
org.deepin.demo
项目工程目录:执行
ll-builder build
命令将开始构建玲珑应用:构建完成后,构建内容将自动提交到本地
ostree
缓存中。导出构建内容见ll-builder export
。使用
--exec
参数可在构建脚本执行前进入玲珑容器:进入容器后,可执行
shell
命令,如gdb
、strace
等。玲珑应用
debug
版本更多调试信息请参考:DEBUG。运行编译后的应用
ll-builder run
命令可以运行编译后的可执行程序。查看
ll-builder run
命令的帮助信息:ll-builder run
命令的帮助信息如下:ll-builder run
命令根据配置文件读取该程序相关的运行环境信息,构造一个容器环境,并在容器中执行该程序而无需安装。ll-builder run
运行成功输出如下:为了便于调试,使用额外的
--exec /bin/bash
参数可替换进入容器后默认执行的程序,如:使用该选项,
ll-builder
创建容器后将进入bash
终端,可在容器内执行其他操作。构建配置文件简介
linglong.yaml
是玲珑项目工程的描述文件,记录构建所需的相关信息。如构建产物的名称、版本、源码地址、构建依赖等。工程目录结构
字段定义
软件包元信息配置
运行时(runtime)
应用运行时依赖,同时也是构建依赖。
可简写为以下形式:
依赖项
描述应用的构建依赖与运行依赖。
ll-builder在项目构建时将从远程存储库拉取dpends下包含的依赖到本地。若远程存储库不存在该依赖或其无法满足要求,
可新增source与build内容, ll-builder将优先构建包含source与build类型的依赖并应用到项目构建中。
源码
描述源码信息。
构建规则
描述构建规则。
变量
描述构建可以使用的变量,配合build构建使用。
完整示例
构建应用
构建依赖库
构建运行时
package 类型为runtime时,将提交所有依赖内容。
构建工具模板
automake类型构建模板
autotools.yaml
提供了通用的automake
类型构建模板, 模板文件如下:使用方法:
qmake构建模板
qmake.yaml
提供了通用的qmake
构建模板, 模板文件如下:使用方法:
cmake构建模板
cmake.yaml
提供了通用的cmake
构建模板, 模板文件如下:使用方法:
runtime 23.0.0 包含依赖项
其他可用依赖
上架应用到商店
主要流程
原文:玲珑-构建工具
其他:
玲珑官网:https://www.linglong.space/
玲珑系列文章——玲珑简介
玲珑系列文章——命令行工具
玲珑系列文章——调试玲珑应用