Starlark 用來存取 Apple 規則實作項目內部資訊的函式。
成員
- apple_host_system_env
- apple_toolchain
- dotted_version
- platform
- 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
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
|
required Apple 平台。 |
XcodeProperties
Provider apple_common.XcodeProperties
XcodeVersionProperties
供應器的建構函式/鍵。如果目標會傳播 XcodeVersionProperties
供應器,請使用這個做為擷取的索引鍵。示例:
dep = ctx.attr.deps[0] p = dep[apple_common.XcodeVersionProperties]
XcodeVersionConfig
Provider apple_common.XcodeVersionConfig
XcodeVersionConfig
供應器的建構函式/鍵。