apple_common

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

成员

apple_host_system_env

dict apple_common.apple_host_system_env(xcode_config)

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

参数

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

apple_toolchain

unknown apple_common.apple_toolchain()

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

dotted_version

DottedVersion apple_common.dotted_version(version)

创建新的 DottedVersion 实例。

参数

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

平台

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 提供程序的构造函数/键。