Yocto .bb 文件字段解析
本文详细讲解了 Yocto .bb 文件中各字段的作用和用法，包括 SECTION、SRC_URI、SUMMARY 等，旨在帮助开发者更好地理解和使用 Yocto 构建系统。
目录
- 1. SECTION 字段
- 1.1 SECTION 的作用
- 1.2 SECTION 的用法
- 1.3 如何使用 SECTION 的分类信息
- 1.4 使用示例
- 1.5 注意事项
- 2. SRC_URI 字段
- 2.1 SRC_URI 的作用
- 2.2 下载多个文件的情况
- 2.3 校验和的使用
1. SECTION 字段
1.1 SECTION 的作用
在 Yocto 的 .bb 文件中，SECTION 字段用于描述软件包的类别或分组，它为软件包指定一个逻辑上的分类，以帮助用户或开发者更好地理解和管理软件包。
作用概述
-
分类管理：
SECTION提供了一种方法来对包进行逻辑分类，例如kernel/userland、utils、networking等。
-
易于查找和组织：
- 分类有助于在显示、搜索或文档化时更直观和有条理。
-
增加可读性：
- 使开发者或用户能够快速理解包的用途和领域，便于文档化和沟通。
1.2 SECTION 的用法
SECTION字段接受一个字符串值，描述该软件包所属的类别。- 这个字段没有严格的标准，可以根据项目或公司的实际需求自定义。
示例：
SECTION = "kernel/userland"
在这个例子中，SECTION 表示软件包属于内核相关的用户空间工具。
1.3 如何使用 SECTION 的分类信息
-
在图形化界面中展示：
- 一些 Yocto 配套的包管理工具、图形界面或 web 接口会展示
SECTION的分类，方便开发者和用户快速查找软件包。
- 一些 Yocto 配套的包管理工具、图形界面或 web 接口会展示
-
生成分类的包列表：
- 在生成软件包索引时，可以按
SECTION分类整理这些包，便于管理。
- 在生成软件包索引时，可以按
-
为文档和管理提供便利：
- 可以使用
SECTION字段生成文档或报告，以了解项目中各种软件包的用途。
- 可以使用
-
通过 BitBake 查询分类：
- 使用
bitbake -s命令可以查看软件包的基本信息，包括SECTION字段。
- 使用
1.4 使用示例
以下是两个软件包的示例：
SUMMARY = "Network packet analysis tool"
DESCRIPTION = "Tool for capturing and analyzing network packets"
SECTION = "networking"
LICENSE = "GPLv2"
SRC_URI = "https://example.com/network-analyzer.tar.gz"
SUMMARY = "Audio processing library"
DESCRIPTION = "Library for audio signal processing"
SECTION = "multimedia"
LICENSE = "LGPLv2.1"
SRC_URI = "https://example.com/audio-lib.tar.gz"
通过设置这些 SECTION 值，软件包可以被划分到不同的类别，如网络工具 (networking) 和多媒体库 (multimedia)。
1.5 注意事项
- 自定义分类：
SECTION的值可以根据项目或公司的需求自定义，建议使用简洁、有意义的描述。 - 不影响构建过程：
SECTION仅作为文档信息和分类用途，不会影响软件包的实际构建或打包过程。
2. SRC_URI 字段
2.1 SRC_URI 的作用
SRC_URI 字段用于定义构建软件包所需的源代码和资源的位置，可以包括源码包、补丁和配置文件等。
例如：
SRC_URI = "${KERNELORG_MIRROR}/linux/utils/kernel/kexec/kexec-tools-${PV}.tar.gz \
file://kdump \
file://kdump.conf \
file://kdump.service \
file://0001-powerpc-change-the-memory-size-limit.patch"
2.2 下载多个文件的情况
在 SRC_URI 中可以定义多个需要下载的文件，每个文件都需要校验和来验证完整性。
示例：
SRC_URI = "https://example.com/file1.tar.gz \
https://example.com/file2.tar.gz \
file://local_patch.patch"
SRC_URI[file1.tar.gz.sha256sum] = "d3b07384d113edec49eaa6238ad5ff00"
SRC_URI[file2.tar.gz.sha256sum] = "8ad8757baa8564dc136c1e07507f4a98"
SRC_URI[file1.tar.gz.sha256sum]和SRC_URI[file2.tar.gz.sha256sum]分别为file1.tar.gz和file2.tar.gz指定了校验和。- 这种方式确保每个远程下载的文件都能被验证其完整性，防止文件在下载过程中被篡改。
2.3 校验和的使用
SRC_URI[sha256sum] 是用来校验源代码包的完整性，确保下载的文件未被篡改。
在以下示例中：
SRC_URI = "${KERNELORG_MIRROR}/linux/utils/kernel/kexec/kexec-tools-${PV}.tar.gz"
SRC_URI[sha256sum] = "b3d4cfd2ba10d68ce341ea3b8ca414d00a0b6183b95686172154f94bce834f94"
SRC_URI[sha256sum] 的值用于校验 kexec-tools-${PV}.tar.gz 文件的完整性。如果下载的文件的校验和与这里提供的值不匹配，构建过程会中止并报告错误。
对于多个远程文件，每个文件需要单独指定校验和，以确保安全性和可靠性。Yocto 支持多种校验和方式，如 md5sum 和 sha256sum，常见的做法是使用更安全的 sha256sum 来避免碰撞风险。
具体来说，校验和的使用步骤如下：
- 指定下载文件的校验和类型和值：对于每个需要校验的文件，可以通过类似
SRC_URI[<filename>.sha256sum]的语法为其指定校验和。 - 校验和验证过程：在 BitBake 构建时，Yocto 会自动计算下载文件的校验和，并与
.bb文件中提供的校验和进行比对。 - 校验失败的处理：如果校验和不匹配，构建过程会立即停止，并报出错误信息。这确保了构建环境的安全性，防止下载的文件被篡改或损坏。
通过合理地使用校验和，可以有效保障构建过程的稳定性和安全性，防止由于恶意篡改或传输错误导致的构建失败或潜在漏洞。
