Yocto 项目 - 元数据语法，可以这样学！

嵌入式Jerry

已于 2024-12-04 12:35:55 修改

阅读量991

点赞数 22

CC 4.0 BY-SA版权

分类专栏： Yocto 文章标签：系统架构 linux 嵌入式硬件物联网服务器

于 2024-12-04 12:35:49 首次发布

本文链接：https://blog.youkuaiyun.com/Interview_TC/article/details/144236556

Yocto 专栏收录该内容

126 篇文章

订阅专栏

在 Yocto 项目中，元数据（Metadata）是构建系统的核心，描述了构建的流程和行为。元数据语法定义了如何通过变量、操作符和条件控制等描述构建任务和依赖。本文严格基于 Yocto 官方文档，重点讲解元数据语法的基础组成，包括变量定义、数据操作符、条件语法等，帮助读者理解元数据语言的规则和应用。

在这里插入图片描述

1. 什么是元数据语法？

元数据语法是 Yocto 项目中描述配方和构建规则的语言，用于定义变量、配置条件和描述任务的依赖。它通过语法规则组织配方文件，控制嵌入式系统的构建过程。

基本组成：

变量：用于存储构建参数。
操作符：修改变量值或控制变量行为。
条件语法：动态调整变量和行为。

在这里插入图片描述

2. 变量的定义与赋值

变量是元数据的核心，用于存储构建所需的各种信息，包括路径、文件名、编译选项等。

2.1 变量定义

变量以键值对的形式定义。语法格式：

变量名 = "值"

示例：

SRC_URI = "https://example.com/source.tar.gz"
WORKDIR = "/path/to/workdir"

2.2 赋值类型

2.2.1 直接赋值 (`=`)

直接为变量设置值，后续赋值会覆盖之前的值。

LICENSE = "MIT"

2.2.2 条件赋值 (`?=`)

当变量未被赋值时生效。

DESCRIPTION ?= "Default description"

2.2.3 追加赋值 (`+=`)

在已有值后追加内容。

SRC_URI += " file://extra.patch"

2.2.4 覆盖赋值 (`:append` 和 `:prepend`)

用于在变量值的末尾或开头追加内容，通常在复杂的配置中使用。

示例：

SRC_URI:append = " file://doc.patch"
SRC_URI:prepend = "file://header.patch "

2.2.5 删除赋值 (`:remove`)

从变量值中移除指定内容。

SRC_URI:remove = "file://unnecessary.patch"

2.3 动态变量引用

通过 ${} 引用其他变量的值，动态生成变量内容。

示例：

SRC_URI = "https://${PN}-${PV}.tar.gz"

${PN}：包名（Package Name）。
${PV}：版本号（Package Version）。

动态引用的优势：

避免硬编码，提高配置的灵活性。
统一变量格式，便于维护。

3. 数据操作符

操作符为变量的组合和修改提供了强大的支持。

3.1 常用操作符

3.1.1 `append` 和 `prepend`

为变量值追加内容，分别在末尾或开头。

FILES:append = "/usr/share/docs"
SRC_URI:prepend = "file://header.patch "

3.1.2 `remove`

从变量中移除不需要的内容。

SRC_URI:remove = "file://deprecated.patch"

3.1.3 条件覆盖

通过 OVERRIDES 实现条件覆盖，例如为不同机器或目标定义不同变量值。

SRC_URI:qemuarm = "file://qemuarm-specific.patch"
SRC_URI:x86 = "file://x86-specific.patch"

3.2 优化配置的操作符组合

将操作符和动态引用结合使用，可以减少冗余定义。

示例：

SRC_URI = "https://${PN}-${PV}.tar.gz"
SRC_URI:append:qemuarm = " file://qemuarm.patch"
SRC_URI:remove:x86 = "file://deprecated.patch"

4. 条件语法

条件语法用于根据目标环境动态调整变量和行为。

4.1 直接条件

为不同的目标或机器定义变量值。

SRC_URI = "default.tar.gz"
SRC_URI:qemuarm = "qemuarm.tar.gz"
SRC_URI:x86 = "x86.tar.gz"

4.2 复杂条件

通过 Python 表达式实现复杂逻辑控制。

python () {
    if d.getVar("TARGET_ARCH") == "arm":
        d.setVar("CFLAGS", "-march=armv7-a")
}

d.getVar("变量名")：获取变量值。
d.setVar("变量名", "值")：设置变量值。

5. 示例：完整的元数据配置

以下是一个简单的配方示例，结合了变量定义、动态引用和操作符。

配方代码：

DESCRIPTION = "Hello World Example"
LICENSE = "MIT"
SRC_URI = "https://example.com/hello-${PV}.tar.gz"
PV = "1.0"

do_compile() {
    ${CC} ${CFLAGS} -o hello hello.c
}

do_install() {
    install -d ${D}${bindir}
    install -m 0755 hello ${D}${bindir}/hello
}

FILES_${PN} = "${bindir}/hello"

配方解析：

变量定义：
- DESCRIPTION：描述配方内容。
- LICENSE：指定许可证类型。
- SRC_URI：动态引用 ${PV} 定义源码路径。
操作符使用：
- 使用 ${} 动态引用变量，简化 URL 定义。
任务逻辑：
- do_compile：编译过程，使用工具链变量 ${CC} 和 ${CFLAGS}。
- do_install：将生成的文件安装到目标路径。