使用配置文件修改每个构建的设置
您可以覆盖单个构建的某些 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)