STATIC_LIBRARY_OPTIONS

3.13 版本新增。

静态库目标的归档器（或 MSVC 链接器）标志。共享库、模块或可执行文件的目标需要使用 LINK_OPTIONS 目标属性。

此属性包含一个 分号分隔的列表，其中包含到目前为止为其目标指定的选项。使用 set_target_properties() 或 set_property() 命令来设置其内容。

STATIC_LIBRARY_OPTIONS 的内容可以使用语法为 $<...> 的“生成器表达式”。有关可用表达式，请参阅 cmake-generator-expressions(7) 手册。有关定义构建系统属性的更多信息，请参阅 cmake-buildsystem(7) 手册。

注意

应优先使用此属性，而不是 STATIC_LIBRARY_FLAGS 属性。

选项去重

用于目标的最终选项集通过累积当前目标及其依赖项的使用要求的选项来构建。选项集经过去重以避免重复。

版本 3.12 中添加：尽管这对于单个选项很有益，但去重步骤可能会打断选项组。例如，-option A -option B 会变成 -option A B。可以使用类似 shell 的引用和 SHELL: 前缀来指定一个选项组。将删除 SHELL: 前缀，其余的选项字符串将使用 separate_arguments() 命令的 UNIX_COMMAND 模式进行解析。例如，"SHELL:-option A" "SHELL:-option B" 会变成 -option A -option B。

处理归档器驱动程序差异

4.0 版本新增。

为了将选项传递给归档器工具，每个编译器驱动程序都有自己的语法。可以使用 ARCHIVER: 前缀和 , 分隔符以可移植的方式指定要传递给归档器工具的选项。ARCHIVER: 将被替换为适当的驱动程序选项，, 将被替换为适当的驱动程序分隔符。驱动程序前缀和驱动程序分隔符由 CMAKE_<LANG>_ARCHIVER_WRAPPER_FLAG 和 CMAKE_<LANG>_ARCHIVER_WRAPPER_FLAG_SEP 变量的值给出。

ARCHIVER: 前缀可以作为 SHELL: 前缀表达式的一部分进行指定。

ARCHIVER: 前缀支持作为备用语法，使用 SHELL: 前缀和空格作为分隔符来指定参数。

注意

不支持将 SHELL: 前缀指定在 ARCHIVER: 前缀的开头以外的任何位置。