如何在CMake中链接macOS框架时抑制系统头文件警告？

问题根源 #

用find_library链接系统框架时，CMake默认不会将框架的头文件目录标记为系统包含目录，导致clang对系统级头文件触发不必要的编译警告。

解决方法 #

方法一：直接用框架语法链接（推荐） #

无需find_library，直接在target_link_libraries中使用-framework语法，CMake会自动处理头文件路径并标记为系统目录：

target_link_libraries(mytarget PRIVATE "-framework Contacts")

方法二：标记框架头文件为系统目录 #

如果坚持使用find_library，可以手动提取框架的头文件目录，将其标记为系统包含路径：

find_library(CONTACTS_FRAMEWORK Contacts)
target_link_libraries(mytarget PRIVATE ${CONTACTS_FRAMEWORK})

# 获取框架所在目录，定位到头文件路径
get_filename_component(CONTACTS_FRAMEWORK_DIR ${CONTACTS_FRAMEWORK} DIRECTORY)
target_include_directories(mytarget SYSTEM PRIVATE "${CONTACTS_FRAMEWORK_DIR}/Headers")

方法三：通过编译选项强制忽略系统头文件警告 #

直接给目标添加-isystem编译选项，指定框架头文件目录，让clang将其视为系统头文件并跳过警告：

find_library(CONTACTS_FRAMEWORK Contacts)
target_link_libraries(mytarget PRIVATE ${CONTACTS_FRAMEWORK})

get_filename_component(CONTACTS_FRAMEWORK_DIR ${CONTACTS_FRAMEWORK} DIRECTORY)
target_compile_options(mytarget PRIVATE -isystem "${CONTACTS_FRAMEWORK_DIR}/Headers")

如果需要批量处理所有系统框架，可以全局设置：

set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -isystem /System/Library/Frameworks")

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