apple_yaygın

Starlark'ın Apple kuralı uygulamalarının iç kısımlarına erişmesini sağlayan işlevler.

Üyeler

apple_host_system_env

dict apple_common.apple_host_system_env(xcode_config)

Apple ana bilgisayar sisteminde derleme araçlarının çalıştırılması gereken işlemler için ayarlanması gereken ortam değişkenlerinin dict değerini döndürür. Örneğin, kullanılacak Xcode sürümü. Anahtarlar değişken adları, değerler ise bunlara karşılık gelen değerlerdir.

Parametreler

Parametre Açıklama
xcode_config required
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 çözmeye yönelik yardımcı programlar.

AppleDebugOutputs

Provider apple_common.AppleDebugOutputs

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

Bir hedef AppleDebugOutputs sağlayıcısını yayarsa bunu almak için 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 oluşturucusu/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 oluşturucusu/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
Noktalı sürümün dize gösterimi. 

struct apple_common.link_multi_arch_binary(ctx, avoid_deps=None, extra_linkopts=[], extra_link_inputs=[], stamp=-1)

Apple platformlarını hedefleyen (potansiyel olarak çok mimarili) bir ikiliyi 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ı oluşturur 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. Şu anda bu işlevin kararlılığına güvenmeyin.

Parametreler

Parametre Açıklama
gerekli
Starlark kuralı bağlamı.
sequence of Targets; or None; varsayılan = Yok
İkili programın bağımlılık grafiğinde bulunan ancak kitaplıkları ikili programa bağlanmaması gereken Target'lerin listesi. Bu durum, paket yükleyici veya bu ikili tarafından yüklenecek dinamik kitaplıklar/çerçeveler gibi, çalışma zamanında başka bir resimde bulunacak bağımlılıklar için geçerlidir.
sequence of strings; default = []
Bağlayıcı işlemine iletilecek ek bağlantı seçenekleri.
sequence of Files; default = []
Bağlayıcı işlemine iletilecek ek dosyalar.
varsayılan = -1
Bağlı ikili dosyaya derleme bilgilerinin dahil edilip edilmeyeceği. 1 ise derleme bilgileri her zaman dahil edilir. 0 ise derleme bilgileri her zaman hariç tutulur. -1 (varsayılan) ise davranış, --[no]stamp işaretiyle belirlenir. Bu, test kuralları için yürütülebilir çıkış oluşturulurken 0 olarak ayarlanmalıdır. 

struct apple_common.link_multi_arch_static_library(ctx)

Apple platformlarını hedefleyen (potansiyel olarak çok mimarili) statik bir kitaplığı bağlar. Bu yöntem, rules_apple alanındaki Starlark apple_static_library kural mantığının bir bölümünü oluşturur 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. Şu anda bu işlevin kararlılığına güvenmeyin.

Parametreler

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

multi_arch_split

SplitTransitionProviderApi apple_common.multi_arch_split

Kural özelliklerinin, bir veya daha fazla Apple platformunda bağımlılık oluşturmak için yapılandırma geçişi.

Bu geçişin kullanılabilmesi için kuralda "platform_type" ve "minimum_os_version" dize özelliklerinin tanımlanması ve zorunlu olması gerekir.

platform_type özelliğinin değeri, bu yapılandırma geçişi boyunca bağımlılıkların oluşturulacağı hedef mimarileri belirler.

Şu seçenekleri kullanabilirsiniz:

  • ios: --ios_multi_cpus kaynağından toplanan mimariler.
  • macos: --macos_cpus kaynağından toplanan mimariler.
  • tvos: --tvos_cpus kaynağından toplanan mimariler.
  • watchos: --watchos_cpus kaynağından toplanan mimariler.

minimum_os_version, "7.3" gibi noktalı bir sürüm dizesi olmalıdır ve yapılandırmada platform türüne benzer şekilde minimum işletim sistemini ayarlamak için kullanılır. Örneğin, platform_type "ios" ve minimum_os_version "8.0" değerlerini belirtmek, bağımlılıkların minimum iOS sürümü "8.0" ile oluşturulmasını sağlar.

new_dynamic_framework_provider

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

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

Parametreler

Parametre Açıklama
binary File; or None; default = None
Dinamik çerçevenin dylib ikili program yapısı.
cc_info default = None
İkiliye bağlanan geçişli bağımlılıklar hakkında bilgi içeren bir CcInfo.
objc gerekli
İkiliye bağlanan geçişli bağımlılıklar hakkında bilgi içeren bir ObjcProvider.
framework_dirs depset of strings; or None; default = None
Dinamik çerçeveye bağlanmak için bağlantı girişleri olarak kullanılan çerçeve yolu adları.
framework_files depset of Files; or None; varsayılan = Yok
Dinamik çerçeveye karşı bağlantı oluşturmak için giriş olarak dahil edilmesi gereken tüm yapılar

new_executable_binary_provider

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

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

Parametreler

Parametre Açıklama
binary File; or None; varsayılan = Yok
Yürütülebilir dosyanın ikili yapısı.
cc_info default = None
İkiliye bağlanan geçişli bağımlılıklar hakkında bilgi içeren bir CcInfo.
objc gerekli
İkiliye bağlanan geçişli bağımlılıklar hakkında bilgi 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 default = {}
Bağımsız değişkenlerin sözlüğü.

Objc

Provider apple_common.Objc

Objc sağlayıcısının oluşturucusu/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 enum benzeri bir yapı:
  • ios_device
  • ios_simulator
  • macos
  • tvos_device
  • tvos_simulator
  • watchos_device
  • watchos_simulator

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

platform_type

struct apple_common.platform_type

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

Bu değerler, platform türü bekleyen yöntemlere (ör. "apple" yapılandırma parçasının multi_arch_platform yöntemi) aktarılabilir.

Örnek:

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

target_apple_env

dict apple_common.target_apple_env(xcode_config, platform)

Belirli Apple platformu 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 derleme için kullanılacak platform adını ve SDK sürümünü belirten değişkenler bulunur. Anahtarlar değişken adları, değerler ise bunlara karşılık gelen değerlerdir.

Parametreler

Parametre Açıklama
xcode_config required
Xcode yapılandırması hakkında bilgi içeren bir sağlayıcı.
platform zorunlu
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ı yayarsa bunu almak için 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ı.