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

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

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

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

可用设置

参数 描述 可接受值
/freecompletedtasks 用于大型项目以提高内存性能 on|off
/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

*仅当使用 Incredibuild 的 buildconsole 命令运行构建时才支持这些参数。

创建配置文件

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

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

复制
/freecompletedtasks=off
/maxconcurrentpdbs=12
/multithreadedfilesyncthreads=8
/maxparallellinktargets=1
/predictedexecution32bitfallback=off
/ForceEnglishMSBuildOutput=off
/usemsbuild=64
/avoidlocal=off
/maxcpus=0
/pemode=2
/buildcacheremoteserver=127.0.0.1:50222  
/buildcachelocal=on

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

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

如果配置文件命名正确并复制到正确的位置,则会自动使用这些文件:

在命令行中运行构建成时:

  • 您可以将配置文件放在与项目或解决方案文件相同的位置。

  • 如果将该文件放置在与解决方案文件相同的位置,则该解决方案中的所有项目均将使用该文件。

  • 将配置文件重命名为与项目或解决方案同名(扩展名为 ib_config.rsp)

在 Visual Studio IDE 中运行构建时:

  • 将配置文件放在与解决方案文件相同的位置。该解决方案中的所有项目均将使用该文件

  • 将配置文件重命名为与解决方案同名(扩展名为 ib_config.rsp)