---恢复内容开始---
今天准备开始写这个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的缘故！
通过以上比较笨的步骤就能大致了解整个示例安排的结构了，噢耶！