SKIP_LINTING¶
在 3.27 版本中新增。
此属性允许您将特定源文件排除在 linting(代码检查)过程之外。linting 过程包括针对源文件运行工具,例如 <LANG>_CPPLINT、<LANG>_CLANG_TIDY、<LANG>_CPPCHECK、<LANG>_ICSTAT 和 <LANG>_INCLUDE_WHAT_YOU_USE,以及将头文件作为 VERIFY_INTERFACE_HEADER_SETS 的一部分进行编译。通过在源文件上设置 SKIP_LINTING,上述 linting 工具将不会为该特定文件执行。
示例¶
考虑一个包含多个源文件的 C++ 项目,例如 main.cpp、things.cpp 和 generatedBindings.cpp。在此示例中,您希望将 generatedBindings.cpp 文件排除在 linting 过程之外。为了实现此目的,您可以使用 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
)
在提供的代码片段中,为 generatedBindings.cpp 源文件设置了 SKIP_LINTING 属性为 true。因此,当执行由 <LANG>_CPPLINT、<LANG>_CLANG_TIDY、<LANG>_CPPCHECK、<LANG>_ICSTAT 或 <LANG>_INCLUDE_WHAT_YOU_USE 指定的 linting 工具执行时,它们将跳过分析 generatedBindings.cpp 文件。
通过使用 SKIP_LINTING 属性,您可以有选择地排除特定源文件不参与 linting 过程。这使您可以将 linting 工具的焦点集中在项目的相关部分,从而提高 linting 工作流程的效率和有效性。