了解bjam的目标,以及如何指定新的目标？

Question

我在理解如何使用bjam指定和调用目标时遇到问题.通过这个,我的意思是我想为bjam提供命令行目标来构建(实际上来自Makefile),这些目标对应于构建过程的不同方面,而不仅仅是运行整个事物.

例如,现在当我键入'bjam'时,它会关闭并构建一个python扩展,运行一个单元测试文件,并创建一个单独的'main'可执行文件.我有自定义规则执行每一步,我的Jamfile只是按顺序列出它们:

project-name = example ;

sources =
  $(project-name).cpp
  $(project-name)_ext.cpp
  ;

build-ext $(project-name) : $(sources) ;

build-main $(project-name) ;

在我的Jamroot(上一个目录)中我定义了这些规则,这里是不完整的文件:

# A rule to simplify declaration of extension tests:
rule run-test ( test-name : sources + )
{
    import testing ;
    testing.make-test run-pyd : $(sources) : : $(test-name) ;
}

# A rule to further simply declaration of extension tests:
rule run-ext-test ( project-name )
{
  run-test $(project-name) : $(project-name)_ext test_$(project-name)_ext.py ;
}

# A rule to simplify copying of the extension and Boost.Python libraries to the current directory
rule convenient-copy ( project-name )
{
  install convenient_copy
    : $(project-name)_ext
    : <install-dependencies>on <install-type>SHARED_LIB <install-type>PYTHON_EXTENSION
      <location>.
    ;
}

rule build-ext ( project-name : sources + )
{
  python-extension $(project-name)_ext : $(sources) : ;

  # copy the extension and Boost.Python libraries to the current directory
  convenient-copy $(project-name) ;

  # run extension tests
  run-ext-test $(project-name) ;
}

rule build-main ( project-name : other-sources * )
{
  obj $(project-name).o : $(project-name).cpp ;
  exe main_$(project-name) : main_$(project-name).cpp $(project-name).o $(other-sources) ;
  install main : main_$(project-name) : <location>. ;
}

但是我注意到以下对bjam的调用没有做我希望他们做的事情:

$ bjam build-main
notice: could not find main target build-main
notice: assuming it is a name of file to create.
don't know how to make <e>build-main
...found 1 target...
...can't find 1 target...

$ bjam main_example
...patience...
...patience...
...found 1597 targets...
...updating 3 targets...
gcc.compile.c++ bin/gcc-4.6/debug/main_example.o
gcc.compile.c++ bin/gcc-4.6/debug/example.o
gcc.link bin/gcc-4.6/debug/main_example
...updated 3 targets...

^^^但是没有运行安装规则,所以二进制文件没有复制到Jamfile目录.

奇怪的是,有些目标可以做事,但并不总是我所期望的:

$ bjam main
...patience...
...patience...
...found 1598 targets...
...updating 3 targets...
gcc.compile.c++ bin/gcc-4.6/debug/main_example.o
gcc.compile.c++ bin/gcc-4.6/debug/example.o
gcc.link main_example
...updated 3 targets...

这确实在Jamfile目录中创建了二进制文件.

main目标来自哪里？我没有定义它......

另一个奇怪的:

$ bjam example_ext
...patience...
...patience...
...found 2834 targets...
...updating 3 targets...
gcc.compile.c++ bin/gcc-4.6/debug/example.o
gcc.compile.c++ bin/gcc-4.6/debug/example_ext.o
gcc.link.dll bin/gcc-4.6/debug/example_ext.so
...updated 3 targets...

^^^创建了example_ext.so,但没有将其复制到Jamfile位置.

$ bjam example_ext.so
notice: could not find main target example_ext.so
notice: assuming it is a name of file to create.
...patience...
...patience...
...found 2836 targets...
...updating 4 targets...
gcc.compile.c++ bin/gcc-4.6/debug/example.o
gcc.compile.c++ bin/gcc-4.6/debug/example_ext.o
gcc.link.dll bin/gcc-4.6/debug/example_ext.so
common.copy example_ext.so
...updated 4 targets...

^^^创建了.so文件并将其复制,但没有调用方便复制来引入libboost_python.so文件.

我真的不明白这里发生了什么.bjam文档确实给我带来了严重的问题.它详细描述了目标,但是在规则的上下文中,而不是在从命令行调用bjam的上下文中.我确实遇到过一些关于伪目标和'生成'的提及,但它似乎太复杂了,我觉得应该是一个简单的用例.还提到了一种"绑定"机制,但文档中提到了=$(BINDRULE[1])=对我没有意义的内容.

我也遇到了别名,NOTFILE而explicit但我不知道如果我是正确的轨道上,而无法做任何定论.

有没有关于如何在bjam中创建自定义目标的好例子？或者我只是试图以非预期的方式使用bjam？

Answer 1

bjam不带参数的调用会构建所有内容，因为您没有任何目标标记为explicit，除非明确请求，否则可用于阻止某些目标构建。

bjam build-main失败，因为build-main不是要生成的目标或文件的名称；它是可以使用不同参数调用的规则（函数）的名称，每个调用声明不同的目标集。

bjam main_example 使声明为的目标：

exe main_$(project-name) : main_$(project-name).cpp $(project-name).o $(other-sources) ;

这自然不包含install它的目标，在下一行声明。

bjam main构建main_example并安装它，因为main是其install目标的名称，声明为：install main : main_$(project-name) : <location>. ;

请注意，如果您build-main在 jamfile 中多次调用，每次 bjam 调用都会以 退出error: No best alternative for ./main，因此最好将安装目标的名称重命名为类似install_main_$(project-name)名称以防止名称冲突。然后bjam install_main_example将构建和安装main_example.

bjam example_ext 使声明为的目标：

python-extension $(project-name)_ext : $(sources) : ;

并且没有像bjam main_example.

bjam example_ext.so工作原理example_ext.so的确正在创建的（当然，在给定的平台下）的文件名，这样的结果在一个名为文件中的所有目标，example_ext.so将通过调用生成。这就是为什么不是所有convenient-copy指示安装的文件都通过bjam example_ext.so调用安装的原因。在这里我想澄清一些事情：“没有调用方便复制”不是一个准确的术语。convenient-copy是规则的名称，而不是目标，并且使用上面编写的代码，无论 bjam 调用参数如何，都将始终调用该规则。它在调用时所做的只是声明一个名为convenient_copy（注意下划线）的目标，这反过来导致（隐式）声明一些文件目标（用于安装），例如 example_ext.so、libboost_python.so 和其他匹配的依赖项<install-type>SHARED_LIB <install-type>PYTHON_EXTENSION. 当convenient-copyrule 被调用时，它实际上并没有构建任何东西，它只是声明了一些目标。实际构建的内容是在稍后阶段决定的，该决定取决于 bjam 调用参数。

bjam convenient_copy将构建 example_ext.so 并将其与其依赖项一起正确安装，但它遇到与maininstall target相同的问题：如果convenient-copy多次调用它会中断。将名称从convenient_copyto更改install_$(project-name)_ext将解决问题，然后您将使用bjam install_example_ext.

最后，如果您希望目标不建立在没有参数的 bjam 调用上，则将该目标标记为显式，例如

explicit install_main_$(project-name) ;

除非明确要求，否则将禁止 main_example 的安装。为了防止 main_example 的构建，还添加explicitformain_$(project-name)和$(project-name).o：

explicit main_$(project-name) ;
explicit $(project-name).o ;

或一起：

explicit install_main_$(project-name) main_$(project-name) $(project-name).o ;

请注意，声明main_$(project-name)as explicitwhile not do so for install_main_$(project-name)，或声明$(project-name).oas explicitwhile not do so formain_$(project-name)没有意义，就好像请求构建目标一样，也将请求构建其所有依赖项目标，即使这些依赖项是explicit.