SDWebImage: यह क्या है, मुख्य अवधारणाएँ और UIImageView

SDWebImage क्या है?

SDWebImage Apple प्लेटफ़ॉर्म (iOS, macOS, tvOS, watchOS) पर एसिंक्रोनस इमेज लोडिंग के लिए एक लाइब्रेरी है। यह UIImageView के लिए sd_setImage विधि के साथ एक श्रेणी प्रदान करती है, जो कोड की एक पंक्ति में किसी भी स्रोत से इमेज को लोड, कैश और प्रदर्शित करती है।

लाइब्रेरी प्रोग्रेसिव लोडिंग (बाइट्स प्राप्त होने पर इमेज दिखाई देती है), एनिमेटेड इमेज (GIF, APNG), ट्रांसफ़ॉर्मेशन (गोलाई, क्रॉपिंग, वॉटरमार्किंग) और कस्टम डिकोडर का समर्थन करती है। GitHub आँकड़ों के अनुसार, SDWebImage के 25,000 से अधिक स्टार हैं और इसका उपयोग Twitter, Pinterest और Instagram सहित प्रमुख अनुप्रयोगों में किया जाता है।

आर्किटेक्चर घटक श्रृंखला पर बनाया गया है: Coder (डिकोडिंग), Cache (भंडारण), Loader (नेटवर्क) और Transformer (प्रसंस्करण)। प्रत्येक घटक बदली जाने योग्य है, जो लाइब्रेरी को विशिष्ट प्रोजेक्ट आवश्यकताओं के अनुकूल बनाने की अनुमति देता है।

SDWebImage कैसे काम करता है: प्रबंधक और कैश

SDWebImageManager केंद्रीय घटक है जो लोडिंग प्रक्रिया का समन्वय करता है। यह URL स्वीकार करता है, कैश की जाँच करता है, डेटा लोड करता है, इसे UIImage में डिकोड करता है और ImageView या Completion Handler को पास करता है। प्रबंधक एक साझा सिंगलटन के माध्यम से संचालित होता है, जो एप्लिकेशन में कहीं से भी पहुँच योग्य है।

लोडिंग प्रक्रिया

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

• मेमोरी कैश — O(1) लुकअप, कॉन्फ़िगरेबल मेमोरी सीमा के साथ UIImage संग्रहीत करता है
• डिस्क कैश — फ़ाइल सिस्टम से पढ़ता है, संपीड़ित डेटा संग्रहीत करता है
• NSURLSession — HTTP/2 समर्थन और कॉन्फ़िगरेबल टाइमआउट के साथ लोडिंग

UIImageView श्रेणी

UIImageView+WebCache एक Objective-C श्रेणी है (Swift से सुलभ) जो sd_setImage विधि जोड़ती है। यह विधि URL, placeholder, विकल्प (SDWebImageOptions) और पूर्णता ब्लॉक स्वीकार करती है। श्रेणी sd_cancelCurrentImageLoad तंत्र के माध्यम से तालिका सेल के पुन: उपयोग होने पर पिछले अनुरोध को स्वचालित रूप से रद्द कर देती है।

SDWebImage के मुख्य वर्ग

SDWebImage आर्किटेक्चर स्पष्ट जिम्मेदारी क्षेत्रों के साथ कई मॉड्यूल में विभाजित है। प्रत्येक वर्ग एक कार्य हल करता है — लोडिंग से प्रदर्शन तक।

SDWebImageManager

SDWebImageManager सभी इमेज संचालन के लिए फेसाड है। इसमें ImageCache (SDImageCache) और ImageLoader (SDWebImageDownloader) के संदर्भ शामिल हैं। SDWebImageManagerDelegate के माध्यम से, आप लोडिंग को इंटरसेप्ट कर सकते हैं और URL या व्यवहार बदल सकते हैं।

SDImageCache

SDImageCache एक दो-स्तरीय कैश (मेमोरी + डिस्क) है जो एक अद्वितीय नाम स्थान के साथ प्रारंभ किया जाता है। मेमोरी कैश UIImage को कॉन्फ़िगरेबल सीमा के साथ संग्रहीत करता है (डिफ़ॉल्ट रूप से — सिस्टम मेमोरी चेतावनी तक)। डिस्क कैश Library/Caches निर्देशिका में कॉन्फ़िगरेबल भंडारण अवधि (डिफ़ॉल्ट 7 दिन) के साथ डेटा संग्रहीत करता है।

SDWebImageDownloader

SDWebImageDownloader NSURLSession पर आधारित एक HTTP क्लाइंट है जिसमें हेडर, टाइमआउट और पुन: प्रयास का समर्थन है। डाउनलोडर समान अनुरोधों को एक नेटवर्क कॉल में डिडुप्लिकेट करता है और परिणाम सभी सब्सक्राइबर्स के बीच वितरित करता है।

SDWebImage कैशिंग आर्किटेक्चर

SDWebImage नियतात्मक जाँच क्रम के साथ दो-स्तरीय कैशिंग लागू करता है: पहले मेमोरी, फिर डिस्क। कैश कुंजी क्वेरी पैरामीटर या उसके MD5 हैश के बिना पूर्ण इमेज URL है।

मेमोरी चेतावनी प्राप्त करने पर, iOS UIApplicationDidReceiveMemoryWarningNotification के माध्यम से SDImageCache को सूचित करता है, जिसके बाद मेमोरी कैश पूरी तरह से साफ़ हो जाता है। डिस्क कैश TTL द्वारा या सीमा पार होने पर साफ़ किया जाता है, फ़ाइलों को अंतिम पहुँच तिथि के अनुसार क्रमबद्ध करके।

मैन्युअल कैश प्रबंधन के लिए निम्नलिखित विधियाँ उपलब्ध हैं: clearMemory, clearDisk, calculateSize. SDWebImageCacheMemoryOnly या SDWebImageAvoidAutoSetImage विकल्पों का उपयोग करके विशिष्ट अनुरोधों के लिए कैशिंग अक्षम की जा सकती है।

Swift में SDWebImage उपयोग उदाहरण

SDWebImage इमेज लोड करने के लिए कई इंटरफ़ेस प्रदान करता है: सरल UIImageView श्रेणी से लेकर कस्टम प्रसंस्करण के साथ उन्नत प्रबंधक तक।

UIImageView में बुनियादी लोडिंग

sd_setImage UIImageView में इमेज लोड करने की प्राथमिक विधि है। यह URL, placeholder और Options व Context के माध्यम से वैकल्पिक पैरामीटर स्वीकार करती है। सभी Completion Handler मुख्य थ्रेड पर निष्पादित होते हैं।

let imageView = UIImageView()
imageView.sd_setImage(
    with: URL(string: "https://example.com/photo.jpg"),
    placeholderImage: UIImage(named: "placeholder"),
    options: [.progressiveLoad, .retryFailed],
    context: [.imageThumbnailPixelSize : CGSize(width: 300, height: 300)]
)

विधि एक SDWebImageToken (संचालन) लौटाती है जिसे आवश्यकता पड़ने पर रद्द किया जा सकता है। आंतरिक रूप से, sd_setImage SDWebImageManager.load को कॉल करता है, स्वचालित इमेज सेटिंग के लिए ImageView को Target के रूप में पास करता है।

कस्टम ट्रांसफ़ॉर्मेशन के साथ लोडिंग

SDWebImage Transformer — एक एकल विधि transformedImage वाले प्रोटोकॉल का समर्थन करता है। अंतर्निहित ट्रांसफ़ॉर्मेशन में शामिल हैं: सर्कल, गोल कोने, रंग फ़िल्टर ओवरले और आकार बदलना। ट्रांसफ़ॉर्मेशन को && ऑपरेटर का उपयोग करके जोड़ा जा सकता है।

let transformer = SDImageResizingTransformer(
    size: CGSize(width: 200, height: 200),
    scaleMode: .aspectFill
)
let roundedTransformer = SDImageRoundCornerTransformer(
    radius: 16,
    corners: .allCorners,
    borderWidth: 0
)
imageView.sd_setImage(
    with: url,
    placeholderImage: placeholder,
    context: [.imageTransformer : transformer && roundedTransformer]
)

SwiftUI के साथ उपयोग

लाइब्रेरी WebImage — SwiftUI के लिए placeholder, प्रगति संकेतक और त्रुटि प्रबंधन के समर्थन के साथ एक View घटक प्रदान करती है। घटक स्वचालित रूप से View जीवनचक्र की सदस्यता लेता है और गायब होने पर लोडिंग रद्द करता है।

struct CachedImageView: View {
    let url: URL

    var body: some View {
        WebImage(url: url) { phase in
            if let image = phase.image {
                image.resizable()
            } else if phase.error {
                Color.red
            } else {
                ProgressView()
            }
        }
    }
}

SDWebImage में इमेज ट्रांसफ़ॉर्मेशन

SDWebImage SDImageTransformer प्रोटोकॉल के माध्यम से एक लचीली ट्रांसफ़ॉर्मेशन प्रणाली प्रदान करता है। ट्रांसफ़ॉर्मेशन डिकोडिंग के बाद लेकिन कैशिंग से पहले लागू किए जाते हैं — ट्रांसफ़ॉर्मेशन परिणाम एक नई कुंजी के तहत डिस्क पर संग्रहीत किया जाता है, बाद के अनुरोधों पर पुन: आवेदन को रोकता है।

अंतर्निहित ट्रांसफ़ॉर्मेशन में शामिल हैं: SDImageResizingTransformer (mode के साथ आकार बदलना), SDImageRoundCornerTransformer (वैकल्पिक सीमा के साथ गोल कोने), SDImageFlipTransformer (मिररिंग) और SDImageFilterTransformer (CoreImage फ़िल्टर)। && ऑपरेटर के माध्यम से संयोजन किया जाता है, एक प्रसंस्करण श्रृंखला बनाता है।

कस्टम ट्रांसफ़ॉर्मेशन के लिए, transformedImageWithImage:forKey: विधि के साथ SDImageTransformer प्रोटोकॉल को लागू करना पर्याप्त है। ट्रांसफ़ॉर्मेशन कुंजी स्वचालित रूप से कैश कुंजी में जुड़ जाती है, एक ही इमेज के विभिन्न संस्करणों के बीच टकराव को रोकती है।

SDWebImage बनाम Kingfisher तुलना

iOS प्लेटफ़ॉर्म पर, SDWebImage के मुख्य प्रतिस्पर्धी Kingfisher (शुद्ध Swift) और Nuke हैं। SDWebImage और Kingfisher के बीच चुनाव अक्सर प्रोजेक्ट भाषा और आवश्यक कार्यक्षमता से निर्धारित होता है।

SDWebImage Objective-C प्रोजेक्ट्स या हाइब्रिड प्रोजेक्ट्स के लिए पसंदीदा विकल्प बना हुआ है। Kingfisher टाइप सुरक्षा और मूल Swift सिंटैक्स के कारण शुद्ध Swift प्रोजेक्ट्स के लिए बेहतर उपयुक्त है। दोनों लाइब्रेरीज़ में समान कैशिंग आर्किटेक्चर और प्रदर्शन है।

iOS प्रोजेक्ट में SDWebImage सेटअप

SDWebImage को Swift Package Manager, CocoaPods या Carthage के माध्यम से एकीकृत किया जा सकता है। लाइब्रेरी मॉड्यूल में विभाजित है: कोर (SDWebImage), Coder (अतिरिक्त प्रारूप) और MapKit (MKAnnotationView के लिए)।

// Swift पैकेज मैनेजर (Package.swift)
dependencies: [
    .package(
        url: "https://github.com/SDWebImage/SDWebImage.git",
        from: "5.19.0"
    )
]

// CocoaPods (Podfile)
pod 'SDWebImage', '~> 5.19.0'
// WebP और SVG के लिए प्लगइन्स:
pod 'SDWebImageWebPCoder'
pod 'SDWebImageSVGCoder'

स्थापना के बाद, लाइब्रेरी अतिरिक्त कॉन्फ़िगरेशन के बिना उपयोग के लिए तैयार है। कैश अनुकूलन के लिए, एक अद्वितीय नाम स्थान के साथ SDImageCache का एक उदाहरण बनाएँ और इसे आरंभीकरण के दौरान SDWebImageManager को पास करें। वैश्विक कॉन्फ़िगरेशन SDWebImageManager.shared के माध्यम से किया जाता है।

// कैश अनुकूलन
let config = SDImageCacheConfig()
config.maxDiskAge = 14 * 86400 // 7 के बजाय 14 दिन
config.maxDiskSize = 500 * 1024 * 1024 // 500 MB
config.shouldCacheImagesInMemory = .true

let cache = SDImageCache(
    namespace: "custom",
    diskCacheDirectory: FileManager.default.urls(
        for: .cachesDirectory,
        in: .userDomainMask
    ).first?.appendingPathComponent("custom_cache"),
    config: config
)
SDWebImageManager.sharedImageCache = cache