Lottie Swift: पूरी गाइड उदाहरणों के साथ

Lottie for Swift का परिचय

Lottie एक शक्तिशाली ओपन-सोर्स लाइब्रेरी है, जिसे Airbnb ने बनाया है। यह Adobe After Effects में बनाए गए वेक्टर एनिमेशन को मोबाइल और वेब प्लेटफॉर्म पर दिखाने की सुविधा देती है। एनिमेशन JSON फॉर्मेट (Bodymovin प्लगइन के ज़रिए) में एक्सपोर्ट होते हैं और बिना क्वालिटी खोए रियल-टाइम में चलते हैं।

Swift डेवलपर्स के लिए Lottie अनगिनत संभावनाएं खोलता है: साधारण लोडिंग इंडिकेटर और आइकन से लेकर जटिल फुल-स्क्रीन एनिमेशन, वेलकम स्क्रीन और इंटरैक्टिव UI एलिमेंट तक। GIF या वीडियो के विपरीत, Lottie एनिमेशन:

• वेक्टर-आधारित — किसी भी डिवाइस पर बिना क्वालिटी खोए स्केल होते हैं।
• हल्के — JSON फ़ाइलें आमतौर पर 1 से 50 KB तक होती हैं।
• इंटरैक्टिव — प्लेबैक, स्पीड, रंग और प्रोग्रेस को कंट्रोल कर सकते हैं।
• क्रॉस-प्लेटफॉर्म — एक ही JSON iOS, Android, Web, React Native और Flutter पर काम करता है।

यह लेख Swift में Lottie के उपयोग की पूरी गाइड है। आप सीखेंगे कि लाइब्रेरी कैसे इंस्टॉल करें, सभी मुख्य मेथड्स में महारत हासिल करें, एक रियल उदाहरण देखें और सामान्य गलतियों से बचें।

Lottie की इंस्टॉलेशन

Swift के लिए Lottie को Swift Package Manager (SPM) या CocoaPods के ज़रिए इंस्टॉल किया जाता है। SPM सबसे अच्छा तरीका है क्योंकि यह Xcode में बिल्ट-इन है।

Swift Package Manager (SPM) से इंस्टॉल करें

1. Xcode में प्रोजेक्ट खोलें और File → Add Packages... पर क्लिक करें।
2. रिपॉजिटरी URL डालें: https://github.com/airbnb/lottie-ios.git
3. वर्जन चुनें (नवीनतम स्टेबल वर्जन लें) और Add Package दबाएं।
4. पैकेज आपके टार्गेट में जुड़ गया है, यह जांच लें।

CocoaPods से इंस्टॉल करें

अगर आप CocoaPods इस्तेमाल करते हैं, तो Podfile में यह लाइन जोड़ें:

pod 'lottie-ios'

फिर यह कमांड चलाएं:

pod install

Carthage से इंस्टॉल करें (पुराना तरीका)

github "airbnb/lottie-ios"

carthage update --platform iOS चलाएं और फ्रेमवर्क को प्रोजेक्ट में जोड़ें।

ज़रूरी: इंस्टॉल करने के बाद, जिस फ़ाइल में Lottie का उपयोग करना है, वहां यह इंपोर्ट करें:

import Lottie

कोड उदाहरण के साथ तुरंत शुरुआत

चलिए एक सरल ऐप बनाते हैं जो पूरी स्क्रीन पर Lottie एनिमेशन चलाता है।

चरण 1: JSON फ़ाइल तैयार करें

Lottie एनिमेशन डाउनलोड करें या बनाएं। टेस्ट के लिए LottieFiles से मुफ्त एनिमेशन ले सकते हैं। JSON फ़ाइल (जैसे animation.json) को अपने Xcode प्रोजेक्ट के Assets फ़ोल्डर में रखें।

चरण 2: कोड लिखें

import UIKit
import Lottie

class ViewController: UIViewController {
    
    private var animationView: LottieAnimationView?
    
    override func viewDidLoad() {
        super.viewDidLoad()
        
        // 1. Assets से एनिमेशन इनिशियलाइज़ करें
        animationView = LottieAnimationView(name: "animation")
        
        // 2. साइज़ और पोज़िशन सेट करें
        animationView?.frame = view.bounds
        animationView?.contentMode = .scaleAspectFit
        
        // 3. स्क्रीन पर जोड़ें
        view.addSubview(animationView!)
        
        // 4. एनिमेशन चलाएं
        animationView?.play { (finished) in
            print("एनिमेशन खत्म: \(finished)")
        }
    }
}

ऐप चलाएं — आप देखेंगे कि एनिमेशन एक बार चलता है। इसे अनंत बार चलाने के लिए, play को इस तरह बदलें: play(fromProgress: 0, toProgress: 1, loopMode: .loop)।

Lottie के मुख्य मेथड और फंक्शन

नीचे Swift के लिए Lottie के 10 मुख्य मेथड दिए गए हैं। हर मेथड के साथ विवरण, पैरामीटर और काम का उदाहरण है।