15

我正在尝试为 clang-tidy 创建一个自定义 cmake 目标，以整理我的项目。源文件夹如下所示：

src/scripts/run-clang-tidy.py
src/.clang-tidy
src/...

到目前为止，我的计划是使用自定义命令将这两个文件复制到构建目录：

add_custom_command(
    OUTPUT run-clang-tidy.py .clang-tidy
    COMMAND cp ${CMAKE_SOURCE_DIR}/scripts/run-clang-tidy.py ${CMAKE_SOURCE_DIR}/.clang-tidy ${CMAKE_CURRENT_BINARY_DIR})

我现在想run-clang-tidy.py使用自定义目标调用构建目录（应该是工作目录），这样我就可以调用：

make lint

哪个应该运行.clang-tidy.

要使此脚本正常工作，它还需要该CMAKE_EXPORT_COMPILE_COMMANDS选项。我尝试使用以下命令设置它，但它无法识别它：

add_definitions(-DCMAKE_EXPORT_COMPILE_COMMANDS=ON)

电话add_custom_target会是什么样子？

4

4 回答 4

29

从 CMake 3.6 开始，clang-tidy实现了 [ 1 , 2 ] 的原生集成。机制类似于include-what-you-use自 CMake 3.3 [ 3 ] 以来的集成。

于 2016-08-11T00:57:07.173 回答
12

我可以建议另一种方法，不需要额外的 Python 脚本。

首先，我想在自定义CMake规则中集成clang-tidy和，所以我首先生成了位于项目根目录下的文件。clang-format.clang-tidy.clang-format

生成配置文件

要生成.clang-tidy，首先为您的项目找到合适的选项，然后，只需执行以下操作：

$> clang-tidy <source-files> -dump-config <tidy-options> -- <compile-options> > .clang-tidy

同样，clang-format您可以使用该-style=xxx选项从默认样式开始，然后转储它。例如，从 LLVM 样式开始：

$> clang-format -style=LLVM -dump-config > .clang-format

然后，根据需要对其进行编辑并正确配置。它应该是这样的：

---
Language:        Cpp
# BasedOnStyle:  LLVM
AccessModifierOffset: -2
AlignAfterOpenBracket: true
AlignEscapedNewlinesLeft: false
AlignOperands:   true
AlignTrailingComments: true
AllowAllParametersOfDeclarationOnNextLine: true
AllowShortBlocksOnASingleLine: false
AllowShortCaseLabelsOnASingleLine: false
AllowShortIfStatementsOnASingleLine: false
AllowShortLoopsOnASingleLine: false
AllowShortFunctionsOnASingleLine: All
AlwaysBreakAfterDefinitionReturnType: false
AlwaysBreakTemplateDeclarations: false
AlwaysBreakBeforeMultilineStrings: false
BreakBeforeBinaryOperators: None
BreakBeforeTernaryOperators: true
BreakConstructorInitializersBeforeComma: false
BinPackParameters: true
BinPackArguments: true
ColumnLimit:     80
ConstructorInitializerAllOnOneLineOrOnePerLine: false
ConstructorInitializerIndentWidth: 4
DerivePointerAlignment: false
ExperimentalAutoDetectBinPacking: false
IndentCaseLabels: false
IndentWrappedFunctionNames: false
IndentFunctionDeclarationAfterType: false
MaxEmptyLinesToKeep: 1
KeepEmptyLinesAtTheStartOfBlocks: true
NamespaceIndentation: None
ObjCBlockIndentWidth: 2
ObjCSpaceAfterProperty: false
ObjCSpaceBeforeProtocolList: true
PenaltyBreakBeforeFirstCallParameter: 19
PenaltyBreakComment: 300
PenaltyBreakString: 1000
PenaltyBreakFirstLessLess: 120
PenaltyExcessCharacter: 1000000
PenaltyReturnTypeOnItsOwnLine: 60
PointerAlignment: Right
SpacesBeforeTrailingComments: 1
Cpp11BracedListStyle: true
Standard:        Cpp11
IndentWidth:     2
TabWidth:        8
UseTab:          Never
BreakBeforeBraces: Attach
SpacesInParentheses: false
SpacesInSquareBrackets: false
SpacesInAngles:  false
SpaceInEmptyParentheses: false
SpacesInCStyleCastParentheses: false
SpaceAfterCStyleCast: false
SpacesInContainerLiterals: true
SpaceBeforeAssignmentOperators: true
ContinuationIndentWidth: 4
CommentPragmas:  '^ IWYU pragma:'
ForEachMacros:   [ foreach, Q_FOREACH, BOOST_FOREACH ]
SpaceBeforeParens: ControlStatements
DisableFormat:   false
...

创建自定义 CMake 规则

CMake 允许以非常简单的方式定义自定义规则，您只需在文件中编写一组 CMake 命令并调用该add_custom_target()过程，然后将其包含在您的CMakeList.txt文件中。这就是我们要做的，我们首先cmake/clang-dev-tools.cmake在项目的根目录下创建一个文件：

# Additional target to perform clang-format/clang-tidy run
# Requires clang-format and clang-tidy

# Get all project files
file(GLOB_RECURSE ALL_SOURCE_FILES *.cpp *.hpp)

add_custom_target(
        clang-format
        COMMAND /usr/bin/clang-format
        -style=file
        -i
        ${ALL_SOURCE_FILES}
)

add_custom_target(
        clang-tidy
        COMMAND /usr/bin/clang-tidy
        ${ALL_SOURCE_FILES}
        -config=''
        --
        -std=c++11
        ${INCLUDE_DIRECTORIES}
)

然后，编辑您CMakeLists.txt并添加：

# Including extra cmake rules
include(cmake/clang-dev-tools.cmake)

然后，一旦构建系统重新生成，您应该能够运行make clang-tidy和make clang-format.

于 2016-04-22T15:59:02.903 回答
8

Alexander Shukaev提到的文档在细节上有点短，所以我添加了一个示例。警告字符串的格式使 IDE 认为 clang-tidy 结果是编译器警告，并将标记源代码。此外，它在创建目标文件后并行运行每个文件。

if ( CMAKE_VERSION GREATER "3.5" )
  set(ENABLE_CLANG_TIDY OFF CACHE BOOL "Add clang-tidy automatically to builds")
  if (ENABLE_CLANG_TIDY)
    find_program (CLANG_TIDY_EXE NAMES "clang-tidy" PATHS /usr/local/opt/llvm/bin )
    if (CLANG_TIDY_EXE)
      message(STATUS "clang-tidy found: ${CLANG_TIDY_EXE}")
      set(CLANG_TIDY_CHECKS "-*,modernize-*")
      set(CMAKE_CXX_CLANG_TIDY "${CLANG_TIDY_EXE};-checks=${CLANG_TIDY_CHECKS};-header-filter='${CMAKE_SOURCE_DIR}/*'"
        CACHE STRING "" FORCE)
    else()
      message(AUTHOR_WARNING "clang-tidy not found!")
      set(CMAKE_CXX_CLANG_TIDY "" CACHE STRING "" FORCE) # delete it
    endif()
  endif()
endif()

我遇到的唯一问题是它仍然检查自动生成moc_*.cxx的文件以及来自ExternalProject.

于 2017-10-06T17:18:10.767 回答
3

add_definitions设置CMake变量，仅配置阶段可用。如果要为在构建阶段执行的命令设置环境COMMAND变量，请使用适当的 shell 机制和关键字：

add_custom_target(lint
    COMMAND CMAKE_EXPORT_COMPILE_COMMANDS=ON python run-clang-tidy.py
    DEPENDS ${CMAKE_CURRENT_BINARY_DIR}/run-clang-tidy.py
            ${CMAKE_CURRENT_BINARY_DIR}/.clang-tidy

为关键字指定的所有内容都COMMAND将由 shell “按原样”解释（在解释 CMake 之后，这里是无操作的）。

于 2015-08-31T12:53:55.990 回答