apple_yaygın

Sorun bildir Kaynağı görüntüle Nightly · 7.4 . 7.3 · 7.2 · 7.1 · 7.0 · 6.5

Starlark'ın, Apple kural uygulamalarının iç kısımlarına erişmesi için işlevler.

Üyeler

apple_host_system_env

dict apple_common.apple_host_system_env(xcode_config)

Bir Apple ana sistemde derleme araçlarının çalıştırılması gereken işlemler için ayarlanması gereken ortam değişkenlerinin dizisini döndürür (ör. kullanılacak Xcode sürümü). Anahtarlar değişken adları, değerler ise bu değişkenlere karşılık gelen değerlerdir.

Parametreler

Parametre Açıklama
xcode_config zorunlu
Xcode yapılandırması hakkında bilgi içeren bir sağlayıcı.

apple_toolchain

apple_toolchain apple_common.apple_toolchain()

Apple araç zincirindeki öğeleri çözmek için kullanılan yardımcı programlar.

AppleDebugOutputs

Provider apple_common.AppleDebugOutputs

AppleDebugOutputs sağlayıcısının kurucusu/anahtarı.

Bir hedef AppleDebugOutputs sağlayıcısını yayıyorsa bunu, sağlayıcıyı almak için kullanacağınız anahtar olarak kullanın. Örnek:

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

AppleDynamicFramework

Provider apple_common.AppleDynamicFramework

AppleDynamicFramework sağlayıcısının kurucusu/anahtarı.

Bir hedef, AppleDynamicFramework sağlayıcısını yayarsa bunu almak için anahtar olarak kullanın. Örnek:

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

AppleExecutableBinary

Provider apple_common.AppleExecutableBinary

AppleExecutableBinary sağlayıcısının kurucusu/anahtarı.

Bir hedef, AppleExecutableBinary sağlayıcısını yayarsa bunu almak için anahtar olarak kullanın. Örnek:

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

dotted_version

DottedVersion apple_common.dotted_version(version)

Yeni bir DottedVersion örneği oluşturur.

Parametreler

Parametre Açıklama
version required
DottedVersion değerinin dize gösterimi. 

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 platformlarını hedefleyen (potansiyel olarak çoklu mimari) bir ikili programı bağlar. Bu yöntem, rules_apple alanındaki Starlark apple_binary kuralının mantığının büyük bir kısmını içerir ve bağlantı mantığının rules_apple'daki Starlark'a taşınmasına yardımcı olmak için kullanılır.

Bu API son derece deneyseldir ve herhangi bir zamanda değiştirilebilir. Bu işlevin şu anda kararlı olduğunu varsaymayın.

Parametreler

Parametre Açıklama
required
Starlark kural bağlamı.
Hedef dizisi veya None; varsayılan değer None
İkilinin bağımlılık grafiğinde bulunan ancak kitaplıkları ikiliye bağlanmaması gereken Target'lerin listesi. Bu durum, paket yükleyici veya bu ikili program tarafından yüklenecek dinamik kitaplıklar/çerçeveler gibi çalışma zamanında başka bir görüntüde bulunacak bağımlılıklar için geçerlidir.
Dize dizisi; varsayılan değer []
Bağlantılayıcı işlemine iletilecek ek bağlantı seçenekleri.
Dosya dizisi; varsayılan değer []
Bağlantılayıcı işlemine iletilecek ek dosyalar.
Dize dizisi; varsayılan değer []
Bağlantı oluşturucu işlemine iletilecek ek istenen özellikler.
Dize dizisi; varsayılan değer []
Bağlantılayıcı işlemine iletilecek ek devre dışı bırakılmış özellikler.
varsayılan ayar -1 şeklindedir
Derleme bilgilerinin bağlı ikili programa dahil edilip edilmeyeceğini belirler. 1 ise derleme bilgileri her zaman dahil edilir. 0 ise derleme bilgileri her zaman hariç tutulur. -1 ise (varsayılan) davranış, --[no]damga işaretiyle belirlenir. Test kuralları için yürütülebilir çıktı oluşturulurken bu değer 0 olarak ayarlanmalıdır. 

struct apple_common.link_multi_arch_static_library(ctx)

Apple platformlarını hedefleyen (muhtemelen çok mimarili) statik bir kitaplığı bağlar. Bu yöntem, rules_apple alanındaki Starlark apple_static_library kural mantığının bir parçasını kapsar ve rules_apple'daki bağlantı mantığının Starlark'a taşınmasına yardımcı olmak amacıyla oluşturulmuştur.

Bu API son derece deneyseldir ve herhangi bir zamanda değiştirilebilir. Şu anda bu işlevin kararlılığına güvenmeyin.

Parametreler

Parametre Açıklama
required
Starlark kural bağlamı.

new_dynamic_framework_provider

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

Yeni bir AppleDynamicFramework sağlayıcı örneği oluşturur.

Parametreler

Parametre Açıklama
binary Dosya veya None; varsayılan değer None
Dinamik çerçevenin dylib ikili yapısını belirtir.
cc_info varsayılan değer None'tir.
İkili plana bağlı geçişli bağımlılıklar hakkında bilgiler içeren CcInfo.
objc varsayılan ayar None
İkili plana bağlı geçişli bağımlılıklar hakkında bilgiler içeren bir ObjcProvider'dır.
framework_dirs Dize depset veya None; varsayılan değer None
Dinamik çerçeveye bağlantı oluşturmak için bağlantı girişi olarak kullanılan çerçeve yolu adları.
framework_files Dosya depset veya None; varsayılan değer None
Dinamik çerçeveye bağlanmak için giriş olarak dahil edilmesi gereken tüm yapıların kümesi

new_executable_binary_provider

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

Yeni bir AppleExecutableBinaryInfo sağlayıcı örneği oluşturur.

Parametreler

Parametre Açıklama
binary Dosya veya None; varsayılan değer None
Yürütülebilir dosyanın ikili yapısı.
cc_info varsayılan değer None
İkiliye bağlı geçişli bağımlılıklarla ilgili bilgileri içeren bir CcInfo.
objc varsayılan değer None
İkiliye bağlı geçişli bağımlılıklarla ilgili bilgileri içeren bir ObjcProvider.

new_objc_provider

ObjcProvider apple_common.new_objc_provider(**kwargs)

Yeni bir ObjcProvider örneği oluşturur.

Parametreler

Parametre Açıklama
kwargs varsayılan değer {}
Parametre dizini.

Objc

Provider apple_common.Objc

Objc sağlayıcısının kurucusu/anahtarı.

Bir hedef, Objc sağlayıcısını yayarsa bunu almak için anahtar olarak kullanın. Örnek:

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

platform

struct apple_common.platform

Apple platformlarına karşılık gelen aşağıdaki alanları içeren bir enum benzeri yapı:
  • ios_device
  • ios_simulator
  • macos
  • tvos_device
  • tvos_simulator
  • visionos_device
  • visionos_simulator
  • watchos_device
  • watchos_simulator

Bu değerler, bir platform beklenen XcodeVersionConfig.sdk_version_for_platform gibi yöntemlere iletilebilir.

platform_type

struct apple_common.platform_type

Apple platform türlerine karşılık gelen aşağıdaki alanları içeren bir enum benzeri yapı:
  • ios
  • macos
  • tvos
  • visionos
  • watchos

Bu değerler, "apple" yapılandırma parçasının multi_arch_platform yöntemi gibi bir platform türü bekleyebilecek yöntemlere iletilebilir.

Örnek:

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

target_apple_env

dict apple_common.target_apple_env(xcode_config, platform)

Belirtilen Apple platform türünün hedeflerini oluşturan işlemler için ayarlanması gereken ortam değişkenlerinin dict değerini döndürür. Örneğin, bu sözlükte platform adını ve derleme işleminin yapılacağı SDK sürümünü belirten değişkenler bulunur. Anahtarlar değişken adları, değerler ise bu değişkenlere karşılık gelen değerlerdir.

Parametreler

Parametre Açıklama
xcode_config zorunlu
Xcode yapılandırması hakkında bilgi içeren bir sağlayıcı.
platform required
Apple platformu.

XcodeProperties

Provider apple_common.XcodeProperties

XcodeVersionProperties sağlayıcısının oluşturucusu/anahtarı.

Bir hedef XcodeVersionProperties sağlayıcısını yayıyorsa bunu, sağlayıcıyı almak için kullanacağınız anahtar olarak kullanın. Örnek:

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

XcodeVersionConfig

Provider apple_common.XcodeVersionConfig

XcodeVersionConfig sağlayıcısının oluşturucusu/anahtarı.