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

🔍

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

在这里插入图片描述

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

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

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

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

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

该应用分为两部分：

后台服务（sensor-agent）：C++编写，周期读取传感器数据并写入本地数据库
前端界面（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 cmakeDEPENDS += "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 qt5DEPENDS += "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-imageIMAGE_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` 并启用服务