2014 में, स्विफ्ट को पेश किया गया था, जो ऐप्पल के पारिस्थितिकी तंत्र अनुप्रयोगों को विकसित करने के लिए एक नई भाषा थी। नवीनता न केवल नई सुविधाओं और कार्यों को ले आई, बल्कि समस्याओं के लिए भी - जो पुराने पुराने सी-लाइब्रेरी का उपयोग करना चाहते थे। इस लेख में, मैं उनमें से एक पर चर्चा करूंगा - स्विफ्ट ढांचे में सी-लाइब्रेरी बंडल। इसे हल करने के कई तरीके हैं; इस मामले में, मैं समझाता हूं कि क्लैंग स्पष्ट मॉड्यूल के साथ यह कैसे करना है।

उदाहरण के लिए, हम एक्सटर्नल लिबगिफ़ सी-लाइब्रेरी लेते हैं और इसे अपने स्विफ्ट गिफ्टविफ्ट ढांचे में एम्बेड करते हैं। यदि आप तुरंत परिणाम देखना चाहते हैं, तो पूरी परियोजना को यहां देखा जा सकता है ।

कामवासना तैयार करना

हमारी परियोजना में libgif लाइब्रेरी को एम्बेड करने से पहले, आपको इसे स्रोत से संकलित करने की आवश्यकता है।

यहां नवीनतम टारबॉल डाउनलोड करें ।
कंसोल का उपयोग करके संग्रह को अनपैक करें, फ़ोल्डर पर जाएं और चलाएं:
```
./configure && make check 
```
नोट: सादगी के लिए, हम x86-64 प्लेटफॉर्म के लिए एक पुस्तकालय का संकलन कर रहे हैं, और इसलिए यह केवल iOS सिम्युलेटर या macOS पर काम करेगा। मल्टी-आर्किटेक्चर स्टेटिक लाइब्रेरी का निर्माण एक अलग विषय है, जिसे मैं इस लेख में नहीं छूता हूं। उपयोगी निर्देश यहां देखे जा सकते हैं ।
यदि सभी त्रुटियों के बिना चला जाता है, तो लाइब्रेरी फाइलें ${lib_gif_source}/lib/.libs में पाई जा सकती हैं। हम दो फ़ाइलों में रुचि रखते हैं:
```
 lib/.libs/libgif.a #   lib/gif_lib.h #  
```

प्रोजेक्ट सेटअप

अब हम अपनी आवश्यकताओं के लिए परियोजना को अनुकूलित करेंगे।

कोको टच फ्रेमवर्क टेम्पलेट का उपयोग करके एक नया प्रोजेक्ट बनाएं, इसे GifSwift नाम दें ।
प्रोजेक्ट के भीतर एक अलग समूह में बनाई गई libgif लाइब्रेरी फ़ाइलों को जोड़ें।
परिणाम देखने के लिए प्रोजेक्ट के लिए परीक्षण एप्लिकेशन के लिए एक नया लक्ष्य जोड़ें।

परियोजना की अंतिम संरचना कुछ इस तरह दिखनी चाहिए:

स्विफ्ट में आयात करें

स्विफ्ट में सी-लाइब्रेरी आयात करने के लिए, हमें इसे एक मॉड्यूल के रूप में वर्णित करना चाहिए। विवरण एक .modulemap फ़ाइल है, जिसमें आयात के लिए हेडर फ़ाइलों की सूची है और लिंकिंग के लिए स्टैटिक लाइब्रेरी हैं। परिणामस्वरूप मॉड्यूल को स्विफ्ट या ऑब्जेक्टिव-सी कोड ( @import का उपयोग @import ) में आयात किया जा सकता है।

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

स्पष्ट मॉड्यूल

इन सीमाओं के आसपास पाने के लिए, हम एक और तरीका इस्तेमाल करेंगे - लाइब्रेरी के लिए स्पष्ट मॉड्यूल। एक स्पष्ट मॉड्यूल एक मॉड्यूल है जिसे स्पष्ट कीवर्ड का उपयोग करके सबमॉड्यूल के रूप में घोषित किया जाता है, मूल मॉड्यूल में रखा जाता है, और स्वचालित रूप से आयात नहीं किया जाता है । यह ऑब्जेक्टिव-सी फ्रेमवर्क के लिए *_Private.h समान काम करता है। यदि आप इसमें घोषित एपीआई का उपयोग करना चाहते हैं, तो आपको मॉड्यूल को स्पष्ट रूप से (स्पष्ट रूप से) आयात करना होगा ।

हम ढांचे के अंदर सी-लाइब्रेरी के लिए एक स्पष्ट मॉड्यूल बना रहे हैं। ऐसा करने के लिए, हमें उत्पन्न Xcode मॉड्यूल को फिर से परिभाषित करना होगा। यह भी ध्यान दें कि हम libgif.a लाइब्रेरी को लिंक (लिंक gif) के लिए निर्दिष्ट नहीं करते हैं, लेकिन इसके बजाय सीधे Xcode इंटरफ़ेस का उपयोग करके प्रोजेक्ट में करते हैं।

नोट: स्पष्ट मॉड्यूल के बारे में अधिक जानने के लिए , यहां क्लिक करें।

प्रोजेक्ट के रूट फ़ोल्डर में GifSwift.modulemap नामक फ़ाइल जोड़ें:
```
 framework module GifSwift { umbrella header "GifSwift.h" explicit module CLibgif { private header "gif_lib.h" } export * } 
```
इस फ़ाइल में स्पष्ट क्लिबीफ मॉड्यूल के विनिर्देश हैं और इनमें एक घोषित हेडर फ़ाइल शामिल है (क्योंकि हमारी लाइब्रेरी में बस एक है)। फ़ाइल को फ़्रेमवर्क के लिए परिणामी मॉड्यूल में लोड किया गया है।
मॉड्यूल विवरण फ़ाइल को फ्रेमवर्क में जोड़ने की आवश्यकता नहीं है, लेकिन इसे लक्ष्य सेटिंग्स में निर्दिष्ट किया जाना चाहिए:
```
 Build Settings — Packaging — Module Map (MODULEMAP_FILE) = $SRCROOT/GifSwift/GifSwift.modulemap 
```
libgif फ़ाइलों को एक निजी हेडर ( gif_lib.h ) और एक स्थिर लाइब्रेरी ( libgif.a ) के रूप में फ्रेमवर्क लक्ष्य में जोड़ा जाना चाहिए। कृपया ध्यान दें कि C लाइब्रेरी के लिए हेडर फ़ाइल को लक्ष्य के रूप में निजी रूप से जोड़ा गया है। यह हमारे स्पष्ट मॉड्यूल के लिए आवश्यक है। कुछ भी इस हेडर फ़ाइल को सार्वजनिक रूप से जोड़ने से रोकता है, लेकिन हमारा कार्य कार्यान्वयन विवरण को यथासंभव सरल तरीके से छिपाना है।
अब आप import GifSwift.CLibgif का उपयोग करके रूपरेखा के अंदर स्पष्ट मॉड्यूल आयात कर सकते हैं

स्विफ्ट रैपर

अब आप हमारे ढांचे का इंटरफेस कर सकते हैं। एक वर्ग पर्याप्त है, जो गुणों के एक जोड़े के साथ एक gif है:

 import Foundation import GifSwift.CLibgif public class GifFile { private let path: URL private let fileHandlePtr: UnsafeMutablePointer<GifFileType> private var fileHandle: GifFileType { return self.fileHandlePtr.pointee } deinit { DGifCloseFile(self.fileHandlePtr, nil) } // MARK: - API public init?(path: URL) { self.path = path let errorCode = UnsafeMutablePointer<Int32>.allocate(capacity: 1) if let handle = path.path.withCString({ DGifOpenFileName($0, errorCode) }) { self.fileHandlePtr = handle DGifSlurp(handle) } else { debugPrint("Error opening file \(errorCode.pointee)") return nil } } public var size: CGSize { return CGSize(width: Double(fileHandle.SWidth), height: Double(fileHandle.SHeight)) } public var imagesCount: Int { return Int(fileHandle.ImageCount) } }

GifFile.swift फाइलों के प्रसंस्करण के लिए निम्न-स्तरीय प्रोग्रामिंग इंटरफेस को लपेटता है और कुछ गुणों को एक्सेस करता है, जिससे उन्हें अधिक सुविधाजनक फाउंडेशन प्रकारों में मैप किया जाता है।

निरीक्षण

हमारी लाइब्रेरी का परीक्षण करने के लिए, मैंने cat.gif फ़ाइल को प्रोजेक्ट में जोड़ा:

 import UIKit import GifSwift class ViewController: UIViewController {   override func viewDidLoad() {       super.viewDidLoad()       if let file = GifFile(path: Bundle.main.url(forResource: "cat", withExtension: "gif")!) {           debugPrint("Image has size: \(file.size) and contains \(file.imagesCount) images")       }   } }

जब हम कंसोल में इस कोड को चलाते हैं, तो हम निम्नलिखित देखेंगे:

" छवि का आकार है: (250.0, 208.0) और इसमें 44 चित्र हैं"

निष्कर्ष

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

स्विफ्ट ढांचे में सी-लाइब्रेरी को कैसे एम्बेड करें