CheckOBJCSourceCompiles

版本 3.16 中新增。

检查 Objective-C 源是否可以构建，只需检查一次。

check_objc_source_compiles

check_objc_source_compiles(<code> <resultVar>
                           [FAIL_REGEX <regex1> [<regex2>...]])

检查一次 <code> 中提供的源是否可以构建。结果存储在 <resultVar> 指定的内部缓存变量中，成功时为布尔值 true，失败时为布尔值 false。

如果提供了 FAIL_REGEX，那么通过检查编译器输出中的任何内容是否与任何指定正则表达式相匹配来确定失败。

在内部，try_compile() 用于编译源。如果将 CMAKE_TRY_COMPILE_TARGET_TYPE 设置为 EXECUTABLE（默认值），则源将作为可执行程序进行编译并链接。如果设置为 STATIC_LIBRARY，则源会被编译，但不会被链接。无论哪种情况，都必须像往常一样声明所有函数。

有关更通用的命令语法，另请参阅 check_source_compiles()。

另请参阅 check_source_runs() 以运行已编译的源。

在调用 check_objc_source_compiles() 之前，可以通过设置以下任何变量来影响编译和链接命令

CMAKE_REQUIRED_FLAGS

要传递给编译器的附加标志的字符串。该字符串必须以空格分隔——;-list 不起作用。CMAKE_<LANG>_FLAGS 及其关联的特定于配置的变量的内容在 CMAKE_REQUIRED_FLAGS 的内容之前自动添加到编译器命令中。

CMAKE_REQUIRED_DEFINITIONS

形式为 -DFOO 或 -DFOO=bar 的编译器定义的;-list。还将自动添加对 <resultVar> 指定的名称的定义。

CMAKE_REQUIRED_INCLUDES

传递给编译器的头文件搜索路径的 ;-list。这些将是使用的唯一头文件搜索路径——将忽略 INCLUDE_DIRECTORIES 目录属性的内容。

CMAKE_REQUIRED_LINK_OPTIONS

3.14 版新增。

要添加到链接命令的选项的 ;-list（有关详细信息，请参见 try_compile() ）。

CMAKE_REQUIRED_LIBRARIES

要添加到链接命令的库的 ;-list。这些可以是系统库的名称，也可以是 导入目标（有关详细信息，请参见 try_compile() ）。

CMAKE_REQUIRED_LINK_DIRECTORIES

3.31 版新增。

传递给链接器的库搜索路径的 ;-list（有关详细信息，请参见 try_compile() ）。

CMAKE_REQUIRED_QUIET

3.1 版新增。

如果此变量求值得布尔真值，则将禁止与检查关联的所有状态消息。