SKIP_LINTING

3.27 版本中新增。

此属性允许您从 linting 过程中排除特定源文件。linting 过程涉及运行诸如 <LANG>_CPPLINT<LANG>_CLANG_TIDY<LANG>_CPPCHECK<LANG>_INCLUDE_WHAT_YOU_USE 等工具对源文件进行 linting,以及在 VERIFY_INTERFACE_HEADER_SETS 的一环中编译头文件。通过在源文件上设置 SKIP_LINTING,上述 linting 工具将不会针对此特定文件执行。

示例

考虑一个 C++ 项目,其中包含多个源文件,例如 main.cppthings.cppgeneratedBindings.cpp。在此示例中,您想要从 linting 进程中排除 generatedBindings.cpp 文件。为此,您可以将 SKIP_LINTING 属性与 set_source_files_properties() 命令结合使用,如下所示

add_executable(MyApp main.cpp things.cpp generatedBindings.cpp)

set_source_files_properties(generatedBindings.cpp PROPERTIES
    SKIP_LINTING ON
)

在提供的代码片段中,SKIP_LINTING 属性针对 generatedBindings.cpp 源文件被设置为 true。因此,当 <LANG>_CPPLINT<LANG>_CLANG_TIDY<LANG>_CPPCHECK<LANG>_INCLUDE_WHAT_YOU_USE 指定的 linting 工具执行时,它们将跳过对 generatedBindings.cpp 文件的分析。

使用 SKIP_LINTING 属性,您可以有选择地将特定的源文件排除在 linting 处理之外。这允许您将重点放在项目的相关部分上执行 linting 工具,从而提高 linting 工作流的效率和效果。