入门

本章介绍使用此库的基本设置。

添加依赖

首先，将此库的依赖项添加到项目中。如何执行此操作在此存储库的部分中进行了描述。Gradle是使用此库作为依赖项的推荐方法。

创建视图

要使用LineChart, BarChart, ScatterChart, CandleStickChart, PieChart, BubbleChart or RadarChart ，请在.xml中定义它：

然后从您的Activity，Fragment或其他内容中检索它:

// in this example, a LineChart is initialized from xml    LineChart chart = (LineChart) findViewById(R.id.chart);

或者在代码中创建它（然后将其添加到布局中）：

// programmatically create a LineChart    LineChart chart = new LineChart(Context);    // get a layout defined in xml    RelativeLayout rl = (RelativeLayout) findViewById(R.id.relativeLayout);    rl.add(chart); // add the programmatically created chart

添加数据

拥有图表实例后，您可以创建数据并将其添加到图表中。此示例使用LineChart，其中Entry类表示图表中具有x和y坐标的单个条目。其他图表类型（例如BarChart）使用其他类（例如BarEntry）。

要将数据添加到图表中，请将您拥有的每个数据对象包装到Entry对象中，如下所示：

YourData[] dataObjects = ...;List
     
       entries = new ArrayList
      
       ();for (YourData data : dataObjects) {    // turn your data into Entry objects    entries.add(new Entry(data.getValueX(), data.getValueY())); }
      
     

下一步，您需要将创建的List<Entry>添加到LineDataSet对象中。DataSet对象保存属于一起的数据，并允许对该数据进行单独设计。以下使用的“Label ”仅具有描述性目的，并在Legend中显示（如果已启用）。

LineDataSet dataSet = new LineDataSet(entries, "Label"); // add entries to datasetdataSet.setColor(...);dataSet.setValueTextColor(...); // styling, ...

最后一步，您需要将创建的LineDataSet对象（或多个对象）添加到LineData对象中。此对象包含由Chart实例表示的所有数据，并允许进一步样式化。创建数据对象后，您可以将其设置为图表并刷新它：

LineData lineData = new LineData(dataSet);chart.setData(lineData);chart.invalidate(); // refresh

请考虑上面的场景一个非常基本的设置。有关更详细的说明，请参阅部分，它解释了如何根据示例将数据添加到各种图表类型。

造型

有关图表表面和数据的设置和样式的信息，请访问部分。有关各个图表类型的更具体的样式和设置，请查看 Wiki页面。

参考：