文件内容替换器

模板（可选）

文件内容替换器为每个需要替换的属性提供了一个模板。 点击Load Template按钮，将显示出一个包含替换值预设的模板下拉框。 模板可以通过在组合框中输入来根据语言（例如， C# ）或者文件（例如， AssemblyInfo ）或者属性（例如， AssemblyVersion ）进行筛选。 当选择一个模板时，设置会自动填充预设的值。 请参阅下方的 节 以获取模板详情。

处理文件

点击 编辑文件列表 并指定将在其中搜索需要替换值的文件路径。 以 +|-:[与签出目录相对的路径].
类蚂蚁通配符 的形式提供一组换行或逗号分隔的规则，例如， dir/**/*.cs。

tip

在这里，管道 符号 | 代表了 或 命令，如同在正则表达式中：使用 + 表示包含，或 - 表示排除。

如果选择了一个 预定义的模板，将使用与该模板关联的文件。

如果没有文件匹配模式，则构建失败

默认启用。 禁用此选项，即使没有文件与指定的模式匹配，也可以防止构建失败。

请注意，如果运行器找到至少一个符合给定模式的文件，即使该文件没有需要替换的内容，此步骤也会被认为是成功的。

文件编码

默认情况下，TeamCity 将自动检测文件编码。 要明确指定编码，您需要从下拉菜单中选择它。 在指定一个 自定义 编码时，请确保它被代理 支持。

如果选择了一个 预定义模板，将使用与该模板关联的文件编码。

查找内容

请指定一种要搜索的模式，该模式需用 正则表达式 格式。
默认情况下，MULTILINE 模式是开启的。
如果选择了预设模板，系统将使用与该模板相关联的模式。

您可以通过在模式字符串的开始处添加 （?-m） 来禁用 MULTILINE 模式。

区分大小写

默认情况下，比较区分大小写。 对于不区分大小写的语言，请取消选择。
如果选择了预定义模板，将会使用与该模板关联的比较。

正则表达式模式

默认启用，并同样适用于搜索字符串和替换字符串。 取消勾选以使用固定字符串。

note

如果您使用版本设置（XML或Kotlin DSL），除了默认的 REGEX 和非默认的 FIXED_STRINGS 模式之外，还提供了 REGEX_MIXED 模式。 在此模式下，搜索模式将被解释为常规表达式，但替换文本将被 引用（ \ 和 $ 字符没有特殊含义）。

参见一个 文件内容替换器 在 Kotlin 中的设置示例：

features {
    replaceContent {
        fileRules = "**/*"
        pattern = "(?iu)the\h+pattern\h+to\h+search\h+for"
        regexMode = FileContentReplacer.RegexMode.REGEX_MIXED
        replacement = """%teamcity.agent.work.dir%\nd_r\bin\isf"""
    }
}

替换为

在 Find what 框中输入要用于替换字符的文本。 要从您的文件中删除查找内容框中的字符，将此框留空。

$N 序列引用第 N 个捕获组。 所有没有特殊含义的反斜杠（ \ ）和美元符号（ $ ）都应被引用（分别为 \\ 和 \$）。