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

1. यह क्या है और क्यों ज़रूरी है

Lottie, Airbnb द्वारा बनाई गई एक ओपन-सोर्स लाइब्रेरी है, जो After Effects एनिमेशन को मोबाइल और वेब पर रियल-टाइम में रेंडर करती है। Android के लिए आधिकारिक लाइब्रेरी com.airbnb.android:lottie है, जो Kotlin भाषा को पूरी तरह सपोर्ट करती है। एनिमेशन को After Effects से JSON फॉर्मेट (Bodymovin प्लगइन के ज़रिए) में एक्सपोर्ट किया जाता है और फिर ऐप में बिना क्वालिटी खोए और छोटे फ़ाइल साइज़ के साथ चलाया जाता है।

Lottie क्यों ज़रूरी है? पहला, यह डिज़ाइनर और डेवलपर के काम को बहुत आसान बनाती है: डिज़ाइनर अपने पसंदीदा टूल में जटिल एनिमेशन बनाता है, और डेवलपर सिर्फ JSON फ़ाइल को कनेक्ट करता है। दूसरा, Lottie बहुत तेज़ है — एनिमेशन GPU पर रेंडर होते हैं, जिससे पुराने डिवाइस पर भी 60 FPS मिलता है। तीसरा, यह इंटरैक्टिविटी को सपोर्ट करती है: आप प्लेबैक को कंट्रोल कर सकते हैं, स्पीड, रंग, साइज़ बदल सकते हैं और प्रोग्रामेटिक रूप से अलग-अलग लेयर्स को एनिमेट कर सकते हैं।

Lottie Android इनके लिए सबसे अच्छा है: स्प्लैश स्क्रीन, एनिमेटेड आइकन, स्क्रीन ट्रांज़िशन, यूज़र जेस्चर पर रिएक्शन, UI में माइक्रो-एनिमेशन और भी बहुत कुछ। इस लाइब्रेरी को कम्युनिटी का अच्छा सपोर्ट मिलता है और LottieFiles पर हज़ारों मुफ़्त एनिमेशन उपलब्ध हैं।

2. इंस्टॉलेशन

Android प्रोजेक्ट में Kotlin के साथ Lottie इंस्टॉल करने के लिए, build.gradle (मॉड्यूल लेवल) में डिपेंडेंसी जोड़ें:

dependencies {
    implementation 'com.airbnb.android:lottie:6.4.0'
}

अगर आप Kotlin DSL (build.gradle.kts) का उपयोग कर रहे हैं:

dependencies {
    implementation("com.airbnb.android:lottie:6.4.0")
}

Gradle सिंक करने के बाद लाइब्रेरी उपयोग के लिए तैयार है। न्यूनतम Android SDK वर्शन 21 (Android 5.0) है।

ध्यान दें: इस लाइब्रेरी के लिए pip, npm या cargo कमांड का उपयोग नहीं किया जाता, क्योंकि यह एक नेटिव Android लाइब्रेरी है।

3. तुरंत शुरुआत — न्यूनतम काम करने वाला उदाहरण

JSON एनिमेशन फ़ाइल (जैसे, animation.json) को app/src/main/res/raw फ़ोल्डर में रखें। फिर अपने layout फ़ाइल में LottieAnimationView जोड़ें:

<!-- activity_main.xml -->
<?xml version="1.0" encoding="utf-8"?>
<androidx.constraintlayout.widget.ConstraintLayout 
    xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    android:layout_width="match_parent"
    android:layout_height="match_parent">

    <com.airbnb.lottie.LottieAnimationView
        android:id="@+id/animationView"
        android:layout_width="200dp"
        android:layout_height="200dp"
        app:lottie_rawRes="@raw/animation"
        app:lottie_autoPlay="true"
        app:lottie_loop="true"
        app:layout_constraintBottom_toBottomOf="parent"
        app:layout_constraintEnd_toEndOf="parent"
        app:layout_constraintStart_toStartOf="parent"
        app:layout_constraintTop_toTopOf="parent" />

</androidx.constraintlayout.widget.ConstraintLayout>

Activity (या Fragment) में Kotlin कोड:

import android.os.Bundle
import androidx.appcompat.app.AppCompatActivity
import com.airbnb.lottie.LottieAnimationView

class MainActivity : AppCompatActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)

        val animationView: LottieAnimationView = findViewById(R.id.animationView)
        animationView.playAnimation()
    }
}

यह न्यूनतम उदाहरण raw/animation.json रिसोर्स से एनिमेशन को अनंत लूप में चलाएगा।

4. मुख्य तरीके/फंक्शन/क्लास

4