Build Catalyst 的接口是称为 rafmake 的 make 实用程序。该接口具有控制其行为的各种选项。
命令的语法取决于操作系统,如下表中所示。
操作系统 | 选项 |
---|---|
Linux 和 Solaris(构建目标。) | rafmake [ –f makefile ] ... [ –ukinservwdpqUN ] [ –J num ] [ –B bldhost-file ] [ –c compat-mode ] [ –C change-directory ] [ –A BOS-file ] ... [ macro=value ... ] [ target-name ... ] |
Windows(构建目标。) | rafmake [ –f makefile ] ... [ –ukinservwdpqUN ] [ –J num ] [ –c compat-mode ] [ –C change-directory ] [ –A BOS-file ] ... [ macro=value ... ] [ target-name ... ] |
所有(显示 rafmake 实用程序的版本信息。) | rafmake { –ver/sion | –VerAll } |
rafmake 命令支持 GNU V3.80 make 命令的大部分公共选项。 rafmake 命令还提供附加选项。
选项 | 描述 |
---|---|
–f makefile | 将 makefile 用作输入文件。如果您省略此选项,rafmake 命令将在当前工作目录中查找名为 makefile 和 Makefile(以该顺序)的输入文件。可以指定多个 –f makefile 参数对。将有效并置多个输入文件。 |
–u | (无条件)重新构建所有指定的目标及其所有依赖性,无论是否需要重新构建。(另请参阅 –U。) |
–k | 如果当前条目上的工作失败,请将其放弃,但是在不依赖于该条目的其他目标上继续处理。 |
–i | 忽略命令返回的错误代码。 |
–n | (不执行)从需要重新构建的目标的 makefile 列出命令行(包括以 at 符号 (@) 开头的命令行),但是不运行这些命令行。异常:始终运行包含字符串 $(MAKE) 的命令。 |
–s | (静默)在运行命令行之前请勿将其列出。 |
–e | 环境变量覆盖 makefile 文件中的宏分配。(但是,命令行或构建选项规范中的宏=值分配将覆盖环境变量。) |
–r | (无规则)请勿使用 buildcatalyst-home-dir/etc/builtin.mk 文件(Linux 和 Solaris)或 buildcatalyst-home-dir\etc\builtin.mk 文件 (Windows) 中的内置规则。与 –c 选项一起使用时,–r 选项也禁止读取特定于平台的启动文件。请参阅 –c 选项以了解更多信息。 |
–v | (详细)比缺省输出方式稍微更详细些。 |
–w | (工作目录)在运行 makefile 之前和之后打印包含工作目录的消息。 |
–d | (调试)相当详细,并包含构建期间 rafmake 命令读取的环境变量的列表。仅在调试 makefile 时使用此选项。 |
–p | (打印)列出所有目标描述和所有宏定义,包括特定于目标的宏定义和隐式规则。请勿运行任何对象。 |
–q | (查询)评估 makefile 目标,但是为运行构建脚本。rafmake 命令返回以下响应之一:
|
–U | 仅无条件地构建目的目标。请勿构建子目标。如果没有在命令行上指定任何目标,那么缺省目标为目的。(–u 选项无条件地构建目的目标和构建依赖性。) |
–N | 禁用用于读取一个或多个构建选项规范 (BOS) 文件的缺省过程。 |
–J num | 启用并行构建能力。并行目标重新构建的最大数量设置为整数 num。 如果 num=0,那么禁用并行构建。(这等价于不指定 –J 选项。)或者,您可以将 num 指定为 RAFMAKE_CONC 环境变量的值。 |
–B bldhost-file | 将 bldhost-file 文件用作并行构建的构建主机文件。如果没有指定 –B 选项,那么 rafmake 命令使用主目录中的 .bldhost.$RAFMAKE_HOST_TYPE 文件。使用 –B 选项时,您还必须使用 –J 选项或设置 RAFMAKE_CONC 环境变量。 |
–c compat-mode | (兼容性)以兼容性方式调用 rafmake 命令。 (或者,可以使用 RAFMAKE_COMPAT 环境变量来指定兼容性方式。) 您可以将 compat-mode 变量设置为以下值之一:
仅在 Linux 和 Solaris 系统上,compat-mode 变量还可以具有以下值之一。–c 选项独立于 Linux 和 Solaris 平台。但是,一些方式尝试读取特定于系统的文件;如果这些文件不存在,那么命令失败。
|
–C dir | 更改目录。rafmake 命令切换到 dir 目录,然后启动构建。 |
–A BOS-file | 指定在缺省读取的 BOS 文件后立即读取的 BOS 文件。多次使用该选项来指定多个 BOS 文件。 将 –N 与该选项一起使用时,rafmake 读取指定的 BOS 文件,而不是缺省的 BOS 文件。 或者,您可以指定 BOS 文件路径名的冒号分隔的列表(Linux 和 Solaris)或者此类路径名的分号分隔的列表作为环境变量 RAFMAKE_OPTS_SPECS 的值。 |
–ver/sion | 打印关于 rafmake 命令的版本信息。 |
–VerAll | 打印关于 rafmake 命令以及 rafmake 命令使用的库(Linux 和 Solaris)或 DLL (Windows) 的版本信息。 |