पुस्तकालयों और घटकों के अपने स्वयं के ढेर को विकसित करने और विकसित करने वाली कई कंपनियों के जीवन में, एक समय आता है जब इस ढेर की मात्रा को बनाए रखना मुश्किल हो जाता है।

IOS प्लेटफ़ॉर्म के लिए विकास के मामले में, और सामान्य तौर पर, ऐप्पल पारिस्थितिकी तंत्र, पुस्तकालयों को निर्भरता के रूप में जोड़ने के लिए दो विकल्प हैं:

1. हर बार जब आप एप्लिकेशन का निर्माण करते हैं तो उन्हें इकट्ठा करें।
2. पहले से एकत्र की गई निर्भरता का उपयोग करके उन्हें अग्रिम में इकट्ठा करें।

दूसरा दृष्टिकोण चुनते समय, पुस्तकालयों को तैयार-से-उपयोग की जाने वाली कलाकृतियों में इकट्ठा करने के लिए CI / CD सिस्टम का उपयोग करना तर्कसंगत हो जाता है।

हालांकि, Apple पारिस्थितिकी तंत्र में कई प्लेटफार्मों या प्रोसेसर आर्किटेक्चर के लिए पुस्तकालयों का निर्माण करने की आवश्यकता होती है, अक्सर पुस्तकालय का निर्माण करते समय और इसका उपयोग करने वाले अंतिम उत्पाद दोनों के लिए हमेशा तुच्छ संचालन की आवश्यकता नहीं होती है।

इस पृष्ठभूमि के खिलाफ, यह अध्ययन करने के लिए नोटिस करना और बेहद दिलचस्प नहीं था, Apple से नवाचारों में से एक, स्विफ्ट में बाइनरी फ्रेमवर्क की प्रस्तुति के हिस्से के रूप में WWDC 2019 में प्रस्तुत किया गया - फ्रेमवर्क का पैकेजिंग प्रारूप XCFramework है।

XCFramework स्थापित दृष्टिकोणों पर कई फायदे हैं:

1. बॉक्स से बाहर एक एकल बंडल में सभी लक्ष्य प्लेटफार्मों और आर्किटेक्चर के लिए निर्भरता पैकेजिंग।
2. XCFramework प्रारूप में कनेक्शन बंडल, सभी लक्ष्य प्लेटफार्मों और आर्किटेक्चर के लिए एक एकल निर्भरता के रूप में।
3. वसा / सार्वभौमिक ढांचे के निर्माण की आवश्यकता नहीं है।
4. AppStore में अंतिम एप्लिकेशन लोड करने से पहले x86_64 स्लाइस से छुटकारा पाने की कोई आवश्यकता नहीं है।

इस लेख में, हम बताएंगे कि यह नया प्रारूप क्यों पेश किया गया था, यह क्या है, और यह भी कि यह डेवलपर क्या देता है।

नया प्रारूप कैसे दिखाई दिया

Apple ने पहले स्विफ्ट पैकेज मैनेजर निर्भरता प्रबंधक जारी किया था।
लब्बोलुआब यह है कि स्विफ्ट पीएम आपको निर्भरता के विवरण के साथ ओपन सोर्स कोड के रूप में पुस्तकालयों को वितरित करने की अनुमति देता है।

पुस्तकालय की आपूर्ति करने वाले डेवलपर के दृष्टिकोण से, मैं स्विफ्ट पीएम के दो पहलुओं पर प्रकाश डालना चाहूंगा।

• स्पष्ट माइनस यह है कि एक या किसी अन्य कारण से, सभी पुस्तकालय विक्रेता उपभोक्ताओं के लिए अपना स्रोत कोड नहीं खोलना चाहेंगे।
• एक स्पष्ट प्लस - स्रोतों से निर्भरता का संकलन करते समय, हमें पुस्तकालयों की द्विआधारी संगतता का पालन करने की आवश्यकता से छुटकारा मिलता है।

XCFramework Apple पैकेजिंग पुस्तकालयों के लिए एक नया बाइनरी प्रारूप प्रदान करता है, इसे स्विफ्ट पैकेज के विकल्प के रूप में देखते हुए।

यह प्रारूप, साथ ही XCFramework में इकट्ठे पुस्तकालय को जोड़ने की क्षमता, Xcode 11 और इसके बीटा संस्करणों के साथ उपलब्ध है।

XCFramework क्या है

इसके मूल में, XCFramework अपने विभिन्न संस्करणों में पुस्तकालयों को पैकेज और वितरित करने का एक नया तरीका है।

अन्य चीजों के अलावा, नया प्रारूप अपनी हेडर फ़ाइलों के साथ-साथ स्थिर पुस्तकालयों की पैकेजिंग की भी अनुमति देता है, जिनमें सी / ऑब्जेक्टिव-सी लिखा है।

प्रारूप पर अधिक विस्तार से विचार करें।

1. बॉक्स से बाहर एक एकल बंडल में सभी लक्ष्य प्लेटफार्मों और आर्किटेक्चर के लिए निर्भरता पैकेजिंग

   
   

   लक्ष्य प्लेटफ़ॉर्म और आर्किटेक्चर में से प्रत्येक के लिए सभी लाइब्रेरी असेंबली अब विस्तार के साथ एक बंडल में पैक की जा सकती हैं।
   हालाँकि, इसके लिए, इस समय, आपको Xcode 11 के लिए नए -create-xcframework स्विच के साथ xcodebuild को लागू करने के लिए स्क्रिप्ट का उपयोग करना होगा।

   
   

   विधानसभा और पैकेजिंग प्रक्रिया पर आगे विचार किया जाएगा।

   
   

2. XCFramework प्रारूप में कनेक्शन बंडल, सभी लक्ष्य प्लेटफार्मों और आर्किटेक्चर के लिए एक एकल निर्भरता के रूप में

   
   

   चूंकि बंडल .xcframework में सभी आवश्यक निर्भरता विधानसभा विकल्प शामिल हैं, इसलिए हमें इसकी वास्तुकला और लक्ष्य मंच के बारे में चिंता करने की आवश्यकता नहीं है।

   
   

   Xcode 11 में, .xxframework में पैक किया गया एक पुस्तकालय एक नियमित .framework की तरह जुड़ा हुआ है।
   विशेष रूप से, यह लक्ष्य सेटिंग्स में निम्नलिखित तरीकों से प्राप्त किया जा सकता है:

   
   
   • "। सामान्य" टैब के "फ्रेमवर्क और लाइब्रेरीज़" अनुभाग में .xcframework जोड़ना
   • "बनाएँ चरणों" टैब पर .xcframework को "लिंक बाइनरी विद लाइब्रेरीज़" जोड़ना
   
   

3. वसा / सार्वभौमिक ढांचे के निर्माण की आवश्यकता नहीं

   
   

   पहले, एक प्लग-इन लाइब्रेरी में कई पुस्तकालयों और कई आर्किटेक्चर का समर्थन करने के लिए, तथाकथित वसा या सार्वभौमिक रूपरेखा तैयार करना आवश्यक था।
   यह lipo का उपयोग करके इकट्ठे ढांचे के सभी विकल्पों को एक एकल मोटी बाइनरी में सीवे करने के लिए किया गया था।

   
   

   इस पर अधिक विवरण पाया जा सकता है, उदाहरण के लिए, निम्नलिखित लेखों में:

   
   
   • अपना खुद का iOS ढांचा कैसे बनाएं (habr.ru)
   • Xcode 10.2 और iOS 12 में कस्टम यूनिवर्सल फ्रेमवर्क लिखना (medium.com)
   
   

4. AppStore में अंतिम एप्लिकेशन लोड करने से पहले x86_64 स्लाइस से छुटकारा पाने की कोई आवश्यकता नहीं है

   
   

   आमतौर पर, इस तरह के एक स्लाइस का उपयोग आईओएस सिम्युलेटर में लाइब्रेरी प्रदान करने के लिए किया जाता है।
   जब आप AppStore में x86_64 स्लाइस वाली निर्भरता वाले किसी एप्लिकेशन को डाउनलोड करने का प्रयास करते हैं, तो आप अच्छी तरह से ज्ञात त्रुटि ITMS-90087 से सामना कर सकते हैं।

   
   

XCFramework बनाना और पैकेजिंग: सिद्धांत

पहले बताई गई प्रस्तुति में , कई चरणों की आवश्यकता होती है जो XCFramework प्रारूप में लाइब्रेरी को इकट्ठा करने और पैकेज करने के लिए आवश्यक हैं:

1. परियोजना की तैयारी

   
   

   आरंभ करने के लिए, परियोजना के उन सभी लक्षित क्षेत्रों में जो लक्ष्य प्लेटफार्मों के लिए पुस्तकालय के निर्माण के लिए ज़िम्मेदार हैं, आपको Xcode 11 के लिए वितरण सेटिंग के लिए नई बिल्ड लाइब्रेरी को सक्षम करने की आवश्यकता है।

   
   

   

   
   

2. लक्ष्य प्लेटफार्मों और आर्किटेक्चर के लिए प्रोजेक्ट असेंबली

   
   

   अगला, हमें लक्ष्य प्लेटफार्मों और आर्किटेक्चर के लिए सभी लक्ष्यों को इकट्ठा करना होगा।
   आइए एक विशिष्ट परियोजना कॉन्फ़िगरेशन के उदाहरण का उपयोग करके कॉलिंग कमांड के उदाहरणों पर विचार करें।

   
   

   मान लीजिए कि परियोजना में हमारे पास दो योजनाएं हैं "XCFrameworkExample-iOS" और "XCFramework-macOS"।

   
   

   

   
   

   इसके अलावा परियोजना में दो लक्ष्य हैं जो आईओएस और मैकओएस के लिए पुस्तकालय एकत्र करते हैं।

   
   

   

   
   

   सभी आवश्यक लाइब्रेरी कॉन्फ़िगरेशन बनाने के लिए, हमें संबंधित योजनाओं का उपयोग करके दोनों लक्ष्यों को इकट्ठा करने की आवश्यकता है।
   हालांकि, iOS के लिए, हमें दो असेंबली की आवश्यकता है: एक एंड डिवाइस (ARM) के लिए, और दूसरा सिम्युलेटर (x86_64) के लिए।

   
   

   कुल मिलाकर, हमें 3 रूपरेखाएँ एकत्र करने की आवश्यकता है।

   
   

   ऐसा करने के लिए, आप xcodebuild कमांड का उपयोग कर सकते हैं:

   
   

    # iOS devices xcodebuild archive \ -scheme XCFrameworkExample-iOS \ -archivePath "./build/ios.xcarchive" \ -sdk iphoneos \ SKIP_INSTALL=NO # iOS simulator xcodebuild archive \ -scheme XCFrameworkExample-iOS \ -archivePath "./build/ios_sim.xcarchive" \ -sdk iphonesimulator \ SKIP_INSTALL=NO # macOS xcodebuild archive \ -scheme XCFrameworkExample-macOS \ -archivePath "./build/macos.xcarchive" \ SKIP_INSTALL=NO 

   
   

   नतीजतन, हमें 3 इकट्ठे फ्रेमवर्क मिले, जिसे हम .xcframework कंटेनर में आगे पैक करेंगे।

   
   

3. पैकिंग इकट्ठी हुई

   
   

   आप निम्न आदेश के साथ ऐसा कर सकते हैं:

   
   

    xcodebuild -create-xcframework \ -framework "./build/ios.xcarchive/Products/Library/Frameworks/XCFrameworkExample.framework" \ -framework "./build/ios_sim.xcarchive/Products/Library/Frameworks/XCFrameworkExample.framework" \ -framework "./build/macos.xcarchive/Products/Library/Frameworks/XCFrameworkExample.framework" \ -output "./build/XCFrameworkExample.xcframework" 

   
   

   वहाँ बहुत सारे -framework पैरामीटर -framework जो सभी .framework विधानसभाओं को इंगित करते हैं जो आप .xcframework कंटेनर में संलग्न करना चाहते हैं।

   
   

भविष्य की विधानसभा और XCFramework की पैकेजिंग के लिए एक पुस्तकालय परियोजना तैयार करना

टीएल; डीआर: तैयार परियोजना को गितुब पर भंडार से डाउनलोड किया जा सकता है।

एक उदाहरण के रूप में, हम एक पुस्तकालय लागू कर रहे हैं जो दो प्लेटफार्मों के लिए उपलब्ध होगा: आईओएस और मैकओएस।
हम लेख के पिछले भाग में उल्लिखित प्रोजेक्ट कॉन्फ़िगरेशन का उपयोग करेंगे: दो योजनाएं और iOS और macOS प्लेटफार्मों के लिए दो संबंधित फ्रेमवर्क लक्ष्य।

क्या पुस्तकालय स्वयं String? लिए एक सरल एक्सटेंशन प्रदान करेगा String? ( Optional where Wrapped == String ), एक ही संपत्ति के साथ।

हम इस संपत्ति को isNilOrEmpty कहते हैं और जैसा कि नाम से ही isNilOrEmpty है, क्या यह हमें isNilOrEmpty कि String? अंदर कब है String? लापता मान या अंदर संग्रहीत स्ट्रिंग खाली है।

कोड निम्नानुसार लागू किया जा सकता है:

 public extension Optional where Wrapped == String { var isNilOrEmpty: Bool { if case let .some(string) = self { return string.isEmpty } return true } } 

हम परियोजना के निर्माण और विन्यास के लिए सीधे आगे बढ़ते हैं।

1. शुरू करने के लिए, हमें आपकी पसंद के दो लक्ष्य प्लेटफार्मों में से एक के लिए "फ्रेमवर्क" प्रकार की एक परियोजना बनाने की आवश्यकता है: आईओएस या मैकओएस।

   
   

   आप मेनू आइटम "फ़ाइल" => "नया" => "प्रोजेक्ट", या कीबोर्ड शॉर्टकट keyboard + + N (डिफ़ॉल्ट रूप से) का उपयोग करके Xcode में कर सकते हैं।

   
   

   अगला, संवाद के शीर्ष पर, इच्छित प्लेटफ़ॉर्म (iOS या macOS) का चयन करें, फ्रेमवर्क प्रोजेक्ट के प्रकार का चयन करें, और "अगला" बटन पर जाएं।

   
   

   अगली स्क्रीन पर, हमें "उत्पाद का नाम" फ़ील्ड में प्रोजेक्ट का नाम सेट करना होगा।

   
   

   वैकल्पिक रूप से, आप प्रोजेक्ट के "आधार" नाम का उपयोग कर सकते हैं, पहले उल्लेखित कॉन्फ़िगरेशन में यह "XCFrameworkExample" है।

   
   

   भविष्य में, परियोजना को कॉन्फ़िगर करते समय, हम लक्ष्य के नाम पर उपयोग किए जाने वाले आधार नाम के प्लेटफ़ॉर्म को जोड़ने वाले प्रत्ययों को जोड़ देंगे।

   
   

2. उसके बाद, आपको किसी अन्य सूचीबद्ध प्लेटफ़ॉर्म के लिए प्रोजेक्ट में टाइप "फ्रेमवर्क" का एक और टारगेट बनाने की आवश्यकता होती है (केवल उस परियोजना को छोड़कर जिसके लिए मूल रूप से बनाया गया था)।

   
   

   ऐसा करने के लिए, मेनू आइटम "फ़ाइल" => "नया" => "लक्ष्य" का उपयोग करें।

   
   

   इसके बाद, हम दो प्लेटफार्मों के संवाद में एक और (पैरा 1 में चयनित एक के सापेक्ष) का चयन करते हैं, जिसके बाद हम फिर से प्रोजेक्ट प्रकार "फ्रेमवर्क" का चयन करते हैं।

   
   

   "उत्पाद का नाम" फ़ील्ड के लिए, हम तुरंत मंच के प्रत्यय के साथ नाम का उपयोग कर सकते हैं, जिसके लिए हम इस पैराग्राफ में लक्ष्य जोड़ते हैं। इसलिए, यदि प्लेटफ़ॉर्म macOS है, तो नाम "XCFrameworkExample-macOS" (% base_name% -% प्लेटफ़ॉर्म%) हो सकता है।

   
   

3. हम उन्हें भेद करना आसान बनाने के लिए लक्ष्य और चार्ट सेट करेंगे।

   
   

   सबसे पहले, हमारी योजनाओं और उनसे जुड़े लक्ष्यों का नाम बदलें ताकि उनके नाम प्लेटफार्मों को प्रतिबिंबित करें, उदाहरण के लिए इस तरह:

   
   
   • «XCFrameworkExample-आईओएस»
   • «XCFrameworkExample-MacOS»
   
   

4. अगला, String? लिए हमारे एक्सटेंशन के कोड के साथ फ़ाइल को प्रोजेक्ट में जोड़ें String?

   
   

   "Optional.swift" नाम के साथ प्रोजेक्ट में एक नई .swift फ़ाइल जोड़ें।
   और फ़ाइल में हमने Optional लिए पहले से उल्लेखित एक्सटेंशन डाल दिया।

   
   

   यह महत्वपूर्ण है कि दोनों लक्ष्यों के लिए कोड फ़ाइल को जोड़ना न भूलें।

   
   

   

   
   

अब हमारे पास एक परियोजना है जिसे हम पिछले चरण से कमांड का उपयोग करके XCFramework में एक साथ रख सकते हैं।

.Xcframework फॉर्मेट में लाइब्रेरी को असेंबल और पैकेजिंग करने की प्रक्रिया

इस स्तर पर, आप लाइब्रेरी बनाने और उसे .xcframework फॉर्मेट में पैकेज करने के लिए एक अलग फाइल में bash स्क्रिप्ट का उपयोग कर सकते हैं। इसके अलावा, यह भविष्य में इन घटनाओं का उपयोग सीआई / सीडी सिस्टम में समाधान को एकीकृत करने की अनुमति देगा।

स्क्रिप्ट बदसूरत सरल लगती है, और वास्तव में, विधानसभा के लिए पहले से उल्लेखित आदेशों को एक साथ लाता है:

 #!/bin/sh # ---------------------------------- # BUILD PLATFORM SPECIFIC FRAMEWORKS # ---------------------------------- # iOS devices xcodebuild archive \ -scheme XCFrameworkExample-iOS \ -archivePath "./build/ios.xcarchive" \ -sdk iphoneos \ SKIP_INSTALL=NO # iOS simulator xcodebuild archive \ -scheme XCFrameworkExample-iOS \ -archivePath "./build/ios_sim.xcarchive" \ -sdk iphonesimulator \ SKIP_INSTALL=NO # macOS xcodebuild archive \ -scheme XCFrameworkExample-macOS \ -archivePath "./build/macos.xcarchive" \ SKIP_INSTALL=NO # ------------------- # PACKAGE XCFRAMEWORK # ------------------- xcodebuild -create-xcframework \ -framework "./build/ios.xcarchive/Products/Library/Frameworks/XCFrameworkExample.framework" \ -framework "./build/ios_sim.xcarchive/Products/Library/Frameworks/XCFrameworkExample.framework" \ -framework "./build/macos.xcarchive/Products/Library/Frameworks/XCFrameworkExample.framework" \ -output "./build/XCFrameworkExample.xcframework" 

.Xcframework सामग्री

लेख के पिछले पैराग्राफ से विधानसभा स्क्रिप्ट के परिणामस्वरूप, हमें प्रतिष्ठित बंडल .xcframework प्राप्त होता है, जिसे प्रोजेक्ट में जोड़ा जा सकता है।

यदि हम इस बंडल के अंदर देखते हैं, जो कि .framework, अनिवार्य रूप से एक साधारण फ़ोल्डर है, तो हम निम्नलिखित संरचना देखेंगे:

यहाँ हम देखते हैं कि .xcframework अंदर .framework फॉर्मेट में असेंबलियाँ हैं, प्लेटफ़ॉर्म और आर्किटेक्चर द्वारा टूट गई हैं। बंडल की सामग्री का वर्णन करने के लिए .xcframework, अंदर एक Info.plist फ़ाइल है।

 <?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd"> <plist version="1.0"> <dict> <key>AvailableLibraries</key> <array> <dict> <key>LibraryIdentifier</key> <string>ios-arm64</string> <key>LibraryPath</key> <string>XCFrameworkExample.framework</string> <key>SupportedArchitectures</key> <array> <string>arm64</string> </array> <key>SupportedPlatform</key> <string>ios</string> </dict> <dict> <key>LibraryIdentifier</key> <string>ios-x86_64-simulator</string> <key>LibraryPath</key> <string>XCFrameworkExample.framework</string> <key>SupportedArchitectures</key> <array> <string>x86_64</string> </array> <key>SupportedPlatform</key> <string>ios</string> <key>SupportedPlatformVariant</key> <string>simulator</string> </dict> <dict> <key>LibraryIdentifier</key> <string>macos-x86_64</string> <key>LibraryPath</key> <string>XCFrameworkExample.framework</string> <key>SupportedArchitectures</key> <array> <string>x86_64</string> </array> <key>SupportedPlatform</key> <string>macos</string> </dict> </array> <key>CFBundlePackageType</key> <string>XFWK</string> <key>XCFrameworkFormatVersion</key> <string>1.0</string> </dict> </plist> 

आप देख सकते हैं कि "CFBundlePackageType" कुंजी के लिए .framework प्रारूप के विपरीत, नया मान "XFWK" का उपयोग किया जाता है, न कि "FMWK"।

परिणाम

तो, XCFramework में लाइब्रेरी पैकेजिंग प्रारूप .framework प्रारूप में संकलित पुस्तकालयों के लिए एक नियमित कंटेनर से अधिक कुछ नहीं है।

हालांकि, यह प्रारूप आपको अलग से स्टोर करने और स्वतंत्र रूप से प्रत्येक प्रस्तुत किए गए आर्किटेक्चर और प्लेटफार्मों का उपयोग करने की अनुमति देता है। यह वसा / सार्वभौमिक रूपरेखाओं के निर्माण के लिए व्यापक दृष्टिकोण में निहित कई समस्याओं को समाप्त करता है।

जैसा कि हो सकता है, इस समय, वास्तविक परियोजनाओं में XCFramework का उपयोग करने के मुद्दे के बारे में एक महत्वपूर्ण बारीकियों है - निर्भरता प्रबंधन, जिसे Apple ने XCFramework प्रारूप में लागू नहीं किया है।

इन उद्देश्यों के लिए, स्विफ्ट पीएम, कार्थेज, कोकोआपोड्स और अन्य निर्भरता प्रबंधन प्रणाली और उनकी विधानसभाओं को आदतन उपयोग किया जाता है। इसलिए, यह आश्चर्य की बात नहीं है कि नए प्रारूप के लिए कोकोआपॉड्स और कार्थेज परियोजनाओं में पहले से ही समर्थन जारी है।