我在理解如何使用 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 的上下文中。我确实提到了一些伪目标和“生成”,但对于我认为应该是一个简单的用例来说,它似乎太复杂了。还提到了“绑定(bind)”机制,但文档提到了 =$(BINDRULE[1])=
这对我来说毫无意义。
我还遇到了别名、NOTFILE
和 explicit
,但我不确定自己是否走在正确的轨道上,并且无法做任何决定性的事情。
是否有关于如何在 bjam 中创建自定义目标的好示例?或者我只是想以非预期的方式使用 bjam?
最佳答案
一个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-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 的构建,请添加 explicit
对于 main_$(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)
如explicit
而没有这样做 install_main_$(project-name)
,或声明$(project-name).o
如explicit
而没有这样做 main_$(project-name)
没有意义,就好像请求构建一个目标一样,它的所有依赖项目标也将被请求构建,即使这些依赖项是 explicit
.
关于boost - 了解 bjam 的目标以及如何指定新目标?,我们在Stack Overflow上找到一个类似的问题: https://stackoverflow.com/questions/12379497/