MPAndroidChart para Kotlin: guia completo com exemplos práticos

MPAndroidChart é uma biblioteca poderosa e flexível de código aberto para criar gráficos e diagramas em aplicativos Android. Escrita em Java, ela é perfeitamente compatível com Kotlin graças à interoperabilidade total. Esta biblioteca é o padrão de facto para visualização de dados no ecossistema Android, oferecendo uma ampla gama de tipos de gráficos: desde linhas e barras simples até gráficos de pizza, bolhas e combinados.

Por que usar o MPAndroidChart? No desenvolvimento mobile moderno, a visualização de dados desempenha um papel crucial. Seja para exibir indicadores financeiros, resultados de treinos esportivos, estatísticas de uso do aplicativo ou a variação da temperatura — um gráfico de qualidade torna a informação clara e compreensível. O MPAndroidChart cuida de todo o trabalho pesado de renderização, animação, manipulação de toques e zoom, permitindo que o desenvolvedor foque na lógica do aplicativo. A biblioteca suporta milhares de pontos de dados, funciona de forma fluida mesmo em dispositivos antigos e oferece dezenas de opções de personalização.

Neste guia, vamos abordar detalhadamente a instalação da biblioteca, as principais classes e métodos, escrever vários exemplos funcionais em Kotlin e dar dicas práticas para otimizar a performance. Ao final do artigo, você será capaz de integrar com confiança qualquer tipo de gráfico no seu aplicativo Android.

1. Instalação

O MPAndroidChart é distribuído via Maven Central. Para instalar, adicione a dependência no arquivo build.gradle do seu módulo (geralmente app/build.gradle).

Comando exato (Gradle):

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

Após adicionar a linha, sincronize o projeto (Sync Now). A biblioteca está pronta para uso.

Importante: Certifique-se de que no build.gradle raiz (nível do projeto) o repositório Maven Central esteja adicionado:

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

Se você estiver usando a nova configuração (Gradle 7+), adicione o repositório no settings.gradle.kts:

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

2. Início rápido — exemplo mínimo funcional

Vamos criar um gráfico de linhas simples com três pontos de dados. Primeiro, adicione o LineChart no seu layout XML:

<!-- 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>

Agora, o código na 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. Criar os pontos de dados (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
        )