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

MPAndroidChart एक शक्तिशाली और लचीली ओपन-सोर्स लाइब्रेरी है जो Android ऐप्स में ग्राफ और चार्ट बनाने के लिए उपयोग की जाती है। यह Java में लिखी गई है, लेकिन पूरी इंटरऑपरेबिलिटी के कारण Kotlin के साथ पूरी तरह से काम करती है। यह लाइब्रेरी Android इकोसिस्टम में डेटा विज़ुअलाइज़ेशन का डी-फैक्टो स्टैंडर्ड है, जो सरल लाइन और बार चार्ट से लेकर जटिल पाई, बबल और कॉम्बिनेशन चार्ट तक कई प्रकार के चार्ट प्रदान करती है।

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

इस गाइड में हम लाइब्रेरी की इंस्टॉलेशन, मुख्य क्लासेस और तरीकों को विस्तार से समझेंगे, Kotlin में कई काम के उदाहरण लिखेंगे और परफॉरमेंस ऑप्टिमाइज़ेशन के प्रैक्टिकल टिप्स देंगे। इस लेख के अंत तक आप अपने Android ऐप में किसी भी प्रकार के चार्ट को आत्मविश्वास से इंटीग्रेट कर पाएंगे।

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

MPAndroidChart Maven Central के ज़रिए उपलब्ध है। इसे इंस्टॉल करने के लिए अपने मॉड्यूल के build.gradle फ़ाइल (आमतौर पर app/build.gradle) में डिपेंडेंसी जोड़ें।

सटीक कमांड (Gradle):

dependencies {
    implementation 'com.github.PhilJay:MPAndroidChart:v3.1.0'
}

यह लाइन जोड़ने के बाद प्रोजेक्ट को सिंक करें (Sync Now)। लाइब्रेरी उपयोग के लिए तैयार है।

ज़रूरी: सुनिश्चित करें कि रूट build.gradle (प्रोजेक्ट लेवल) में Maven Central रिपॉजिटरी जोड़ी गई है:

allprojects {
    repositories {
        google()
        mavenCentral()
    }
}

अगर आप नया सेटअप तरीका (Gradle 7+) इस्तेमाल कर रहे हैं, तो settings.gradle.kts में रिपॉजिटरी जोड़ें:

dependencyResolutionManagement {
    repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
    repositories {
        google()
        mavenCentral()
    }
}

2. तुरंत शुरुआत — न्यूनतम काम का उदाहरण

आइए तीन डेटा पॉइंट्स के साथ एक सरल लाइन चार्ट बनाएं। पहले अपने XML लेआउट में LineChart जोड़ें:

<!-- activity_main.xml -->
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:orientation="vertical">

    <com.github.mikephil.charting.charts.LineChart
        android:id="@+id/lineChart"
        android:layout_width="match_parent"
        android:layout_height="400dp" />

</LinearLayout>

अब Activity में कोड (Kotlin):

import androidx.appcompat.app.AppCompatActivity
import android.os.Bundle
import com.github.mikephil.charting.charts.LineChart
import com.github.mikephil.charting.data.Entry
import com.github.mikephil.charting.data.LineData
import com.github.mikephil.charting.data.LineDataSet

class MainActivity : AppCompatActivity() {

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

        val lineChart: LineChart = findViewById(R.id.lineChart)

        // 1. डेटा पॉइंट्स (Entry) बनाएं
        val entries = listOf(
            Entry(0f, 10f),   // x=0, y=10
            Entry(1f, 20f),   // x=1, y=20
            Entry(2f, 15f)    // x=2, y=15
        )