B jam usage document

简介：
Bjam 全面应用文档B jam 具备强大的编译能力，在某些方面超越了 makefile 的便利性与直观性。本文件将深入探讨 B jam 的核心功能及其基本操作原理。Bjam 的入门知识Bjam 是专为 Boost 库设计的 make 工具, 因此其功能极为强大. 该工具的基础知识可在 Jam 使用说明书中找到, 同时也可参考 Bjam 简明教程. 如有在本文中出现任何疑惑, 建议查阅官方文档《Boost.Build v2 官方文档导读》获取解答. Jamroot 系统该 Bjam 工程始于 Jamroot 文件；每个解决方案仅包含一个 Jamroot 文件（类似于 VC 的 Solution 文件 *.sln）。当编译某项目时，Bjam 自动搜索相关 Jamroot 文件；若当前目录中无此文件，则向上检查父目录；若父目录中亦无，则继续向上搜索直至找到。配置信息存储于 Jamroot 中，并将影响所有相关项目。 该 B jam 工程始于 J am root 文件；每个 解决方案仅 包含一 个 J am root 文件 （类似于 VC 的 S olution 文件 *.s ln）。当 编译 某 项目时 ，J am root 自 动 搜索相 关 J am root 文件 ；若 当前 目录 无 此文 件则 向 上 检查 父目 录；若 父目 录中 亦 无 则 继续 向 上 搜索 直至 找 到 。配 置信 息存 储于 J am ro ot 中 并 将影 响 所有 相关 项 目 。Jamfile 档案 Jamile文件（遵循B jam v2规则并带有v2后缀）表示一组工程。当运行B jam命令时，在当前目录中搜索Jamile文件并启动其相应的操作。例如一个典型的 Jamile文件如下： exe hello : hello.cpp : boost multi ;该 Jamfile 用于编译 hello.exe 文件源代码为 hello.cpp。请注意这些头文件会自动被处理，请无需自行处理。具体参数的含义请参考后续说明。 该 Jamfile 用于编译 hello.exe 文件源代码为 hello.cpp。请注意这些头文件会自动被处理，请无需自行处理。具体参数的含义请参考后续说明。目录Bjam 采用层级化的方式进行组织，在每个子目录中只包含一个 Jamfile 文件。 规定（Rule）：必须遵守的规定。实际上,JamFile仅提供了基本功能,而对于复杂的功能,通常需要通过特定的规则来进行实现,这些规则本质上类似于我们所熟知的函数.其调用格式一般遵循如下形式: rulename param1 : param2 ;其中,参数之间需以:符号分隔（特别提醒,前后需留有空格）获取系统环境参数无法对输入文本进行有效的同义改写以降低重复率这段代码将环境变量BOOST_PATH读取到变量BOOST_PATH中，并在之后使用$(BOOST_PATH)时会调用此变量确定文件的完整路径在实际应用中，相对路径有时会遇到问题，在这种情况下建议将相对路径转换为绝对路径进行处理。推荐采用 path-constant 规则来进行这一转换操作。该代码行通过 path-constant 规则将输入的相对路径 ....path 转换为绝对路径，并将其存储于变量 vername 中。引用系统 这个规则可以让该工程拥有一个别名标识。例如在以下代码示例中 将位于 .core 目录下的工程 由核心目录中的 jamfile 配置文件定义 的部分 可以被配置为 library-cccoreuse-project library-cccore : assigns the core library attributes如果需要构建的文件调用该工程，则该开发人员无需额外配置地直接使用 library-cccore。执行当前项目：hello.c++ 库-cccore；在编译 myproject 时, 会将 .core 目录下的 jamfile 文件中的 lib core 整合进去工程的核心参数设置通过项目规则可以为多个工程设置基础配置。参数说明：以下将详细列出所需配置的各个参数及其作用。 * 工程唯一标识符：none * 当前工程的起始位置设置于source-location * 父需求指代...（此处可能需要进一步解释以达到字数要求） * 默认构建参数设为default 在使用Bjam时需注意基本语法规则如前后需留空格；前需留空格