IMPORTED_OBJECTS

版本 3.9 中添加。

指向磁盘上 导入 对象库 的对象文件的绝对路径的 分号分隔列表。

对于非导入目标，将被忽略。

项目可以跳过 IMPORTED_OBJECTS，而是设置特定于配置的属性 IMPORTED_OBJECTS_<CONFIG>，除了下面章节中提到的情况。

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 变量处理。