ApiDemos示例学习（1）——ApiDemos示例的导入

---恢复内容开始---

今天准备开始写这个ApiDemos示例的学习日记了，放在网上以监督自己！

首先是导入该示例。如果我们在配置Android开发环境是，利用Android SDK 安装包中的SDK Manager.exe文件下载完整的包，里面包含各种API版本的Samples，这里使用的是API 16版本中的ApiDemos。

1、导入ApiDemos示例

　　在eclipse中file->new->android sample project->next，然后在列出的不同版本示例中选择对应版本的ApiDemos示例即可导入示例。成功导入后，可以先看看该示例的结构，在运行该示例。示例结构如下：

可以清楚的看到该工程的目录结构，程序的入口是com.example.android.apis包（这个可以在AndroidManifest.xml文件中查看）的ApiDemos.java文件中。该文件的功能是完成整个示例（包括示例下的所用小示例）的结构设计，十分巧妙，在Mono For Android 的示例包android-app-master包中同样采用相似的结构实现了示例导航的功能。

现在具体分析一下该文件的功能：

 package com.example.android.apis;

 import android.app.ListActivity;
 import android.content.Intent;
 import android.content.pm.PackageManager;
 import android.content.pm.ResolveInfo;
 import android.os.Bundle;
 import android.view.View;
 import android.widget.ListView;
 import android.widget.SimpleAdapter;

 import java.text.Collator;
 import java.util.ArrayList;
 import java.util.Collections;
 import java.util.Comparator;
 import java.util.HashMap;
 import java.util.List;
 import java.util.Map;

 public class ApiDemos extends ListActivity {

     @Override
     public void onCreate(Bundle savedInstanceState) {
         super.onCreate(savedInstanceState);

         Intent intent = getIntent();
         String path = intent.getStringExtra("com.example.android.apis.Path");

         if (path == null) {
             path = "";
         }

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

     protected List<Map<String, Object>> getData(String prefix) {
         List<Map<String, Object>> myData = new ArrayList<Map<String, Object>>();

         Intent mainIntent = new Intent(Intent.ACTION_MAIN, null);
         mainIntent.addCategory(Intent.CATEGORY_SAMPLE_CODE);

         //通过PackageManager从AndroidManifest.xml中读取所有含有Intent.ACTION_MAIN
         //和Intent.CATEGORY_SAMPLE_CODE的所有Activity信息
         PackageManager pm = getPackageManager();
         List<ResolveInfo> list = pm.queryIntentActivities(mainIntent, 0);

         if (null == list)
             return myData;

         String[] prefixPath;
         String prefixWithSlash = prefix;

         if (prefix.equals("")) {
             prefixPath = null;
         } else {
             prefixPath = prefix.split("/");
             prefixWithSlash = prefix + "/";
         }

         //变量len 记录了满足条件的Activity个数
         int len = list.size();

         Map<String, Boolean> entries = new HashMap<String, Boolean>();

         for (int i = 0; i < len; i++) {
             ResolveInfo info = list.get(i);//获取对应activity的ResolveInfo信息
             CharSequence labelSeq = info.loadLabel(pm);//获取对应activity的android:label属性值

             //如果为空，则label初始化为activity对应的android:name属性值，否则直接转换为string赋值给label
             String label = labelSeq != null
                     ? labelSeq.toString()
                     : info.activityInfo.name;//anctivityInfo.name对应于属性android:name

             if (prefixWithSlash.length() == 0 || label.startsWith(prefixWithSlash)) {

                 String[] labelPath = label.split("/");

                 //prefixPath为空时，nextLabel值为labelPath第一个字符串；否则为labelPath中索引为prefixPath长度的值，不会造成越界因为
                 //prefixPath的最大长度永远比labelPath最大长度小1
                 String nextLabel = prefixPath == null ? labelPath[0] : labelPath[prefixPath.length];

                 if ((prefixPath != null ? prefixPath.length : 0) == labelPath.length - 1) {
                     addItem(myData, nextLabel, activityIntent(
                             info.activityInfo.applicationInfo.packageName,
                             info.activityInfo.name));
                 } else {
                     if (entries.get(nextLabel) == null) {
                         addItem(myData, nextLabel, browseIntent(prefix.equals("") ? nextLabel : prefix + "/" + nextLabel));
                         entries.put(nextLabel, true);
                     }
                 }
             }
         }

         Collections.sort(myData, sDisplayNameComparator);

         return myData;
     }

     private final static Comparator<Map<String, Object>> sDisplayNameComparator =
         new Comparator<Map<String, Object>>() {
         private final Collator   collator = Collator.getInstance();

         public int compare(Map<String, Object> map1, Map<String, Object> map2) {
             return collator.compare(map1.get("title"), map2.get("title"));
         }
     };

     //叶子列表项对应的Intent
     protected Intent activityIntent(String pkg, String componentName) {
         Intent result = new Intent();
         result.setClassName(pkg, componentName);
         return result;
     }

     //分类列表项对应的Intent
     protected Intent browseIntent(String path) {
         Intent result = new Intent();
         result.setClass(this, ApiDemos.class);
         result.putExtra("com.example.android.apis.Path", path);
         return result;
     }

     protected void addItem(List<Map<String, Object>> data, String name, Intent intent) {
         Map<String, Object> temp = new HashMap<String, Object>();
         temp.put("title", name);
         temp.put("intent", intent);
         data.add(temp);
     }

     @Override
     protected void onListItemClick(ListView l, View v, int position, long id) {
         Map<String, Object> map = (Map<String, Object>)l.getItemAtPosition(position);

         Intent intent = (Intent) map.get("intent");
         startActivity(intent);
     }
 }

代码的103-109行自定义了一个比较器，用来对列表项进行排序。

注意：

ListActivity中的listView的每个Item都包含以下内容：

1、  title，显示出来的内容；

2、  intent，隐藏的内容，Intent类型主要有两种：

　　一种指向叶子列表项，点击后运行具体的Activity；

　　一种指向分类列表项，即点击后仍运行ApiDemos这个继承自ListActivity的Activity，只是此时该Activity对应的SimpleAdapter不一样了，因而类表显示的内容也不一样了。

可以在eclipse中调试运行，这样可以更快的理解具体的流程：

第一次获取数据源后（通过getData（）获得），数据源的title项如下：

　　Accessibility

　　Animation

　　App

　　Content

　　Graphics

　　Media

　　NFC

　　OS

　　Preference

　　Text

　　Views

点击上面列出的项目后，如点击App后，将会启动App项隐藏的Intent 对应的Activity， 而该Activity仍为ApiDemos，所以进入之后就重新创建并初始化myData，其对应的内容为：

　　ActionBar

　　Activity

　　Alarm

　　…

点击上面列出的项目后，如点击Activity后，将会启动Activity项隐藏的Intent对应的Activity，而该Activity仍为ApiDemos，所以进入之后重新创建并初始化myData，其对应的内容为：

　　Animation

　　Custom Dialog

　　Custom Title

　　…

点击上面列出的项目后，如Custom Title后，将会启动Custom Title项隐藏的Intent对应的Activity，这是情况不一样了，此时的Activity对应的名称为ResolveInfo对象info中保存的名称为info.activityInfo.name的Activity，这是就可以看到效果！（此时就会呈现具体的界面）

我们看到的列表显示效果都是按字典序排列的，这是因为在结尾调用了自定义的比较器sDisplayNameComparator的缘故！

通过以上比较笨的步骤就能大致了解整个示例安排的结构了，噢耶！