Yocto构建中如何限制仅构建时依赖的GPLv3库不进入最终镜像

你遇到的问题本质是许可白名单作用域配置错误+依赖类型未做区分，按以下步骤配置即可解决：

• 第一步：严格区分构建依赖与目标运行时依赖
  所有仅在构建主机上运行、为编译流程服务的GPLv3工具/库，依赖声明必须使用-native后缀的原生包变体，禁止直接依赖目标架构编译的同名包。例如构建阶段需要调用bison、gperf这类GPLv3工具时，DEPENDS中应写bison-native、gperf-native，而非bison、gperf。原生包仅在构建阶段执行，本身不会被纳入目标镜像打包范围。

  注意：绝对不要把仅构建阶段需要的工具/库写入IMAGE_INSTALL变量，该变量下的所有包都会被强制安装到最终镜像。

• 第二步：限定许可白名单的生效范围
  不要全局配置GPLv3许可白名单，否则所有目标架构的GPLv3包只要被依赖链拉取就会通过许可检查进入镜像。正确的配置是仅对原生构建类的包开放许可例外，参考配置如下：

  # 全局禁止GPLv3许可的目标架构包进入镜像
  INCOMPATIBLE_LICENSE = "GPL-3.0-only GPL-3.0-or-later"
  # 仅对构建主机上运行的native、nativesdk类包放行GPLv3许可
  LICENSE_FLAGS_ACCEPTED:class-native = "GPL-3.0-only GPL-3.0-or-later"
  LICENSE_FLAGS_ACCEPTED:class-nativesdk = "GPL-3.0-only GPL-3.0-or-later"
  

• 第三步：排查误引入镜像的GPLv3包来源
  如果完成以上配置后仍有GPLv3包进入镜像，执行以下命令定位依赖链：

  # 生成指定镜像的全量依赖关系，定位哪个目标包拉取了GPLv3依赖
  bitbake -g <你的目标镜像名称>
  grep <异常GPLv3包名> recipe-depends.dot
  

  找到引入依赖的目标包后，若该包确实仅在构建时需要链接对应GPLv3静态库、运行时无依赖，可在对应recipe中删除运行时依赖声明，或直接在镜像配置中明确排除该包：

  # 强制排除指定包，即使被错误声明依赖也不会被打包进镜像
  PACKAGE_EXCLUDE += "<需要排除的GPLv3目标包名>"
  

• 第四步：最终验证
  构建完成后，检查tmp/deploy/licenses/<目标镜像名>/license.manifest文件，确认清单中不存在GPLv3许可的目标架构包，同时构建流程无许可冲突报错即配置生效。

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