c++ - 无法在 C++ 项目中从 Meson 运行 Doxygen

Question

我无法通过 Meson 的配置运行 Doxygen。

这是中的相关代码meson.build：

doxygen = find_program('doxygen')
...
run_target('docs', command : 'doxygen ' + meson.source_root() + '/Doxyfile')

成功找到 doxygen 可执行文件：

找到程序 doxygen: YES (/usr/bin/doxygen)

但是，启动时，我收到以下错误消息：

[0/1] 运行外部命令文档。
无法执行命令“doxygen /home/project/Doxyfile”。文件未找到。
失败：介子文档

从命令行手动运行它可以工作：

/usr/bin/doxygen /home/project/Doxyfile
doxygen /home/project/Doxyfile

我的meson.build配置有什么问题？

Answer 1

根据参考手册，

command是一个列表，其中包含要运行的命令和要传递给它的参数。每个列表项可以是字符串或目标

因此，在您的情况下，介子将整个字符串视为命令，即工具名称，而不是命令+参数。所以，试试这个：

run_target('docs', command : ['doxygen', meson.source_root() + '/Doxyfile'])

或者直接使用find_program()的结果可能会更好：

doxygen = find_program('doxygen', required : false)
if doxygen.found()
  message('Doxygen found')
  run_target('docs', command : [doxygen, meson.source_root() + '/Doxyfile'])    
else
  warning('Documentation disabled without doxygen')
endif

请注意，如果您想在 Doxyfile.in 的支持下改进文档生成，请查看custom_target()和类似这样的示例。