使用配置文件修改每个构建的设置

您可以覆盖单个构建的某些 Incredibuild 设置。这可以通过在配置文件中创建 Incredibuild 设置集来实现。然后，您可以在运行构建时引用这些文件。

您可以创建和使用多个配置文件来支持不同的用例。

当前，Visual Studio 集成以及从命令行运行构建时均支持这一功能。

可用设置

参数	描述	可接受值
/freecompletedtasks	用于大型项目以提高内存性能	on\|off
/clangpathconvert	在使用 Clang 构建项目时使用。此设置可转换路径，使其与 Clang 兼容。如果您在路径中使用特殊字符或有任何其他兼容性问题，请联系support@incredibuild.com。	Default=1 有关其他选项，请联系客户支持部门。
/maxconcurrentpdbs	Incredibuild 将限制同一项目中可并行构建的文件数量。这样只有少数 PDB 会被处理，从而加快链接时间。更多详细信息。	整数
/maxfilesyncthreads	用于 Initiator 和 Helper 之间单个文件传输的最大线程数。	整数
/maxparallellinktargets	用于并行链接的最大 CPU 内核数	整数
/forceenglishmsbuildoutput*	用英语显示 Build Monitor 输出选项卡中的信息。	on\|off
/usemsbuild*	强制使用某一版本的 MSBuild（32 位或 64 位）。	32\|64
/avoidlocal	覆盖 Agent Settings 中的 Avoid task execution on local machine when possible 选项。	on\|off
/maxcpus	覆盖构建设置中全局最大 CPU/核心数量。	整数
/pemode*	覆盖 Agent 预测执行程序设置。	0\|1\|2 0=disabled 1=build 2=rebuild
/buildcacheremoteserver	定义用于远程/共享 Build Cache 的服务器。	IP：端口
/buildcachelocal	启用 Build Cache 以使用本地缓存。	on\|off
/rootTaskAware	启用后，无论某些任务是否出错，都会将构建状态从构建系统继承到 Incredibuild。如果某些任务出现错误，但构建已成功完成，则构建状态在 Build Monitor 构建监视器中显示为橙色。	默认已禁用。设置 /rootTaskAware=1 以启用

*使用 Incredibuild 的 IBConsole 命令运行您的构建时，不支持这些参数。

创建配置文件

配置文件会因运行构建时使用的 Incredibuild 命令（buildconsole 或 ibconsole）而略有不同。我们建议从示例文件开始：C:\Program Files (x86)\Incredibuild\ConfigFiles\Sample.ib_config.rsp.。

所有配置文件的扩展名必须是 .rsp。

注意：此示例假设您正在使用 buildconsole。如果您在使用 ibconsole，请删除 /usemsbuild, /pemode, /predictedexecution32bitfallback, and /ForceEnglishMSBuildOutput。

复制

/freecompletedtasks=off
/maxconcurrentpdbs=12
/maxfilesyncthreads=
/maxparallellinktargets=1
/ForceEnglishMSBuildOutput=off
/usemsbuild=64
/avoidlocal=off
/maxcpus=0
/pemode=2
/buildcacheremoteserver=127.0.0.1:50222  
/buildcachelocal=on

为方便起见，所有参数均包含在示例文件中，但您不需要在配置文件中包含每个参数。根据上表并根据需要编辑文件。

在构建过程中使用配置文件

在运行构建时，配置文件可以以下列两种方式之一使用：

自动：如果将配置文件放在与解决方案文件相同的位置，且名称与解决方案相同，则在运行该解决方案中的任何项目时，都会自动使用该配置文件。

如果要为同一解决方案使用多个配置文件（如调试版与发布版），请在命令行中使用解决方案 name_cfg 值为其命名。

例如，如果您的解决方案是 MySolution.ib_config.rsp，并且调试配置和发布配置不同，您可以使用以下名称：

MySolution_Debug_x64.ib_config.rsp

MySolution.ib_config.rsp
命令行：如果您直接在构建命令中指定配置文件，则将使用该文件（VS IDE 中不支持此功能）。

要在构建命令中指定配置文件，请添加标记@<relative or full path>\yourconfigfile.rsp。例如 @..\configx64.rsp

使用实例

为每个解决方案使用不同的配置文件

如果每个解决方案都有一个唯一的配置文件，请将配置文件命名为与解决方案相同的名称，并放在相同的文件夹中。每当该解决方案中的任何项目自动运行时，都会使用它。

为单一解决方案使用多个配置文件

如果同一解决方案使用多个配置文件，则每次都必须在构建命令中指定配置文件。

当对多个目标使用同一解决方案时（例如 helloworld_x86.rsp, helloworld_x64.rsp），该功能非常有用。