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 字段用于描述软件包的类别或分组，它为软件包指定一个逻辑上的分类，以帮助用户或开发者更好地理解和管理软件包。

作用概述

1. 分类管理：

   • SECTION 提供了一种方法来对包进行逻辑分类，例如 kernel/userland、utils、networking 等。

2. 易于查找和组织：

   • 分类有助于在显示、搜索或文档化时更直观和有条理。

3. 增加可读性：

   • 使开发者或用户能够快速理解包的用途和领域，便于文档化和沟通。

1.2 SECTION 的用法

• SECTION 字段接受一个字符串值，描述该软件包所属的类别。
• 这个字段没有严格的标准，可以根据项目或公司的实际需求自定义。

示例：

SECTION = "kernel/userland"

在这个例子中，SECTION 表示软件包属于内核相关的用户空间工具。

1.3 如何使用 SECTION 的分类信息

1. 在图形化界面中展示：

   • 一些 Yocto 配套的包管理工具、图形界面或 web 接口会展示 SECTION 的分类，方便开发者和用户快速查找软件包。

2. 生成分类的包列表：

   • 在生成软件包索引时，可以按 SECTION 分类整理这些包，便于管理。

3. 为文档和管理提供便利：

   • 可以使用 SECTION 字段生成文档或报告，以了解项目中各种软件包的用途。

4. 通过 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 来避免碰撞风险。

具体来说，校验和的使用步骤如下：

1. 指定下载文件的校验和类型和值：对于每个需要校验的文件，可以通过类似 SRC_URI[<filename>.sha256sum] 的语法为其指定校验和。
2. 校验和验证过程：在 BitBake 构建时，Yocto 会自动计算下载文件的校验和，并与 .bb 文件中提供的校验和进行比对。
3. 校验失败的处理：如果校验和不匹配，构建过程会立即停止，并报出错误信息。这确保了构建环境的安全性，防止下载的文件被篡改或损坏。

通过合理地使用校验和，可以有效保障构建过程的稳定性和安全性，防止由于恶意篡改或传输错误导致的构建失败或潜在漏洞。