Yocto项目实战教程-第7章定制镜像菜谱与内核菜谱-7.2小节-定制应用程序

🔍

B站相应的视频教程：
📌 Yocto项目实战教程-第7章-定制镜像菜谱与内核菜谱
记得三连，标为原始粉丝,感谢大神支持。

---

---

在嵌入式Linux系统开发中，定制专属应用程序往往是最贴近产品交付的那一环。而Yocto项目，作为构建嵌入式系统的强大工具，其灵活的菜谱机制为我们集成和部署定制应用提供了完美的方案。

本文将围绕一个实际项目——“智能传感器网关”系统，全面讲解如何在Yocto中完成自定义应用的集成、构建与部署。内容涵盖从源代码组织、菜谱编写、依赖管理到最终镜像生成的全过程，帮助你快速掌握Yocto应用集成的关键技术。

---

一、项目背景：智能传感器网关

本次实践项目是一个用于边缘计算的“智能传感器网关”，功能包括：

• 读取多个传感器数据（如温湿度、PM2.5）
• 本地实时展示数据（基于Qt GUI）
• 周期性上传数据到云平台（HTTP + JSON）
• 远程升级机制（预留）

该应用分为两部分：

1. 后台服务（sensor-agent）：C++编写，周期读取传感器数据并写入本地数据库
2. 前端界面（sensor-ui）：使用Qt 5编写，实时展示当前环境状态

我们希望将这两部分完整集成进Yocto系统中，构建成一个独立镜像运行于目标设备（例如 NXP i.MX8MP EVK）上。

---

二、准备阶段：代码组织与目录布局

在正式创建菜谱前，我们需要规范整理源代码，方便Yocto集成。

sensor-gateway/
├── sensor-agent/
│   ├── src/
│   ├── include/
│   ├── CMakeLists.txt
│   └── ...
├── sensor-ui/
│   ├── ui/
│   ├── qml/
│   ├── main.cpp
│   ├── CMakeLists.txt
│   └── ...
├── README.md
└── LICENSE

小贴士：建议每个子模块都能独立编译，具备自身的CMake或Makefile。

---

三、编写应用菜谱（Recipes）

我们创建一个新的元数据层（layer）meta-sensor用于管理应用相关内容。

1. 创建meta层

yocto$ cd poky
yocto/poky$ yocto-layer create meta-sensor

将 sensor-gateway 源码复制进 meta-sensor/recipes-sensor/files/：

meta-sensor/
└── recipes-sensor/
    ├── sensor-agent/
    │   ├── sensor-agent.bb
    │   └── files/
    │       └── sensor-agent/  ← 源码目录
    └── sensor-ui/
        ├── sensor-ui.bb
        └── files/
            └── sensor-ui/     ← 源码目录

---

四、sensor-agent.bb 说明（后台服务）

SUMMARY = "Sensor Data Agent"
DESCRIPTION = "Collects data from sensors and writes to local database"
LICENSE = "MIT"
LIC_FILES_CHKSUM = "file://LICENSE;md5=xxxxxxxxxxxx"

SRC_URI = "file://sensor-agent"

S = "${WORKDIR}/sensor-agent"

inherit cmake

DEPENDS += "sqlite3"

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

关键点说明：

• inherit cmake：使用CMake进行构建
• SRC_URI：引用本地文件夹
• DEPENDS：声明依赖（如 sqlite3）
• do_install()：定义安装路径

---

五、sensor-ui.bb 说明（图形界面）

SUMMARY = "Qt-based Sensor Display UI"
DESCRIPTION = "Qt GUI for live sensor data monitoring"
LICENSE = "MIT"
LIC_FILES_CHKSUM = "file://LICENSE;md5=xxxxxxxxxxxx"

SRC_URI = "file://sensor-ui"

S = "${WORKDIR}/sensor-ui"

inherit cmake qt5

DEPENDS += "qtbase qtdeclarative qtquickcontrols2"

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

特别说明：

• inherit qt5 启用Qt 5支持
• 依赖项中包含qtdeclarative、qtquickcontrols2等模块
• UI层建议打包为 .bbappend 的形式以支持升级或替换

---

六、添加到镜像中

要使我们的应用被包含进系统镜像中，需要将其加入镜像菜谱（image recipe）：

IMAGE_INSTALL:append = " sensor-agent sensor-ui"

可以在自定义镜像文件中添加，例如：

meta-sensor/recipes-core/images/sensor-gateway-image.bb

内容如下：

DESCRIPTION = "Sensor Gateway Image"
LICENSE = "MIT"

inherit core-image

IMAGE_INSTALL += " sensor-agent sensor-ui"

构建镜像：

bitbake sensor-gateway-image

---

七、应用部署测试

镜像构建完成后，将其烧录到SD卡或EMMC，启动系统后可以通过以下方式确认应用是否运行：

# 查看sensor-agent是否在运行
ps -ef | grep sensor-agent

# 启动GUI（若未设置自启动）
/usr/bin/sensor-ui

建议在实际项目中，配置systemd服务以实现后台服务和图形界面的自启动：

# sensor-agent.service
[Unit]
Description=Sensor Agent Service
After=network.target

[Service]
ExecStart=/usr/bin/sensor-agent
Restart=always

[Install]
WantedBy=multi-user.target

将此服务文件放入：

meta-sensor/recipes-sensor/sensor-agent/files/sensor-agent.service

并在 .bb 文件中添加：

SYSTEMD_SERVICE:${PN} = "sensor-agent.service"
inherit systemd

---

八、常见问题与建议

问题描述	原因分析	建议解决
编译失败提示找不到Qt模块	没有声明 DEPENDS	在 .bb 中添加完整Qt模块依赖
程序安装后无执行权限	安装时权限设置错误	确保 install -m 0755
应用未包含在镜像中	IMAGE_INSTALL 未配置	检查镜像菜谱是否已添加应用名
systemd未启动程序	service未install	添加 WantedBy=multi-user.target 并启用服务

---

九、总结与回顾

本文围绕“智能传感器网关”项目，从源代码组织到Yocto集成的全过程，系统讲解了定制应用的完整流程：

• 如何创建新layer与recipe
• 如何组织源码并适配bitbake规则
• 如何处理依赖与部署路径
• 如何通过systemd服务实现应用启动

Yocto的强大之处在于其模块化、可重用的构建系统。理解菜谱机制和构建流程，是掌握Yocto的关键第一步。希望这篇博文为你在实际项目中部署定制应用提供有力指导。

🔍

B站相应的视频教程：
📌 Yocto项目实战教程-第7章-定制镜像菜谱与内核菜谱
记得三连，标为原始粉丝,感谢大神支持。

---