Objective-C 规则

报告问题查看源代码 Nightly · 8.3 · 8.2 · 8.1 · 8.0 · 7.6 

规则

objc_import
objc_library

objc_import

objc_import(name, deps, hdrs, alwayslink, archives, compatible_with, deprecation, exec_compatible_with, exec_group_compatible_with, exec_properties, features, includes, package_metadata, restricted_to, sdk_dylibs, sdk_frameworks, sdk_includes, tags, target_compatible_with, testonly, textual_hdrs, toolchains, visibility, weak_sdk_frameworks)

此规则以 .a 文件的形式封装已编译的静态库。它还允许使用 objc_library 支持的相同属性导出标头和资源。

参数

属性
`name`	名称；必需相应目标的唯一名称。
`deps`	标签列表；默认值为 `[]` 相应目标所依赖的目标列表。
`hdrs`	标签列表；默认值为 `[]` 此库发布的 C、C++、Objective-C 和 Objective-C++ 头文件列表，供依赖规则中的来源包含。这些头文件描述了库的公共接口，并且可供相应规则或依赖规则中的来源包含。不打算由相应库的客户端包含的标头应改为在 srcs 属性中列出。如果启用了模块，这些内容将与源代码分开编译。
`alwayslink`	布尔值；默认值为 `False` 如果值为 1，则任何直接或间接依赖于此库的软件包或二进制文件都将链接到 `srcs` 和 `non_arc_srcs` 中列出的文件的所有对象文件，即使有些对象文件不包含二进制文件引用的任何符号也是如此。如果您的代码未被二进制文件中的代码显式调用，例如，如果您的代码注册为接收由某个服务提供的回调，则此功能非常有用。
`archives`	标签列表；必需提供给依赖于此目标的 Objective-C 目标的 `.a` 文件列表。
`includes`	字符串列表；默认值为 `[]` 要添加到此目标及其所有依赖目标的 `#include/#import` 搜索路径的列表。这是为了支持未在其 `#import/#include` 语句中指定完整工作区路径的第三方库和开源库。系统会相对于软件包目录来解读这些路径，并且除了实际的客户端根目录之外，还会包含 genfiles 和 bin 根目录（例如 `blaze-genfiles/pkg/includedir` 和 `blaze-out/pkg/includedir`）。与 COPTS 不同，这些标志会添加到相应规则以及依赖于该规则的每个规则中。（注意：不是它所依赖的规则！）请务必谨慎操作，因为这可能会产生深远的影响。如果不确定，请改为向 COPTS 添加“-iquote”标志。
`sdk_dylibs`	字符串列表；默认值为 `[]` 要关联的 SDK .dylib 库的名称。例如，“libz”或“libarchive”。如果二进制文件在其依赖树中包含任何 C++ 或 Objective-C++ 源，“libc++”会自动包含在内。在关联二进制文件时，系统会使用该二进制文件的传递依赖关系图中命名的所有库。
`sdk_frameworks`	字符串列表；默认值为 `[]` 要关联的 SDK 框架的名称（例如“AddressBook”“QuartzCore”）。关联顶级 Apple 二进制文件时，该二进制文件的传递依赖关系图中列出的所有 SDK 框架都会被关联。
`sdk_includes`	字符串列表；默认值为 `[]` 要添加到此目标及其所有依赖目标的 `#include/#import` 搜索路径的列表，其中每个路径都相对于 `$(SDKROOT)/usr/include`。
`textual_hdrs`	标签列表；默认值为 `[]` 此规则中的源文件或此库的用户作为头文件包含的 C、C++、Objective-C 和 Objective-C++ 文件列表。与 hdrs 不同，这些不会与来源分开编译。
`weak_sdk_frameworks`	字符串列表；默认值为 `[]` 要弱链接的 SDK 框架的名称。例如，“MediaAccessibility”。与常规关联的 SDK 框架不同，如果弱关联的框架中的符号在运行时不存在，则不会导致错误。

objc_library

查看规则来源

objc_library(name, deps, srcs, data, hdrs, alwayslink, compatible_with, conlyopts, copts, cxxopts, defines, deprecation, enable_modules, exec_compatible_with, exec_group_compatible_with, exec_properties, features, implementation_deps, includes, linkopts, module_map, module_name, non_arc_srcs, package_metadata, pch, restricted_to, sdk_dylibs, sdk_frameworks, sdk_includes, stamp, tags, target_compatible_with, testonly, textual_hdrs, toolchains, visibility, weak_sdk_frameworks)

此规则可根据给定的 Objective-C 源文件生成静态库。

参数

属性
`name`	名称；必需相应目标的唯一名称。
`deps`	标签列表；默认值为 `[]` 相应目标所依赖的目标列表。
`srcs`	标签列表；默认值为 `[]` 要处理以创建库目标的 C、C++、Objective-C 和 Objective-C++ 源文件和头文件，以及/或者 (`.s`、`.S` 或 `.asm`) 汇编源文件的列表。这些是您已签入的文件，以及所有生成的文件。源文件使用 Clang 编译为 .o 文件。此目标的 srcs 属性中的任何源或头文件都可以包含/导入头文件，但 hdrs 中的头文件或依赖于此规则的任何目标不可以。此外，还可以将预编译的 .o 文件作为 srcs 提供。请务必确保所提供的 .o 文件的架构与 build 的架构保持一致，以避免出现符号链接器错误。
`hdrs`	标签列表；默认值为 `[]` 此库发布的 C、C++、Objective-C 和 Objective-C++ 头文件列表，供依赖规则中的来源包含。这些头文件描述了库的公共接口，并且可供相应规则或依赖规则中的来源包含。不打算由相应库的客户端包含的标头应改为在 srcs 属性中列出。如果启用了模块，这些内容将与源代码分开编译。
`alwayslink`	布尔值；默认值为 `False` 如果值为 1，则任何直接或间接依赖于此库的软件包或二进制文件都将链接到 `srcs` 和 `non_arc_srcs` 中列出的文件的所有对象文件，即使有些对象文件不包含二进制文件引用的任何符号也是如此。如果您的代码未被二进制文件中的代码显式调用，例如，如果您的代码注册为接收由某个服务提供的回调，则此功能非常有用。
`conlyopts`	字符串列表；默认值为 `[]` 要传递给 C 文件编译器的额外标志。受“创建变量”替换和 Bourne shell 令牌化的影响。这些标志仅适用于此目标，而不适用于依赖于此目标的目标或此目标所依赖的目标。请注意，对于生成的 Xcode 项目，系统会解析出在 copts 中使用“-I”标志指定的目录路径，如果这些路径是相对路径，则会在其前面加上“$(WORKSPACE_ROOT)/”，并将其添加到关联的 Xcode 目标的头文件搜索路径中。
`copts`	字符串列表；默认值为 `[]` 要传递给编译器的额外标志。受“创建变量”替换和 Bourne shell 令牌化的影响。这些标志仅适用于此目标，而不适用于依赖于此目标的目标或此目标所依赖的目标。请注意，对于生成的 Xcode 项目，系统会解析出在 copts 中使用“-I”标志指定的目录路径，如果这些路径是相对路径，则会在其前面加上“$(WORKSPACE_ROOT)/”，并将其添加到关联的 Xcode 目标的头文件搜索路径中。
`cxxopts`	字符串列表；默认值为 `[]` 要传递给编译器（针对 Objective-C++ 和 C++ 文件）的额外标志。受“创建变量”替换和 Bourne shell 令牌化的影响。这些标志仅适用于此目标，而不适用于依赖于此目标的目标或此目标所依赖的目标。请注意，对于生成的 Xcode 项目，系统会解析出在 copts 中使用“-I”标志指定的目录路径，如果这些路径是相对路径，则会在其前面加上“$(WORKSPACE_ROOT)/”，并将其添加到关联的 Xcode 目标的头文件搜索路径中。
`defines`	字符串列表；默认值为 `[]` 要传递给编译器的额外 `-D` 标志。它们应采用 `KEY=VALUE` 或 `KEY` 形式，不仅会传递给相应目标的编译器（与 `copts` 相同），还会传递给相应目标的所有 `objc_` 依赖项。受“创建变量”替换和 Bourne shell 令牌化的影响。
`enable_modules`	布尔值；默认值为 `False` 启用 clang 模块支持（通过 -fmodules）。将此值设置为 1 可让您 @import 系统头文件和其他目标： @import UIKit; @import path_to_package_target;
`implementation_deps`	标签列表；默认值为 `[]` 库目标所依赖的其他库的列表。与 `deps` 不同，这些库（及其所有传递依赖项）的头文件和包含路径仅用于编译相应库，而不用于依赖于这些库的库。使用 `implementation_deps` 指定的库仍会链接到依赖于此库的二进制目标中。
`includes`	字符串列表；默认值为 `[]` 要添加到此目标及其所有依赖目标的 `#include/#import` 搜索路径的列表。这是为了支持未在其 `#import/#include` 语句中指定完整工作区路径的第三方库和开源库。系统会相对于软件包目录来解读这些路径，并且除了实际的客户端根目录之外，还会包含 genfiles 和 bin 根目录（例如 `blaze-genfiles/pkg/includedir` 和 `blaze-out/pkg/includedir`）。与 COPTS 不同，这些标志会添加到相应规则以及依赖于该规则的每个规则中。（注意：不是它所依赖的规则！）请务必谨慎操作，因为这可能会产生深远的影响。如果不确定，请改为向 COPTS 添加“-iquote”标志。
`linkopts`	字符串列表；默认值为 `[]` 要传递给链接器的额外标志。
`module_map`	标签；默认值为 `None` 相应目标的自定义 Clang 模块映射。不建议使用自定义模块映射。大多数用户应使用由 Bazel 生成的模块映射。如果指定了此属性，Bazel 将不会为此目标生成模块映射，而是会将提供的模块映射传递给编译器。
`module_name`	字符串；默认值为 `""` 为此目标设置模块名称。默认情况下，模块名称是目标路径，其中所有特殊符号都替换为 _，例如 //foo/baz:bar 可以作为 foo_baz_bar 导入。
`non_arc_srcs`	标签列表；默认值为 `[]` 处理后用于创建不使用自动引用计数 (ARC) 的库目标文件的 Objective-C 文件列表。此属性中的文件与 srcs 属性中的文件处理方式非常相似，但编译时未启用 ARC。
`pch`	标签；默认值为 `None` 要预先添加到每个正在编译的源文件（包括 ARC 和非 ARC）的头文件。我们强烈建议不要在 BUILD 文件中使用 pch 文件，并且应将此功能视为已废弃。由于 pch 文件实际上并未预编译，因此这并不能提高构建速度，而只是一个全局依赖项。从 build 效率的角度来看，您最好直接在需要的位置将所需内容包含在源代码中。
`sdk_dylibs`	字符串列表；默认值为 `[]` 要关联的 SDK .dylib 库的名称。例如，“libz”或“libarchive”。如果二进制文件在其依赖树中包含任何 C++ 或 Objective-C++ 源，“libc++”会自动包含在内。在关联二进制文件时，系统会使用该二进制文件的传递依赖关系图中命名的所有库。
`sdk_frameworks`	字符串列表；默认值为 `[]` 要关联的 SDK 框架的名称（例如“AddressBook”“QuartzCore”）。关联顶级 Apple 二进制文件时，该二进制文件的传递依赖关系图中列出的所有 SDK 框架都会被关联。
`sdk_includes`	字符串列表；默认值为 `[]` 要添加到此目标及其所有依赖目标的 `#include/#import` 搜索路径的列表，其中每个路径都相对于 `$(SDKROOT)/usr/include`。
`stamp`	布尔值；默认值为 `False`
`textual_hdrs`	标签列表；默认值为 `[]` 此规则中的源文件或此库的用户作为头文件包含的 C、C++、Objective-C 和 Objective-C++ 文件列表。与 hdrs 不同，这些不会与来源分开编译。
`weak_sdk_frameworks`	字符串列表；默认值为 `[]` 要弱链接的 SDK 框架的名称。例如，“MediaAccessibility”。与常规关联的 SDK 框架不同，如果弱关联的框架中的符号在运行时不存在，则不会导致错误。