Apple_सामान्य

समस्या की शिकायत करें सोर्स देखें Nightly · 7.4 . 7.3 · 7.2 · 7.1 · 7.0 · 6.5

Apple के नियमों को लागू करने के अंदरूनी हिस्सों को ऐक्सेस करने के लिए, Starlark के फ़ंक्शन.

सदस्य

apple_host_system_env

dict apple_common.apple_host_system_env(xcode_config)

यह एनवायरमेंट वैरिएबल का dict दिखाता है. इसे उन कार्रवाइयों के लिए सेट किया जाना चाहिए जिन्हें Apple होस्ट सिस्टम पर बिल्ड टूल चलाने की ज़रूरत होती है. जैसे, Xcode का इस्तेमाल किया जाने वाला वर्शन. कुंजियां वेरिएबल के नाम होती हैं और वैल्यू, वेरिएबल की वैल्यू होती हैं.

पैरामीटर

पैरामीटर ब्यौरा
xcode_config ज़रूरी है
सेवा देने वाली कंपनी, जिसके पास xcode कॉन्फ़िगरेशन की जानकारी है.

apple_toolchain

apple_toolchain apple_common.apple_toolchain()

Apple टूलचेन से आइटम हल करने के लिए उपयोगी टूल.

AppleDebugOutputs

Provider apple_common.AppleDebugOutputs

AppleDebugOutputs की सेवा देने वाली कंपनी का कंस्ट्रक्टर/कुंजी.

अगर कोई टारगेट, AppleDebugOutputs सेवा देने वाली कंपनी को लागू करता है, तो इसे वापस पाने के लिए इसे कुंजी के तौर पर इस्तेमाल करें. उदाहरण:

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

AppleDynamicFramework

Provider apple_common.AppleDynamicFramework

AppleDynamicFramework की सेवा देने वाली कंपनी का कंस्ट्रक्टर/कुंजी.

अगर कोई टारगेट, AppleDynamicFramework की सेवा देने वाली कंपनी को प्रॉपेगेट करता है, तो इसे उस कुंजी के तौर पर इस्तेमाल करें जिससे इसे वापस पाया जा सके. उदाहरण:

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

AppleExecutableBinary

Provider apple_common.AppleExecutableBinary

AppleExecutableBinary की सेवा देने वाली कंपनी का कंस्ट्रक्टर/कुंजी.

अगर कोई टारगेट, AppleExecutableBinary की सेवा देने वाली कंपनी को प्रॉपेगेट करता है, तो इसे उस कुंजी के तौर पर इस्तेमाल करें जिससे इसे वापस पाया जा सके. उदाहरण:

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

dotted_version

DottedVersion apple_common.dotted_version(version)

एक नया DottedVersion इंस्टेंस बनाता है.

पैरामीटर

पैरामीटर ब्यौरा
version ज़रूरी है
DottedVersion की स्ट्रिंग के तौर पर. 

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 के प्लैटफ़ॉर्म को टारगेट करने वाले बाइनरी को लिंक करता है. यह बाइनरी, कई आर्किटेक्चर में हो सकती है. इस तरीके में, criteria_apple डोमेन में Starlark apple_binary नियम का ज़्यादातर तर्क शामिल है. साथ ही, यह नियम_apple में Starlark में जोड़ने के लॉजिक को माइग्रेट करने में मदद करने के लिए मौजूद है.

इस एपीआई को बहुत ज़्यादा प्रयोग के तौर पर बनाया गया है और इसमें किसी भी समय बदलाव किया जा सकता है. इस समय इस फ़ंक्शन की स्थिरता पर निर्भर न करें.

पैरामीटर

पैरामीटर ब्यौरा
ज़रूरी है
Starlark नियम का कॉन्टेक्स्ट.
टारगेट का क्रम या None; डिफ़ॉल्ट तौर पर None
उन Target की सूची जो बाइनरी के डिपेंडेंसी ग्राफ़ में मौजूद हैं, लेकिन जिनकी लाइब्रेरी को बाइनरी से लिंक नहीं किया जाना चाहिए. ऐसा उन डिपेंडेंसी के लिए होता है जो किसी दूसरी इमेज में रनटाइम के दौरान मिलती हैं. जैसे, बंडल लोडर या ऐसी कोई डाइनैमिक लाइब्रेरी/फ़्रेमवर्क जो इस बाइनरी से लोड की जाएगी.
स्ट्रिंग का क्रम; डिफ़ॉल्ट तौर पर []
होता है लिंक करने वाली कार्रवाई में पास किए जाने वाले अतिरिक्त लिंकऑप्ट.
फ़ाइल का क्रम; डिफ़ॉल्ट तौर पर, []
होता है लिंकर ऐक्शन को पास करने के लिए अतिरिक्त फ़ाइलें.
स्ट्रिंग का क्रम; डिफ़ॉल्ट रूप से []
होता है लिंकर ऐक्शन को भेजी जाने वाली अतिरिक्त सुविधाएं.
स्ट्रिंग का क्रम; डिफ़ॉल्ट रूप से []
होता है लिंकर ऐक्शन में भेजी जाने वाली अतिरिक्त बंद सुविधाएं.
डिफ़ॉल्ट तौर पर -1
होता है लिंक की गई बाइनरी में बिल्ड की जानकारी शामिल करनी है या नहीं. अगर 1 है, तो बिल्ड की जानकारी हमेशा शामिल की जाती है. अगर यह वैल्यू 0 है, तो बिल्ड की जानकारी को हमेशा शामिल नहीं किया जाता है. अगर -1 (डिफ़ॉल्ट) है, तो --[no]stamp फ़्लैग से व्यवहार तय होता है. टेस्ट नियमों के लिए, लागू किए जा सकने वाले आउटपुट जनरेट करते समय, इसे 0 पर सेट किया जाना चाहिए. 

struct apple_common.link_multi_arch_static_library(ctx)

Apple प्लैटफ़ॉर्म को टारगेट करने वाली (एक से ज़्यादा आर्किटेक्चर वाली) स्टैटिक लाइब्रेरी को लिंक करता है. इस तरीके में, rules_apple डोमेन में Starlark apple_static_library नियम लॉजिक का एक हिस्सा शामिल होता है. यह rules_apple में, लिंकिंग लॉजिक को Starlark में माइग्रेट करने में मदद करने के लिए मौजूद है.

यह एपीआई पूरी तरह से एक्सपेरिमेंट के तौर पर उपलब्ध है और इसमें कभी भी बदलाव किया जा सकता है. फ़िलहाल, इस सुविधा के सही तरीके से काम करने पर भरोसा न करें.

पैरामीटर

पैरामीटर ब्यौरा
ज़रूरी है
Starlark नियम का कॉन्टेक्स्ट.

new_dynamic_framework_provider

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

AppleDynamicFramework प्रोवाइडर का नया इंस्टेंस बनाता है.

पैरामीटर

पैरामीटर ब्यौरा
binary फ़ाइल या None; डिफ़ॉल्ट तौर पर None
डाइनैमिक फ़्रेमवर्क का dylib बाइनरी आर्टफ़ैक्ट.
cc_info डिफ़ॉल्ट None
एक CcInfo, जिसमें बाइनरी से जुड़ी ट्रांज़िशन डिपेंडेंसी की जानकारी होती है.
objc डिफ़ॉल्ट None
एक ObjcProvider, जिसमें बाइनरी से लिंक की गई ट्रांज़िशन डिपेंडेंसी के बारे में जानकारी होती है.
framework_dirs स्ट्रिंग या None की depset; डिफ़ॉल्ट तौर पर None
डाइनैमिक फ़्रेमवर्क से लिंक करने के लिए, लिंक इनपुट के तौर पर इस्तेमाल किए जाने वाले फ़्रेमवर्क पाथ के नाम.
framework_files फ़ाइल का depset या None; डिफ़ॉल्ट रूप से None
आर्टफ़ैक्ट का पूरा सेट, जिसे डाइनैमिक फ़्रेमवर्क से लिंक करने के लिए इनपुट के तौर पर शामिल किया जाना चाहिए

new_executable_binary_provider

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

AppleExecutableBinaryInfo प्रोवाइडर का नया इंस्टेंस बनाता है.

पैरामीटर

पैरामीटर ब्यौरा
binary फ़ाइल या None; डिफ़ॉल्ट रूप से None
होता है यह, एक्सीक्यूटेबल का बाइनरी आर्टफ़ैक्ट होता है.
cc_info डिफ़ॉल्ट None
एक CcInfo, जिसमें बाइनरी से जुड़ी ट्रांज़िशन डिपेंडेंसी की जानकारी होती है.
objc डिफ़ॉल्ट तौर पर, None
एकobjcProvider होता है, जिसमें बाइनरी से लिंक की गई ट्रांज़िटिव डिपेंडेंसी के बारे में जानकारी होती है.

new_objc_provider

ObjcProvider apple_common.new_objc_provider(**kwargs)

नया ObjcProvider इंस्टेंस बनाता है.

पैरामीटर

पैरामीटर ब्यौरा
kwargs डिफ़ॉल्ट रूप से {}
आर्ग्युमेंट की डिक्शनरी.

Objc

Provider apple_common.Objc

Objc की सेवा देने वाली कंपनी का कंस्ट्रक्टर/कुंजी.

अगर कोई टारगेट, Objc की सेवा देने वाली कंपनी को प्रॉपेगेट करता है, तो इसे उस कुंजी के तौर पर इस्तेमाल करें जिससे इसे वापस पाया जा सके. उदाहरण:

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

प्लैटफ़ॉर्म

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 की सेवा देने वाली कंपनी का कंस्ट्रक्टर/कुंजी.