HelloCharts——Android数据可视化库引入及使用

发布时间：2023-05-21

一、概述

HelloCharts是一个开源的Android数据可视化库，可以方便快速地实现各种数据可视化效果，包括折线图、柱状图、饼状图、散点图等等。它不仅提供了丰富的图表样式和配置选项，而且易于使用和集成。使用HelloCharts可以帮助我们更好地理解和展示数据，支持用户更直观、清晰地了解数据背后的含义。

二、引入HelloCharts库

1、首先，需要在项目的build.gradle文件中添加以下依赖项以引入库：

dependencies {
   implementation 'com.github.lecho:hellocharts-library:1.5.9@aar'
}

2、在XML布局文件中，添加HelloCharts控件，例如添加一个Line Chart：

<lecho.lib.hellocharts.view.LineChartView
   android:id="@+id/chart"
   android:layout_width="match_parent"
   android:layout_height="match_parent" />

三、绘制折线图(Line Chart)

1、定义数据源

List<PointValue> values = new ArrayList<PointValue>();
values.add(new PointValue(0, 2));
values.add(new PointValue(1, 4));
values.add(new PointValue(2, 3));
values.add(new PointValue(3, 6));
values.add(new PointValue(4, 8));

2、定义线条及其属性

Line line = new Line(values);
line.setColor(Color.BLUE); // 设置线的颜色
line.setHasPoints(true); // 显示线上的点
line.setCubic(true); // 显示线条样式
line.setHasLabels(true); // 显示点的标签

3、定义X轴和Y轴，并设置属性

Axis axisX = new Axis();
Axis axisY = new Axis().setHasLines(true);
axisX.setName("X轴");
axisY.setName("Y轴");
List<AxisValue> xValues = new ArrayList<AxisValue>();
xValues.add(new AxisValue(0).setLabel("0"));
xValues.add(new AxisValue(1).setLabel("1"));
xValues.add(new AxisValue(2).setLabel("2"));
xValues.add(new AxisValue(3).setLabel("3"));
xValues.add(new AxisValue(4).setLabel("4"));
axisX.setValues(xValues);

4、将所有定义好的属性设置到LineChartData中

LineChartData data = new LineChartData();
data.setAxisXBottom(axisX); // X轴在底部
data.setAxisYLeft(axisY); // Y轴在左边
data.setLines(Collections.singletonList(line));
chart.setLineChartData(data); // 设置数据

四、绘制柱状图(Column Chart)

1、定义数据源

List<SubcolumnValue> values = new ArrayList<SubcolumnValue>();
values.add(new SubcolumnValue(2.0f, Color.BLUE));
values.add(new SubcolumnValue(4.0f, Color.RED));
values.add(new SubcolumnValue(1.0f, Color.GREEN));
values.add(new SubcolumnValue(3.0f, Color.YELLOW));
values.add(new SubcolumnValue(5.0f, Color.CYAN));
Column column = new Column(values);
List<Column> columns = new ArrayList<Column>();
columns.add(column);

2、定义柱子属性

column.setHasLabels(true); // 显示柱子标签
column.setHasLabelsOnlyForSelected(false);

3、定义X轴和Y轴，并设置属性

Axis axisX = new Axis();
Axis axisY = new Axis().setHasLines(true);
axisX.setName("X轴");
axisY.setName("Y轴");
List<AxisValue> xValues = new ArrayList<AxisValue>();
xValues.add(new AxisValue(0).setLabel("0"));
xValues.add(new AxisValue(1).setLabel("1"));
xValues.add(new AxisValue(2).setLabel("2"));
xValues.add(new AxisValue(3).setLabel("3"));
xValues.add(new AxisValue(4).setLabel("4"));
axisX.setValues(xValues);

4、将所有定义好的属性设置到ColumnChartData中

ColumnChartData data = new ColumnChartData();
data.setAxisXBottom(axisX); // X轴在底部
data.setAxisYLeft(axisY); // Y轴在左边
data.setColumns(columns);
chart.setColumnChartData(data); // 设置数据

五、绘制饼状图(Pie Chart)

1、定义数据源

List<SliceValue> values = new ArrayList<SliceValue>();
values.add(new SliceValue(2, Color.BLUE).setLabel("A"));
values.add(new SliceValue(4, Color.RED).setLabel("B"));
values.add(new SliceValue(1, Color.GREEN).setLabel("C"));
values.add(new SliceValue(3, Color.YELLOW).setLabel("D"));
values.add(new SliceValue(5, Color.CYAN).setLabel("E"));

2、将所有定义好的属性设置到PieChartData中

PieChartData data = new PieChartData(values);
data.setHasLabels(true); // 显示标签
data.setHasLabelsOutside(false); // 标签在块外侧
data.setHasCenterCircle(true); // 显示中心圆形
data.setSlicesSpacing(2); // 块之间的间距
chart.setPieChartData(data); // 设置数据

六、其他图表类型

HelloCharts支持多种其他类型的图表，如散点图、堆积柱状图、范围柱状图等等，同样使用方法是类似的。可以通过查看HelloCharts的GitHub仓库中的demo项目来了解所有支持的图表类型和实现方式。

七、总结

本文介绍了如何在Android项目中引入HelloCharts库，并使用其绘制折线图、柱状图与饼状图。通过HelloCharts，我们可以方便地展示和分析数据，帮助我们更好地理解数据本身的含义。使用HelloCharts可以提高数据分析及展示效率，为开发提供强有力支持。

推荐文章