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的缘故！

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