Android ApiDemo示例解讀系列之二：ListActivity、SimpleAdapter和PackageManager

       如上一節中所講的那樣創建了ApiDemo工程後，我們就可以進行每個示例代碼的分析了。讀者應對Android開發有基本的了解或讀過Android開發方面的基礎教程。

       首先是看ApiDemo的主Activity：com.example.android.apis.ApiDemos，這個主Activity為ListActivity的子類，主要用來列出ApiDemos中的200多個實例，實例采取分類層次顯示。

       在ApiDemos的onCreate()中的代碼：

1. setListAdapter(new SimpleAdapter(this, getData(path),   
2.  android.R.layout.simple_list_item_1, new String[] { "title" },   
3.  new int[] { android.R.id.text1 }));  

       SimpleAdatper 作為數據源 getData(path) 與 UI ListActivity 之間的橋梁，它的構造函數如下：

       SimpleAdapter(Context context, List<? extends Map<String, ?>> data, int resource, String[] from, int[] to)

       我們知道ListActivity可以用來顯示一個列表，在使用SimpleAdapter時可以借用二維表來更好的理解。 SimpleAdapter的數據源data 類型為List<? extends Map<String, ?>> List 中每一項為一個Map對象，相當於二維表中一行，這一行可以有多列，每列可以有個名字，為Map<String,?> string ，相當於表的列名：

       ApiDemos中每條記錄只顯示一列”title”。 android.R.layout.simple_list_item_1 為用來顯示每條記錄的Layout資源id， ListActivity允許使用自定義Layout ，這裡使用了Android系統資源，simple_list_item_1由一個TextView構成，其id為text1。

       new String[] { “title” } 為需要顯示的列表的數組，ApiDemos只顯示一列“title”，如果有多列：則可以為new String[] { “title”，”field1”,”field2”,”field3” }。

       new int[] { android.R.id.text1 }則指定使用 android.R.layout.simple_list_item_1 中 id 為text1的 TextView 來顯示 “title” 列。 如果有多列，Layout可以定義多個View （不一定都為TextView），然後為每列指定顯示的View的id。

       再來看看getData(path)是如何定義的，protected List getData(String prefix) 返回一個列表。

1. protected List getData(String prefix) {   
2. List<Map> myData = new ArrayList<Map>();   
3.     
4. Intent mainIntent = new Intent(Intent.ACTION_MAIN, null);   
5. mainIntent.addCategory(Intent.CATEGORY_SAMPLE_CODE);   
6.     
7. PackageManager pm = getPackageManager();   
8. List<ResolveInfo> list = pm.queryIntentActivities(mainIntent, 0);   
9.     
10. ... ...   
11. for (int i = 0; i < len; i++) {   
12. ...   
13. if ((prefixPath != null ? prefixPath.length : 0) == labelPath.length - 1) {   
14. addItem(myData, nextLabel, activityIntent(   
15. info.activityInfo.applicationInfo.packageName,   
16. info.activityInfo.name));   
17. } else {   
18. if (entries.get(nextLabel) == null) {   
19. addItem(myData, nextLabel,   
20. browseIntent(prefix.equals("") ? nextLabel : prefix + "/" + nextLabel));   
21. entries.put(nextLabel, true);   
22. }   
23. }   
24. }   
25. }   
26.     
27. Collections.sort(myData, sDisplayNameComparator);   
28.     
29. return myData;   
30. }  

       它通過PackageManager 從 AndroidManifest.xml中讀取所以Intent-Filter含有：Intent.ACTION_MAIN和Intent.CATEGORY_SAMPLE_CODE所有Activity信息。前面說過200多個示例根據其功能分類，比如 Hello World示例它的Label為

       App/Activity/<b>Hello <i>World</i></b>，

       表示它的分類為分類App下Activity子類。getData(String prefix)根據每個Activity的Label屬性和當前層次（prefix)來決定當前列表中某項為葉子列表項，還是分類列表項，如果是葉子列表項，則添加為activityIntent，當用戶點擊改列表項時則會觸發該示例。若是分類列表項，則添加為browseIntent，browseIntent還是觸發ApiDemos Activity，但Intent帶有Extra信息，表示需要顯示改分類下的子類：

1. Intent result = new Intent();   
2. result.setClass(this, ApiDemos.class);   
3. result.putExtra("com.example.android.apis.Path", path);  

       此時如果用戶點擊改節點列表項，則會進入還分類下級目錄。

1. protected void addItem(List<Map> data, String name, Intent intent) {   
2. Map<String, Object> temp = new HashMap<String, Object>();   
3. temp.put("title", name);   
4. temp.put("intent", intent);   
5. data.add(temp);   
6. }   
7.     
8. @Override  
9. protected void onListItemClick(ListView l, View v, int position, long id) {   
10. Map map = (Map) l.getItemAtPosition(position);   
11.     
12. Intent intent = (Intent) map.get("intent");   
13. startActivity(intent);   
14. }  

       addItem 給返回的List中添加一項，每個記錄含兩列：“title”,“intent” ，其中只顯示“title”列，如果想要顯示“intent”列的信息，就不能使用android.R.layout.simple_list_item_1 了，這時可以另外定義一個Layout 來顯示多列數據。 intent可以為觸發示例，如”Hello World”或是下級示例列表，此時觸發的Activity還是ApiDemos。

       此外，ApiDemo還定義了ApiDemosApplication做為Application的子類，如果需要在多個Activity共享一些數據，可以定義在Application中。如果使用了自定義的Application，別忘了修改AndroidManifest.xml ，如下：

1. <application android:name=”ApiDemosApplication”   
2. android:label=”@string/activity_sample_code”   
3. android:icon=”@drawable/app_sample_code” >  
4. …   
5. </application>