IMPORTED_OBJECTS

版本 3.9 中添加。

对于导入的对象库,磁盘上对象文件的以分号分隔的绝对路径列表

对于非导入目标被忽略。

如果设置了特定于配置的属性IMPORTED_OBJECTS_<CONFIG>,则项目可以跳过IMPORTED_OBJECTS,但以下部分所述情况除外。

Xcode 生成器注意事项

在 3.20 版本中添加。

对于 Apple 平台,项目可以为多个架构构建。这由CMAKE_OSX_ARCHITECTURES变量控制。除了Xcode生成器,CMake 会为每个源文件调用编译器一次,并传递多个-arch标志,从而生成一个通用二进制对象文件。当这些对象文件在单独的 CMake 构建的IMPORTED_OBJECTS中列出时,即使对于Xcode生成器,它们也能很好地工作。但是使用Xcode生成器生成此类对象文件更为困难,因为它会为每个源文件的每个架构调用编译器一次。与其他生成器不同,它不生成通用对象文件二进制文件。

使用Xcode生成器进一步的复杂之处在于,当目标是设备平台(iOS、tvOS、visionOS 或 watchOS)时,Xcode生成器能够使用设备或模拟器 SDK,而无需重新运行 CMake。SDK 可以在构建时选择。但是,由于某些架构可以同时被设备和模拟器 SDK 支持(例如,Xcode 12 或更高版本中的arm64),因此并非所有组合都可以表示为单个通用二进制文件。在这种情况下,唯一的解决方案是拥有多个对象文件。

IMPORTED_OBJECTS不支持生成器表达式,因此它列出的每个文件都必须对每个架构和 SDK 有效。如果包含非通用二进制对象文件,则每个对象文件的路径和/或文件名必须以某种方式封装不同的架构和 SDK。使用Xcode生成器,可以使用$(...)形式的 Xcode 变量来表示这些方面,Xcode 会在构建时替换相应的值。CMake 不会解释这些变量,并将其原样嵌入到 Xcode 项目文件中。$(CURRENT_ARCH)可用于表示架构,而$(EFFECTIVE_PLATFORM_NAME)可用于区分 SDK。

以下示例展示了如何使用这两个变量来引用其位置取决于 SDK 和架构的对象文件

add_library(someObjs OBJECT IMPORTED)

set_property(TARGET someObjs PROPERTY IMPORTED_OBJECTS
  # Quotes are required because of the ()
  "/path/to/somewhere/objects$(EFFECTIVE_PLATFORM_NAME)/$(CURRENT_ARCH)/func.o"
)

# Example paths:
#   /path/to/somewhere/objects-iphoneos/arm64/func.o
#   /path/to/somewhere/objects-iphonesimulator/x86_64/func.o

在某些情况下,您可能还需要特定于配置的对象文件。$(CONFIGURATION) Xcode 变量通常用于此目的,并且可以与上面提到的其他变量结合使用

add_library(someObjs OBJECT IMPORTED)
set_property(TARGET someObjs PROPERTY IMPORTED_OBJECTS
  "/path/to/somewhere/$(CONFIGURATION)$(EFFECTIVE_PLATFORM_NAME)/$(CURRENT_ARCH)/func.o"
)

# Example paths:
#   /path/to/somewhere/Release-iphoneos/arm64/func.o
#   /path/to/somewhere/Debug-iphonesimulator/x86_64/func.o

当使用任何 Xcode 变量时,CMake 无法在配置时完全评估路径。其结果之一是无法使用特定于配置的IMPORTED_OBJECTS_<CONFIG>属性,因为 CMake 无法确定对象文件是否存在于特定的<CONFIG>位置。在这些情况下必须使用IMPORTED_OBJECTS属性,并且路径的特定于配置的方面应由$(CONFIGURATION) Xcode 变量处理。