了解 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>. ;

请注意，如果您在 jamfile 中多次调用 build-main，则每次 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-copy 规则被调用时，它实际上并没有构建任何东西，它只是声明了一些目标。实际构建的内容是在稍后阶段决定的，该决定取决于 bjam 调用参数。

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

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

explicit install_main_$(project-name) ;

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

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

或全部：

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

请注意，将main_$(project-name) 声明为explicit 而对install_main_$(project-name) 不这样做，或者将$(project-name).o 声明为explicit 而对main_$(project-name) 不这样做是没有意义的，好像目标是请求构建，它的所有依赖目标也将被请求构建，即使这些依赖是explicit。