Bitbake配方函数内无法访问FILES变量问题解决方案咨询

Bitbake运行分两个完全隔离的阶段，跨阶段传值的写法天生不生效：

• 配置解析阶段：Bitbake启动后优先解析所有配方、类文件、全局配置，FILES_${PN}这类写在任务函数外的变量，会在这个阶段完成求值展开。此时fetch、unpack、install等任务均未执行，动态生成的文件列表还不存在。
• 任务执行阶段：所有do_xxx开头的shell任务，都在Bitbake fork出的独立shell子进程中运行，进程内的变量修改、环境变量导出仅在当前子进程生效，无法回传到Bitbake主进程的全局变量存储。任务外的FILES_${PN} += $FILENAMES语句在解析阶段就已经执行完毕，等后续任务导出FILENAMES时，解析流程早已结束，根本读不到对应值。

方案1：Python任务动态注入变量（通用推荐，适配所有场景） #

通过Bitbake内置的Python任务接口，直接操作Bitbake全局数据存储对象d修改FILES_${PN}，把任务插在do_install完成后、do_package启动前的执行节点上，完全绕开跨进程传环境变量的问题。
示例配方代码：

# 自定义数据文件在目标系统的安装目录
MY_DATA_DEPLOY_PATH := "${datadir}/my-generic-data"

do_install() {
    install -d ${D}${MY_DATA_DEPLOY_PATH}
    # 原有文件拷贝逻辑，把unpack得到的所有数据文件拷入目标目录即可
    cp -r ${WORKDIR}/your-data-src/* ${D}${MY_DATA_DEPLOY_PATH}/
}

python do_update_pkg_files() {
    import os
    # 从全局变量存储读取需要的路径
    dest_root = d.getVar('D')
    install_rel_path = d.getVar('MY_DATA_DEPLOY_PATH').lstrip('/')
    full_install_dir = os.path.join(dest_root, install_rel_path)
    pn = d.getVar('PN')

    collected_files = []
    # 递归扫描安装目录下的所有文件
    for root, _, files in os.walk(full_install_dir):
        for single_file in files:
            file_abs_in_d = os.path.join(root, single_file)
            # 转换为目标系统的绝对路径（去掉D目录前缀）
            file_target_path = os.path.join('/', os.path.relpath(file_abs_in_d, dest_root))
            collected_files.append(file_target_path)

    # 将扫描得到的文件列表追加到主包的FILES变量
    origin_files = d.getVar(f'FILES_{pn}') or ''
    d.setVar(f'FILES_{pn}', f'{origin_files} {" ".join(collected_files)}')
}

# 配置任务执行顺序：安装完成后立刻更新文件列表，再执行打包相关任务
addtask do_update_pkg_files after do_install before do_package do_populate_sysroot

注意要点：

• 只有Python任务可以通过d对象直接修改Bitbake全局变量，shell任务没有这个权限。
• 写入FILES_${PN}的路径必须是目标系统的绝对路径，不能带构建临时目录${D}的前缀，否则打包阶段会找不到文件。
• 任务顺序不能错，必须保证do_package读取FILES变量前完成列表更新，否则会报"installed but not shipped"的错误。

方案2：通配符匹配（简单场景适用） #

如果所有数据文件都部署在独立的专属目录下，不需要拆分到其他分包，直接在FILES_${PN}中用通配符匹配即可，不需要写动态扫描逻辑：

# 单层目录匹配
FILES_${PN} += "${datadir}/my-generic-data/*"
# 递归匹配所有子目录文件（Bitbake 3.2+版本支持）
FILES_${PN} += "${datadir}/my-generic-data/**"

这个方案实现成本最低，缺点是通配符会把匹配到的所有文件全部打入主包，不适合需要拆分debug包、dev包的场景。

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