AChartEngine(簡稱ACE)是Google的一個開源圖表庫(for Android)。它功能強大,支持散點圖、折線圖、餅圖、氣泡圖、柱狀圖、短棒圖、儀表圖等多種圖表。
你可以選擇合適的版本下載,每個版本都有一個jar包、實例源代碼和java doc提供下載。當前最新版本爲0.6。
需要注意的是,0.6版本不再支持Android 2.0以下(包含2.0)。也就是說如果你的目標平臺使用了7以下SDK版本,比如Android 1.5-2.0。則需要下載老版本的ACE 0.5。
本文以ACE 0.5爲例。
1、新建Android Project
在工程中新建一個文件夾比如lib,用於存放ACE Libraries,把achartegine-0.5.0.jar包複製到lib裏面。
然後把這個jar的路徑添加到項目的Build Path中。
2、修改AndroidManifest.xml
主要是加入一個<activity>:
< activity android:name = "org.achartengine.GraphicalActivity" />
呆會我們使用ACE生成柱狀圖,會在一個特殊的Activit中才能顯示,這個Activity就是ACE庫中的 GraphicalActivity 。我們需要在AndroidManifest.xml中申明它,否則Android會報找不到Activity錯誤。
3、新建Activity
新建一個類,比如叫做main:
public class main extends ListActivity {
private static final int SERIES_NR = 2;
/** Called when the activity is first created. */
private ArrayList<Map<String,String>> maps = new ArrayList<Map<String,String>>();
@Override
public void onCreate(Bundle savedInstanceState) {
super .onCreate(savedInstanceState);
// setContentView(R.layout.main);
// 加入 ListItem “ 調度查詢 ”
HashMap<String,String> map= new HashMap<String,String>();
map.put( "name" , " 柱狀圖 " );
map.put( "desc" , " 顯示柱狀圖 " );
maps .add(map);
// 構建 listView 的適配器
SimpleAdapter adapter= new SimpleAdapter( this , maps ,
android.R.layout. simple_list_item_2 , // SDK 庫中提供的一個包含兩個 TextView 的 layout
new String[]{ "name" , "desc" }, // maps 中的兩個 key
new int []{android.R.id. text1 ,android.R.id. text2 } // 兩個 TextView 的 id
);
this .setListAdapter(adapter);
}
// ListItem 監聽器方法
protected void onListItemClick(ListView l, View v, int position, long id) {
super .onListItemClick(l, v, position, id);
XYMultipleSeriesRenderer renderer = getBarDemoRenderer();
Intent intent = ChartFactory.getBarChartIntent ( this , getBarDemoDataset(), renderer, Type. DEFAULT );
startActivity(intent);
}
private XYMultipleSeriesDataset getBarDemoDataset() {
XYMultipleSeriesDataset dataset = new XYMultipleSeriesDataset();
final int nr = 10;
Random r = new Random();
for ( int i = 0; i < SERIES_NR ; i++) {
CategorySeries series = new CategorySeries( "Demo series " + (i + 1));
for ( int k = 0; k < nr; k++) {
series.add(100 + r.nextInt() % 100);
}
dataset.addSeries(series.toXYSeries());
}
return dataset;
}
public XYMultipleSeriesRenderer getBarDemoRenderer() {
XYMultipleSeriesRenderer renderer = new XYMultipleSeriesRenderer();
SimpleSeriesRenderer r = new SimpleSeriesRenderer();
r.setColor(Color. BLUE );
renderer.addSeriesRenderer(r);
r = new SimpleSeriesRenderer();
r.setColor(Color. GREEN );
renderer.addSeriesRenderer(r);
setChartSettings(renderer);
return renderer;
}
private void setChartSettings(XYMultipleSeriesRenderer renderer) {
renderer.setChartTitle( "Chart demo" );
renderer.setXTitle( "x values" );
renderer.setYTitle( "y values" );
renderer.setXAxisMin(0.5);
renderer.setXAxisMax(10.5);
renderer.setYAxisMin(0);
renderer.setYAxisMax(210);
}
}
先把上面的代碼進行簡單的複製粘貼。好了,運行程序試試:
好了,下面來看代碼。
onCreate方法不需要多說了吧,一個ListActivity而已。
在 onListItemClick 方法中,當用戶點擊了“顯示圖表”之後,構造一個intent對象,然後用startActivity發送消息到前面AndroidManifest.xml申明的那個activity( 即 GraphicalActivity )。於是圖表就顯示出來了。
關鍵是intent的構造方法 ChartFactory.getBarChartIntent。
ChartFactory提供了許多有用的工廠方法,如果你需要生成一個折線圖,可以用它的 getLineChartIntent 方法。
getBarChartIntent 方法有點複雜,需要我們準備很多參數傳入。其中一個是 XYMultipleSeriesDataset 類型的對象,用於提供圖表需要表示的數據集,這裏我們用 getBarDemoDataset 來得到它。另外一個是 XYMultipleSeriesRenderer 類型的對象,用於提供圖表展現時的一些樣式,這裏我們用 getBarDemoRenderer 方法來得到它。
getLineChartIntent 方法很無聊,使用了一些隨機數來作爲圖表數據。注意柱狀圖是支持多系列的,這裏生成了兩個系列的數據。
getBarDemoRenderer 方法構建了一個 XYMultipleSeriesRenderer 用來設置2個系列各自的顏色,然後調用 setChartSettings 方法設置了下座標軸樣式。