MPAndroidChart Kotlin 完整指南：安装、方法与实战示例

MPAndroidChart 是一款功能强大、灵活开源的 Android 图表库，专为在应用中创建各种图表而设计。它基于 Java 编写，但由于 Kotlin 与 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
        )