自定义配方中pkg_postinst_ontarget_${PN}无法执行问题排查

核心原因 #

你在foobar-image.bb中定义的pkg_postinst_ontarget_${PN}属于image包本身的postinst脚本，但Yocto的image包postinst逻辑默认仅在构建主机的rootfs处理阶段执行，不会在目标系统启动时自动运行——这就是你找不到marker_file的根本原因。

可行解决方法 #

1. 将脚本绑定到具体软件包（推荐）

把创建标记文件的逻辑放到foobar-tools的配方中，这样该脚本会在软件包安装到目标机时自动执行：
修改foobar-tools.bb，添加：

pkg_postinst_ontarget_${PN} () {
    /bin/touch /home/root/marker_file
}

2. 在image层面添加目标机启动脚本

如果必须在image配方中实现，可通过以下两种方式：

方式一：利用rc.local

在foobar-image.bb中添加构建阶段的rootfs处理命令，生成rc.local脚本：

ROOTFS_POSTPROCESS_COMMAND += "add_marker_rc_local;"

add_marker_rc_local() {
    cat > ${IMAGE_ROOTFS}/etc/rc.d/rc.local <<EOF
#!/bin/sh -e
/bin/touch /home/root/marker_file
exit 0
EOF
    chmod 755 ${IMAGE_ROOTFS}/etc/rc.d/rc.local
}

注意：部分使用systemd的系统需要手动启用rc-local.service才能生效。

方式二：添加systemd一次性服务

创建marker.service文件：

[Unit]
Description=Create marker file

[Service]
Type=oneshot
ExecStart=/bin/touch /home/root/marker_file
RemainAfterExit=yes

[Install]
WantedBy=multi-user.target

编写marker-service.bb配方打包该服务：

SUMMARY = "Marker file creation service"
LICENSE = "MIT"
LIC_FILES_CHKSUM = "file://${COMMON_LICENSE_DIR}/MIT;md5=0835ade698e0bcf8506ecda2f7b4f302"

S = "${WORKDIR}"

FILES_${PN} += " \
    ${systemd_system_unitdir}/marker.service \
"

SYSTEMD_SERVICE_${PN} = "marker.service"

do_install() {
    install -d ${D}${systemd_system_unitdir}
    install -m 0644 ${S}/marker.service ${D}${systemd_system_unitdir}/
}

最后在foobar-image.bb中添加：

IMAGE_INSTALL_append += " marker-service"

Ubuntu22.04主机的潜在影响 #

1. Shell兼容性：Ubuntu22.04默认使用bash 5.1，若你使用的Yocto版本较老（如kirkstone之前），可能存在脚本语法兼容问题——目标机通常使用ash，需确保postinst脚本采用POSIX兼容语法，避免bash特有命令。
2. 依赖缺失排查：虽你确认编译正常，但非验证主机可能缺少Yocto隐性依赖，可通过bitbake -c checkhost <image-name>检查主机依赖是否完整。
3. 日志定位问题：查看构建日志中pkg_postinst相关输出，确认脚本是否被正确生成到rootfs的var/lib/opkg/info目录，或有无执行报错信息。

内容的提问来源于stack exchange，提问作者Daniel