Apple 一般

Nightly · 8.4 · 8.3 · 8.2 · 8.1 · 8.0 · 7.6
Starlark 函式，用於存取 Apple 規則實作的內部項目。

成員

apple_host_system_env

dict apple_common.apple_host_system_env(xcode_config)

傳回環境變數的 dict，這些變數應針對需要在 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 的字串表示法。

platform

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」設定片段的 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 提供者的建構函式/金鑰。