cmake：Properties on Targets

谁借莪１个温暖的怀抱￠ 2022-10-11 13:56 12阅读 0赞

# ADDITIONAL\_CLEAN\_FILES #

3.15新版功能。

将作为全局clean目标的一部分被删除的文件或目录列表。它可以用来指定作为构建目标的一部分生成的文件和目录，或者以某种方式与目标直接关联的文件和目录(例如，作为运行目标的结果创建的文件和目录)。

对于自定义目标，如果这类文件可以作为输出或副产品捕获，那么应该优先将它们添加到此属性。如果一个额外的干净文件被多个目标使用，或者不是特定于目标的，那么ADDITIONAL\_CLEAN\_FILES目录属性可能是更适合使用的属性。

相对路径是允许的，并且是相对于当前二进制目录来解释的。

ADDITIONAL\_CLEAN\_FILES的内容可以使用生成器表达式。

这个属性只适用于Ninja和Makefile生成器。其他生成器会忽略它

# AIX\_EXPORT\_ALL\_SYMBOLS #

3.17新版功能。

在AIX上，CMake使用ENABLE\_EXPORTS目标属性集从共享库和可执行文件中自动导出所有符号。显式禁用此布尔属性以禁用该行为，默认情况下不导出任何符号。在这种情况下，预计项目将使用其他方法导出一些符号。

如果在创建目标时设置了CMAKE\_AIX\_EXPORT\_ALL\_SYMBOLS变量，则该属性由该变量的值初始化。

# ALIAS\_GLOBAL #

3.18新版功能。

只读属性，指示ALIAS目标是否全局可见。

对于使用add\_executable()或add\_library()全局选项创建的导入目标的别名，此属性的布尔值为TRUE，否则为FALSE。对于在项目中构建的目标，它是未定义的。

注意通过改变值或IMPORTED\_GLOBAL目标属性将导入的目标从LOCAL作用域提升到GLOBAL作用域不会改变本地别名的作用域。

# ALIASED\_TARGET #

以此目标为别名的目标名称。

如果这是别名目标，则此属性包含别名目标的名称。

# ARCHIVE\_OUTPUT\_DIRECTORY #

要在其中构建ARCHIVE目标文件的输出目录。

此属性指定应该在其中构建存档目标文件的目录。属性值可以使用生成器表达式。多配置生成器(Visual Studio, Xcode, Ninja Multi-Config)在指定的目录下附加每个配置的子目录，除非使用了一个生成器表达式。

如果在创建目标时设置了CMAKE\_ARCHIVE\_OUTPUT\_DIRECTORY变量，则该属性由该变量的值初始化。

参见ARCHIVE\_OUTPUT\_DIRECTORY\_< CONFIG >目标属性。

# ARCHIVE\_OUTPUT\_DIRECTORY\_< CONFIG > #

ARCHIVE目标文件的每个配置输出目录。

这是ARCHIVE\_OUTPUT\_DIRECTORY目标属性的按配置版本，但是多配置生成器(VS, Xcode)不会将按配置的子目录附加到指定的目录。如果在创建目标时设置了CMAKE\_ARCHIVE\_OUTPUT\_DIRECTORY\_< CONFIG >变量的值，则该属性被初始化。

ARCHIVE\_OUTPUT\_DIRECTORY\_< CONFIG >的内容可以使用生成器表达式。

# ARCHIVE\_OUTPUT\_NAME #

ARCHIVE目标文件的输出名称。

此属性指定归档目标文件的基本名称。它覆盖OUTPUT\_NAME和OUTPUT\_NAME\_< CONFIG >属性。

参见ARCHIVE\_OUTPUT\_NAME\_< CONFIG >目标属性。

# ARCHIVE\_OUTPUT\_NAME\_< CONFIG> #

ARCHIVE目标文件的每个配置输出名称。

这是ARCHIVE\_OUTPUT\_NAME目标属性的特定配置版本

# BINARY\_DIR #

3.4新版功能。

这个只读属性报告定义目标的目录中CMAKE\_CURRENT\_BINARY\_DIR变量的值。

# BUILD\_RPATH #

3.8新版功能。

分号分隔的列表，指定要添加到构建树中链接的二进制文件中的运行时路径(RPATH)项(用于支持它的平台)。这些条目将不会用于安装树中的二进制文件。请参见INSTALL\_RPATH目标属性。

如果在创建目标时设置了该属性，则该属性由变量CMAKE\_BUILD\_RPATH的值初始化。

此属性支持生成器表达式。

# BUILD\_RPATH\_USE\_ORIGIN #

3.14新版功能。

是否为构建RPATH使用相对路径。

这个属性由变量CMAKE\_BUILD\_RPATH\_USE\_ORIGIN的值初始化。

在使用$ORIGIN令牌支持运行时路径(RPATH)的平台上，将此属性设置为TRUE将启用构建RPATH中指向同一构建树中的共享库的可执行程序和共享库的相对路径。

通常，二进制文件的构建RPATH包含它所链接到的每个共享库目录的绝对路径。构建树中包含的目录的RPATH条目可以是相对的，以支持可重定位的构建，并通过从构建环境中省略构建目录来帮助实现可重复的构建。

对于RPATH中不支持$ORIGIN令牌的平台或设置了CMAKE\_SKIP\_RPATH变量的平台，此属性没有影响。通过BUILD\_RPATH目标属性设置的运行时路径也不受此属性的影响。

# BUILD\_WITH\_INSTALL\_NAME\_DIR #

3.9新版功能。

BUILD\_WITH\_INSTALL\_NAME\_DIR是一个布尔值，指定构建树中目标的macOS install\_name是否使用INSTALL\_NAME\_DIR给出的目录。此设置仅适用于macOS上的目标。

如果在创建目标时设置了该属性，则该属性由变量CMAKE\_BUILD\_WITH\_INSTALL\_NAME\_DIR的值初始化。

如果未设置此属性，且策略CMP0068不是NEW，则使用BUILD\_WITH\_INSTALL\_RPATH的值代替。

# BUILD\_WITH\_INSTALL\_RPATH #

BUILD\_WITH\_INSTALL\_RPATH是一个布尔值，指定是否将构建树中的目标与INSTALL\_RPATH链接起来。这优先于SKIP\_BUILD\_RPATH，并避免了在安装之前重新链接的需要。

如果在创建目标时设置了CMAKE\_BUILD\_WITH\_INSTALL\_RPATH变量，则该属性由它的值初始化。

如果策略CMP0068不是NEW，这个属性还控制在macOS的构建树中INSTALL\_NAME\_DIR的使用。无论哪种方式，BUILD\_WITH\_INSTALL\_NAME\_DIR目标属性优先。

# BUNDLE #

这个目标是macOS上的一个CFBundle。

如果一个模块库目标将此属性设置为true，那么当在mac上构建时，它将被构建为CFBundle。它将具有CFBundle所需的目录结构，并且将适合用于创建浏览器插件或其他应用程序资源。

# BUNDLE\_EXTENSION #

用于命名macOS和iOS上的BUNDLE、框架或MACOSX\_BUNDLE目标的文件扩展名。

对于各自的目标类型，默认值是bundle、framework或app。

# C\_EXTENSIONS #

cmake：Properties on Targets

发表评论取消回复

还没有评论，来说两句吧...

相关阅读

相关 need to invoke method 'taskExecute' declared on target class 'ShareEquallyTaskServiceImpl', but not

相关 Oracle 11g报错"ORA-00845: MEMORY_TARGET not supported on this system"

相关 @Target

相关 oracle启动报错：MEMORY_TARGET not supported on this system

相关 cmake：Properties on Targets

相关 Oracle study之--“ORA-00845: MEMORY_TARGET not supported on this system"错误

相关 memory_target not support on this system(oracle11g)

相关 eclipse svn 忽略 target目录 and so on (zz)

相关 Cocoapods 报警告Automatically assigning platform ios with version 9.0 on target....

相关 oracle11g startup 报错ORA-00845: MEMORY_TARGET not supported on this system