文件标记器

为文件分配文件标记。更多...

属性

此项目将文件标记分配给文件。文件标记器项可以出现在产品项或模块项中。

对于每个没有文件标记的源工件，Qbs 将搜索与源工件文件名匹配的模式。如果找到一个匹配的文件标记器，则将文件标记器项中指定的文件标记分配给源工件。

如果存在多个匹配的文件标记器，则考虑所有具有最高优先级的文件标记器，并将它们的文件标记累积。

文件标记器项可以附加到产品或模块。在后一种情况下，其效果相当于将文件标记器附加到所有依赖于相应模块的产品中。例如，Qbs 的cpp模块中包括以下文件标记器

FileTagger {
    patterns: "*.cpp"
    fileTags: ["cpp"]
}

因此，对于依赖于cpp模块的产品，所有以".cpp"结尾的文件将自动附加“cpp”标记。这会导致它们被编译，因为 C++ 编译规则在其匹配输入标记列表中将“cpp”

如果在产品或组中明确设置了文件标记，则禁用文件标记器。例如，以下产品中的".cpp"文件没有附加“cpp”标记

Product {
    Depends { name: "cpp" }
    Group {
        files: "*.cpp"
        fileTags: "other"
    }
}

[自从 Qbs 1.0] fileTags : 列表

附加到产品文件上的标记。然后可以通过规则匹配。

默认值：空列表

此属性自 Qbs 1.0 起引入。

[自从 Qbs 1.0] patterns : 字符串列表

要与模式匹配的列表。支持通配符 '*'、'?' 和 '[]'。

列表本身及其元素均不能为空。

此属性自 Qbs 1.0 起引入。

[自从 Qbs 1.10] priority : 整数

文件标记器的优先级。数值越大，优先级越高。

默认值：0

此属性自 Qbs 1.10 起引入。