1、添加依赖

项目目录->app->build.gradle

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

项目目录->app->setting.gradle

dependencyResolutionManagement {
    repositories {
        maven { url 'https://jitpack.io' }
    }
}

2、Chart 类

​ 该类是图表的控件，类似于按键、图片，是从 xml 文件中通过 id 获取到的。

获取/创建

xxxChart chart = (xxxChart) findViewById(R.id.chart);

常用方法

3、DataSet 类

作用

​

设置展现在图表上的一组数据的一些表现形式

。比如说设置折线的颜色、粗细等。

构造函数

xxxDataSet dataSet = new xxxDataSet(List<Entry> yVals, String label);

• 
  yVals
  
  ：需要进行展示的一组数据

• 
  label
  
  ：该组数据的名字

yVals list 数组由来：

float[] data;

// 填充数据
for(int i = 0; i < data.length; i++) {
    // 两个数字对应的分别是 X轴 Y轴
    barList.add(new BarEntry(i, data[i]));
}

共用方法

3.1 LineDataSet

3.2 BarDataSet

4、Data 类

​ ChartData 类是所有图表数据类的基类

public class LineData extends ChartData { ...

作用

​ **将一个或若干个 -DataSet 数据类做进一步的包装，由 -Data 类进行管理。**并通过它传递给 -Chart 类进行显示。

构造方法

xxxData data = new xxxData(IBarDataSet DataSet);

• 
  DataSet
  
  ：前面提到的 xxxDataSet 数据类。

共用方法

4.1 BarChart

5、AxisBase 类

作用

​ 该类是 Chart 图表的 X/Y 轴的基类。

共用方法

5.1 XAxis

作用

​ 该类是 Chart 图表的 X 轴，由


chart.getXAxis()


获取。

常用方法

5.2 YAxis

作用

​ 该类是 Chart 图表的 Y 轴，但 Chart 中有左右两个 Y 轴，分别由


chart.getAxisLeft()、chart.getAxisRight()


获取。

常用方法

6、LimitLine 类

作用

​ 该类是 Chart 的限制线，作用是呈现一些特殊的信息，像边界、约束等。

构造函数

LimitLine limitLine = new LimitLine(float limit, String label);

• limit：这条线应该出现在坐标轴上的位置（值）

• label：该限制线的名字

常用方法

7、Description 类

作用

​ 该类是一个 Chart 类的标题。

构造函数

Description description = new Description();

常用方法

8、IValueFormatter 接口

作用

​ 对数据组 DataSet 中的数据标签进行重新格式化。

例子

DataSet.setValueFormatter(new IValueFormatter() {
    @Override
    public String getFormattedValue(float v, Entry entry, int i, ViewPortHandler viewPortHandler) {
        if(entry.getY() == v){
            return v + "h";
        }
        return "";
    }
});

• 
  v
  
  ：要格式化的值
• 
  enry
  
  ：值所属的条目

9、IAxisValueFormatter 接口

作用

​ 对坐标轴的标签进行重新格式化。

例子

String[] data;
    
Axis.setValueFormatter(new IAxisValueFormatter() {
    @Override
    public String getFormattedValue(float value, AxisBase axis) {
        if((int)value >= 0 && (int)value < data.length) {
            return data[(int) value];
        }
        return "";
    }
});

• 
  value
  
  ：要格式化的值

10、OnChartValueSelectedListener 接口

作用

​ 监听是否点击了数据组中的数据。可以在该监听函数中实现点击不同的数据在另一个 Chart 中展现对应的不同的数据。

例子

chart.setOnChartValueSelectedListener(new OnChartValueSelectedListener() {
    // 点击数据后的回调函数
    @Override
    public void onValueSelected(Entry entry, Highlight highlight) {
        int iEntry = (int) entry.getX();
    }
	
    // 取消点击数据后的回调函数
    @Override
    public void onNothingSelected() {

    }
});

11、例子

    <com.github.mikephil.charting.charts.BarChart
        android:id="@+id/bar"
        android:layout_marginTop="50dp"
        android:layout_width="380dp"
        android:layout_height="258dp"
        android:layout_gravity="center" >
    </com.github.mikephil.charting.charts.BarChart>

// x轴
String[] day = {"1-1", "1-2", "1-3", "1-4", "1-5", "1-6", "1-7"};
// x轴对应的数据
float[] time = {(float)6.8, (float)5.4, (float)2.9, (float)8.2, (float)4.7, (float)6.1, (float)9.2};
// 实例化一个List用来存储数据
List<BarEntry> barList = new ArrayList<>();


/*柱状图*/
mBarChart = (BarChart) findViewById(R.id.bar);
// 是否使能缩放
mBarChart.setScaleEnabled(false);
mBarChart.setExtraLeftOffset(10);
mBarChart.setExtraTopOffset(50);
// 动画
mBarChart.animateY(1000);

/** 柱子 **/
// 填充数据
for(int i = 0; i < time.length; i++) {
    // 两个数字对应的分别是 X轴 Y轴
    barList.add(new BarEntry(i, time[i]));
}
// 设置该组数据名称
BarDataSet barDataSet = new BarDataSet(barList,"时长");
// 设置柱子颜色
barDataSet.setColors(Color.parseColor("#D2B48C"));
// 柱子边框颜色
barDataSet.setBarBorderColor(Color.parseColor("#CD853F"));
// 柱子边框厚度
barDataSet.setBarBorderWidth(2);
// 设置柱子高亮显示时的颜色透明度，当不高亮显示时，该设置无效
barDataSet.setHighLightAlpha(100);
// 设置柱子上字体大小
barDataSet.setValueTextSize(11);
// 定义柱子上的数据显示，可以实现加单位
barDataSet.setValueFormatter(new IValueFormatter() {
    @Override
    public String getFormattedValue(float v, Entry entry, int i, ViewPortHandler viewPortHandler) {
        if(entry.getY() == v){
            return v + "h";
        }
        return "";
    }
});
BarData barData = new BarData(barDataSet);
// 设置柱子宽度
barData.setBarWidth(0.7f);
mBarChart.setData(barData);

/** X轴 **/
XAxis xAxis = mBarChart.getXAxis();
// 设置X轴的位置  BOTTOM  BOTH_SIDED  BOTTOM_INSIDE  TOP  TOP_INSIDE
xAxis.setPosition(XAxis.XAxisPosition.BOTTOM);
// 设置X轴坐标之间的最小间隔
xAxis.setGranularity(1);
// 设置X轴的刻度数量
xAxis.setLabelCount(day.length);
// 设置当前图表中最多在x轴坐标线上显示刻度线的总量
mBarChart.setVisibleXRangeMaximum(8);
// 设置X轴的字体大小
xAxis.setTextSize(11);
// 设置X轴的字体颜色
xAxis.setAxisLineColor(Color.BLACK);
// 设置X轴的粗细
xAxis.setAxisLineWidth(1);
// 是否绘制X轴的网格线
xAxis.setDrawGridLines(false);
// 给X轴设置新的标签（值）
xAxis.setValueFormatter(new IAxisValueFormatter() {
    @Override
    public String getFormattedValue(float value, AxisBase axis) {
        if((int)value >= 0 && (int)value < day.length) {
            return day[(int)value];
        }
        return "";
    }
});

/** Y轴 **/
YAxis leftYAxis = mBarChart.getAxisLeft();
YAxis rightYAxis = mBarChart.getAxisRight();
// 设置某一个Y轴是否显示
rightYAxis.setEnabled(false);
// 设置Y轴显示的区间
leftYAxis.setAxisMinimum(0);
leftYAxis.setAxisMaximum(10);
// 设置Y轴值之间的间隔
leftYAxis.setGranularity(2);
// 设置Y轴总共有多少个值
leftYAxis.setLabelCount(6);
// 设置Y轴字体大小
leftYAxis.setTextSize(11);
// 设置Y轴字体颜色
leftYAxis.setAxisLineColor(Color.BLACK);
// 设置Y轴的粗细
leftYAxis.setAxisLineWidth(1f);
// 给Y轴设置新的标签（值）
leftYAxis.setValueFormatter(new IAxisValueFormatter() {
    @Override
    public String getFormattedValue(float v, AxisBase axisBase) {
        return (int)v + "h";
    }
});

/** 限制线 **/
// 创建一个新的限制线
LimitLine limitLine = new LimitLine(8,"限制线");
// 设置限制线的宽度
limitLine.setLineWidth(2);
limitLine.setTextSize(11);
limitLine.setTextColor(Color.parseColor("#B22222"));
limitLine.setLineColor(Color.RED);
leftYAxis.addLimitLine(limitLine);

/** 图例 **/
Legend legend = mBarChart.getLegend();
// 设置图例的文本颜色
legend.setTextColor(Color.BLACK);
legend.setTextSize(12);

/** 图表标题 **/
Description description = new Description();
description.setText("图表标题");
description.setTextSize(17);
WindowManager windowManager = (WindowManager) getSystemService(Context.WINDOW_SERVICE);
int w = windowManager.getDefaultDisplay().getWidth();
description.setPosition(w / 2 + 100, 90);
mBarChart.setDescription(description);