Apple_common

Funções para o Starlark acessar elementos internos das implementações de regras da Apple.

Membros

apple_host_system_env

dict apple_common.apple_host_system_env(xcode_config)

Retorna um dicionário de variáveis de ambiente que precisam ser definidas para ações que precisam executar ferramentas de build em um sistema host da Apple, como a versão do Xcode que precisa ser usada. As chaves são nomes de variáveis e os valores são os correspondentes.

Parâmetros

Parâmetro Descrição
xcode_config obrigatório
Um provedor que contém informações sobre a configuração do Xcode.

apple_toolchain

unknown apple_common.apple_toolchain()

Utilitários para resolver itens do conjunto de ferramentas da Apple.

dotted_version

DottedVersion apple_common.dotted_version(version)

Cria uma nova instância de DottedVersion.

Parâmetros

Parâmetro Descrição
version string; obrigatório
A representação de string da DottedVersion.

platform

struct apple_common.platform

Uma estrutura semelhante a um enum que contém os seguintes campos correspondentes às plataformas da Apple:
  • ios_device
  • ios_simulator
  • macos
  • tvos_device
  • tvos_simulator
  • visionos_device
  • visionos_simulator
  • watchos_device
  • watchos_simulator

Esses valores podem ser transmitidos a métodos que esperam uma plataforma, como XcodeVersionConfig.sdk_version_for_platform.

platform_type

struct apple_common.platform_type

Uma estrutura semelhante a um enum que contém os seguintes campos correspondentes aos tipos de plataforma da Apple:
  • ios
  • macos
  • tvos
  • visionos
  • watchos

Esses valores podem ser transmitidos a métodos que esperam um tipo de plataforma, como o método multi_arch_platform do fragmento de configuração "apple".

Exemplo:

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

target_apple_env

dict apple_common.target_apple_env(xcode_config, platform)

Retorna um dict de variáveis de ambiente que precisam ser definidas para ações que criam destinos do tipo de plataforma da Apple especificado. Por exemplo, esse dicionário contém variáveis que denotam o nome da plataforma e a versão do SDK com que criar. As chaves são nomes de variáveis e os valores são os correspondentes.

Parâmetros

Parâmetro Descrição
xcode_config obrigatório
Um provedor que contém informações sobre a configuração do Xcode.
platform obrigatório
A plataforma da Apple.

XcodeProperties

Provider apple_common.XcodeProperties

O construtor/chave do XcodeVersionProperties provedor.

Se um destino propagar o provedor XcodeVersionProperties, use-o como a chave para recuperá-lo. Exemplo:

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

XcodeVersionConfig

Provider apple_common.XcodeVersionConfig

O construtor/chave do provedor XcodeVersionConfig.