apple_common

供 Starlark 访问 Apple 规则实现内部的函数。

成员

• apple_host_system_env
• apple_toolchain
• AppleDebugOutputs
• AppleDynamicFramework
• AppleExecutableBinary
• dotted_version
• link_multi_arch_binary
• link_multi_arch_static_library
• new_dynamic_framework_provider
• new_executable_binary_provider
• new_objc_provider
• Objc
• 平台
• platform_type
• target_apple_env
• XcodeProperties
• XcodeVersionConfig

apple_host_system_env

dict apple_common.apple_host_system_env(xcode_config)

返回一个字典，其中包含需要在 Apple 主机系统上运行构建工具的操作应设置的环境变量，例如应使用的 Xcode 版本。键是变量名称，值是相应的值。

参数

参数	说明
xcode_config	必需 包含有关 Xcode 配置信息的提供程序。

apple_toolchain

apple_toolchain apple_common.apple_toolchain()

用于解析 Apple 工具链中的项目的实用程序。

AppleDebugOutputs

Provider apple_common.AppleDebugOutputs

AppleDebugOutputs 提供程序的构造函数/键。

如果目标传播 AppleDebugOutputs 提供程序，请使用此值作为检索它的键。示例：

dep = ctx.attr.deps[0]
p = dep[apple_common.AppleDebugOutputs]

AppleDynamicFramework

Provider apple_common.AppleDynamicFramework

AppleDynamicFramework 提供程序的构造函数/键。

如果目标传播 AppleDynamicFramework 提供程序，请使用此值作为检索它的键。示例：

dep = ctx.attr.deps[0]
p = dep[apple_common.AppleDynamicFramework]

AppleExecutableBinary

Provider apple_common.AppleExecutableBinary

AppleExecutableBinary 提供程序的构造函数/键。

如果目标传播 AppleExecutableBinary 提供程序，请使用此值作为检索它的键。示例：

dep = ctx.attr.deps[0]
p = dep[apple_common.AppleExecutableBinary]

dotted_version

DottedVersion apple_common.dotted_version(version)

创建新的 DottedVersion 实例。

参数

参数	说明
version	必需 DottedVersion 的字符串表示形式。

link_multi_arch_binary

struct apple_common.link_multi_arch_binary(ctx, avoid_deps=None, extra_linkopts=[], extra_link_inputs=[], extra_requested_features=[], extra_disabled_features=[], stamp=-1)

链接以 Apple 平台为目标平台的（可能是多架构）二进制文件。此方法包含 rules_apple 领域中 Starlark apple_binary 规则的大部分逻辑，旨在帮助将其关联逻辑迁移到 rules_apple 中的 Starlark。

此 API 仍处于高度实验阶段，随时可能会发生变化。目前，请勿依赖此函数的稳定性。

参数

参数	说明
ctx	必需 Starlark 规则上下文。
avoid_deps	序列 目标；或 None； 默认值为 None 二进制文件的依赖关系图中包含的 Target 的列表，但这些库不应链接到二进制文件中。对于将在运行时在另一个映像中找到的依赖项（例如软件包加载器或将由此二进制文件加载的任何动态库/框架），情况就是如此。
extra_linkopts	字符串的序列；默认值为 [] 要传递给链接器操作的额外 linkopts。
extra_link_inputs	文件的序列； 默认值为 [] 要传递给链接器操作的额外文件。
extra_requested_features	字符串的序列；默认值为 [] 要传递给链接器操作的额外请求功能。
extra_disabled_features	字符串的序列；默认值为 [] 要传递给链接器操作的额外已停用功能。
stamp	默认值为 -1 是否在关联的二进制文件中包含 build 信息。如果值为 1，则始终包含 build 信息。如果值为 0，则始终排除 build 信息。如果值为 -1（默认值），则行为由 --[no]stamp 标志决定。在为测试规则生成可执行输出时，此值应设置为 0。

link_multi_arch_static_library

struct apple_common.link_multi_arch_static_library(ctx)

关联面向 Apple 平台的（可能为多架构）静态库。此方法是 Starlark apple_static_library 规则逻辑的一部分，位于 rules_apple 网域中，旨在帮助将链接逻辑迁移到 rules_apple 中的 Starlark。

此 API 仍处于高度实验阶段，随时可能会发生变化。目前，请勿依赖此函数的稳定性。

参数

参数	说明
ctx	必需 Starlark 规则上下文。

new_dynamic_framework_provider

AppleDynamicFramework apple_common.new_dynamic_framework_provider(binary=None, cc_info=None, objc=None, framework_dirs=None, framework_files=None)

创建新的 AppleDynamicFramework 提供程序实例。

参数

参数	说明
binary	文件；或 None； 默认值为 None 动态框架的 dylib 二进制制品。
cc_info	默认值为 None 一个 CcInfo，其中包含链接到二进制文件的传递依赖项的相关信息。
objc	默认值为 None 一个 ObjcProvider，其中包含有关链接到二进制文件的传递依赖项的信息。
framework_dirs	字符串的 depset；或 None； 默认值为 None 用作链接输入的框架路径名称，以便与动态框架进行链接。
framework_files	File 的 depset；或 None； 默认值为 None 应作为输入包含在内以链接到动态框架的完整工件集

new_executable_binary_provider

AppleExecutableBinary apple_common.new_executable_binary_provider(binary=None, cc_info=None, objc=None)

创建新的 AppleExecutableBinaryInfo 提供程序实例。

参数

参数	说明
binary	文件；或 None； 默认值为 None 可执行文件的二进制制品。
cc_info	默认值为 None 一个 CcInfo，其中包含链接到二进制文件的传递依赖项的相关信息。
objc	默认值为 None 一个 ObjcProvider，其中包含有关链接到二进制文件的传递依赖项的信息。

new_objc_provider

ObjcProvider apple_common.new_objc_provider(**kwargs)

创建新的 ObjcProvider 实例。

参数

参数	说明
kwargs	默认值为 {} 实参字典。

Objc

Provider apple_common.Objc

Objc 提供程序的构造函数/键。

如果目标传播 Objc 提供程序，请使用此值作为检索它的键。示例：

dep = ctx.attr.deps[0]
p = dep[apple_common.Objc]

平台

struct apple_common.platform

一个类似枚举的结构，包含与 Apple 平台对应的以下字段：

• ios_device
• ios_simulator
• macos
• tvos_device
• tvos_simulator
• visionos_device
• visionos_simulator
• watchos_device
• watchos_simulator

这些值可以传递给需要平台的相应方法，例如 XcodeVersionConfig.sdk_version_for_platform。

platform_type

struct apple_common.platform_type

一种类似枚举的结构，包含与 Apple 平台类型对应的以下字段：

• ios
• macos
• tvos
• visionos
• watchos

这些值可以传递给需要平台类型的方法，例如“apple”配置 fragment 的 multi_arch_platform 方法。

示例：

ctx.fragments.apple.multi_arch_platform(apple_common.platform_type.ios)

target_apple_env

dict apple_common.target_apple_env(xcode_config, platform)

返回一个 dict，其中包含应针对构建给定 Apple 平台类型目标的操作设置的环境变量。例如，此字典包含用于表示要构建的平台名称和 SDK 版本的变量。键是变量名称，值是相应的值。

参数

参数	说明
xcode_config	必需 包含有关 Xcode 配置信息的提供程序。
platform	必需 Apple 平台。

XcodeProperties

Provider apple_common.XcodeProperties

XcodeVersionProperties 提供程序的构造函数/键。

如果目标传播 XcodeVersionProperties 提供程序，请使用此值作为检索它的键。示例：

dep = ctx.attr.deps[0]
p = dep[apple_common.XcodeVersionProperties]

XcodeVersionConfig

Provider apple_common.XcodeVersionConfig

XcodeVersionConfig 提供程序的构造函数/键。