macOS下使用Ninja生成器构建CMake项目时如何获取dSYM文件？

方法一：通过编译器/链接器参数自动生成 #

Clang编译器支持直接通过编译参数生成带dSYM的调试信息，无需额外手动调用dsymutil。在CMakeLists.txt开头添加以下配置，针对Debug模式设置：

# 为C/C++ Debug编译添加生成dSYM的参数
set(CMAKE_C_FLAGS_DEBUG "${CMAKE_C_FLAGS_DEBUG} -g -gdwarf-4 -gstrict-dwarf")
set(CMAKE_CXX_FLAGS_DEBUG "${CMAKE_CXX_FLAGS_DEBUG} -g -gdwarf-4 -gstrict-dwarf")

# 为链接器添加调试信息参数，确保二进制包含足够生成dSYM的信息
set(CMAKE_EXE_LINKER_FLAGS_DEBUG "${CMAKE_EXE_LINKER_FLAGS_DEBUG} -Wl,-g")
set(CMAKE_SHARED_LINKER_FLAGS_DEBUG "${CMAKE_SHARED_LINKER_FLAGS_DEBUG} -Wl,-g")

配置完成后，Ninja构建Debug版本时，Clang会自动触发dsymutil生成对应二进制的.dSYM包，直接输出到二进制所在目录。

方法二：全局添加POST_BUILD命令处理所有本地目标 #

如果需要自定义dSYM输出路径或更灵活的控制，可以编写CMake函数遍历项目内所有非IMPORTED目标，为每个目标添加dsymutil调用的POST_BUILD命令：

首先添加递归遍历所有目标的辅助函数：

# 递归获取目录下所有CMake目标
function(get_all_targets_recursive targets dir)
  get_property(subdirectories DIRECTORY ${dir} PROPERTY SUBDIRECTORIES)
  foreach(subdir IN LISTS subdirectories)
    get_all_targets_recursive(targets ${subdir})
  endforeach()

  get_property(current_targets DIRECTORY ${dir} PROPERTY BUILDSYSTEM_TARGETS)
  list(APPEND targets ${current_targets})
  set(targets ${targets} PARENT_SCOPE)
endfunction()

function(get_all_targets var)
  set(targets)
  get_all_targets_recursive(targets ${CMAKE_CURRENT_SOURCE_DIR})
  set(${var} ${targets} PARENT_SCOPE)
endfunction()

然后定义添加dSYM生成的函数，并应用到所有目标：

# 为目标添加dSYM生成命令（跳过IMPORTED目标）
function(add_dsymutil target)
  get_target_property(target_type ${target} TYPE)
  if(target_type STREQUAL "IMPORTED_LIBRARY" OR target_type STREQUAL "IMPORTED_EXECUTABLE")
    return()
  endif()

  add_custom_command(TARGET ${target} POST_BUILD
    COMMAND dsymutil "$<TARGET_FILE:${target}>" -o "$<TARGET_FILE_DIR:${target}>/$<TARGET_FILE_BASE_NAME:${target}>.dSYM"
    COMMENT "Generating dSYM for ${target}"
    VERBATIM
  )
endfunction()

# 在项目所有目标定义完成后调用
get_all_targets(all_project_targets)
foreach(target IN LISTS all_project_targets)
  add_dsymutil(${target})
endforeach()

这种方式会自动处理项目中所有自定义的库和可执行文件，不会影响IMPORTED目标——这类目标是外部预编译文件，dSYM需由提供方生成，若缺失只能手动处理。

关于IMPORTED库的dSYM处理 #

IMPORTED库是外部预编译文件，CMake无法对其添加POST_BUILD命令。如果这类库缺少dSYM文件，可手动执行以下命令生成：

dsymutil /path/to/imported/library.dylib -o /path/to/output/library.dSYM

也可以将此命令封装为CMake自定义目标，方便构建时触发：

add_custom_target(gen_imported_dsym
  COMMAND dsymutil "${IMPORTED_LIBRARY_PATH}" -o "${CMAKE_BINARY_DIR}/imported_lib.dSYM"
  COMMENT "Generating dSYM for imported library"
)

内容的提问来源于stack exchange，提问作者laconian