一.问题
在android的学习中我们经常需要做做一些小demo。
（1)一个demo建立一个项目：
demo多了，项目就多了，会有各种不方便。
(2)于是，建立一个demo项目来，然后，第一个Activity呢，主界面是一个 Activity.里面是各个具体的Activity的入口。
这个时候我的做法是。主界面的布局是一个LinearLayout然后里面多一个具体的Demo就多一个Button入口。
布局如下：
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:tools="http://schemas.android.com/tools"
android:id="@+id/root_view"
android:layout_width="match_parent"
android:layout_height="match_parent"
android:orientation="vertical" >
<Button
android:id="@+id/button1"
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:text="Demo1" />
<Button
android:id="@+id/button2"
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:text="Demo2" />
<Button
android:id="@+id/button3"
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:text="Demo3" />
</LinearLayout>
然后，在代码里为Button注册点击事件，处理事件，启动对应具体的Demo界面。
一般来说，这样的解决方案是够了。
但是有没有简洁，更具有扩展性的解决方案呢？
这个时候，我想到了Android的ApiDemos。我想看看Android自己是怎么做的。
于是我发现了一个一个更优雅更具有技术含量，更具有Android的技术特色的解决方案：
主要是这个Activity子类：
com.example.android.apis.ApiDemos
它也是一个ListActivity子类，整个类文件100多行代码。比较优雅的实现了问题的主要功能。
这是我首先要告诉大家的是，当我们运行ApiDemos时，首次运行看到的界面(我称之为根目录)是ApiDemos这个Activity,
子目录的显示也是这个ApiDemos这个Activity.
提示：其实，如果你自己单步调试下，应该很快就可以了解了。就不用再往下看了。不是吗？
我们知道，根目录显示的入口如下：
清单一：
/-Accessibility
-Animation
-App
-Content
-Graphics
-Media
-NFC
-OS
-Preference
-Text
-Views
App子目录显示的入口如下：
清单二：
/-App
-ActionBar
-Activity
-Alarm
-Alert Dialogs
-Device Admin
-Fragment
-Launcher Shortcuts
-Loader
-Menu
-Notification
-Search
-Service
-Text-To-Speech
-Voice Recognition
在这里，我们就有几个疑问：
（0）ApiDemos是如何知道本应用中的所有Activity的呢?
（1)ApiDemos是如何知道，当前是应该显示根目录呢？还是子目录呢？
（2）ApiDemos是如何知道当前目录应该显示哪些入口条目呢？即ApiDemos是如何确定Activity的层级关系的呢？
（3）ApiDemos是如何让点击条目进去是显示子目录呢？还是显示具体的Demo的Activity呢？
我们所有的问题，都可以从代码中找出答案：
问题(0):
我们想是不是android平台提供了某种方法让我们可以直接查询出本应用的所有Activity.
好像没有但是android为我们了Intent这样一个东西。我们可以根据某一个Intent来查询所有符合些Intent条件的 Activity.
我们可以从ApiDemos的Manifest可以看到，几乎所有的除ApiDemos这个Activity之外的Activity都有如下的一个 Intent-filter:
清单三：
<intent-filter>
<action android:name="android.intent.action.MAIN" />
<category android:name="android.intent.category.SAMPLE_CODE" />
</intent-filter>
如是可以通过构造出符合此intent-filter的intent了如下：
清单四：
Intent mainIntent = new Intent(Intent.ACTION_MAIN, null);
mainIntent.addCategory(Intent.CATEGORY_SAMPLE_CODE);
然后利用android的包管理器类(PackageManager)就可以查询出符合条件的的 Activity的信息了，代码如下：
清单五：
PackageManager pm = getPackageManager();
List<ResolveInfo> list = pm.queryIntentActivities(mainIntent, 0);
得到了所有的Demo的Activity的信息的列表。
到此，问题（0）基本解决。关于PackageManger后面还会讲到。这里暂时不表。
接下来要做的就是为这些Activity组织显示层级入口了。
在所有的数据中查找某一个层级的目录入口。所以都可以算是查找工作了。
关于这个确定层级，我们可以想到的一种方案是以包名的层级来确定：
对于第一层子目录来说确实是可以这样的。但是对于这二层目录就不可以了。
就比如com.example.android.apis.app就没有子包了，但是还有不实际应用中还有几个层级的子目录呢。
所以，因为代码不是我们写所以这个层级确实方案不可行。但是如果是自己写代码倒还是可行的。
但是，android采用了一种类似的，但是我觉得更麻烦的方案，就是为每一个Activity设置一个label.
这样。在label中标明了此Activity的层级：
例如：HelloWorld这个Activity的在Manifest中声明如下：
清单六：
<activity
android:name=".app.HelloWorld"
android:label="@string/activity_hello_world" >
<intent-filter>
<action android:name="android.intent.action.MAIN" />
<category android:name="android.intent.category.SAMPLE_CODE" />
</intent-filter>
</activity>
其中@string/activity_hello_world这个标签值如下：
清单七：
<string name="activity_hello_world">
App/Activity/<b>Hello <i>World</i></b>
</string>
这个label告诉我们，HelloWorld这个Activity可以在App目录下的 Activity目录下找到。
事实也是如此。
于是当我们点击App时，我们可以向ApiDemos传递App这样一个标签前缀。只要其它的Activity的label的前缀也是
App/那么就是App下的子目录下的项了。
下面来看看具体的代码吧：
（a)组织根目录入口显示，（即，清单一 所显示的入口列表）
根目录，特殊一点，因为标签没有前缀。
先看onCreate()方法中的代码
清单八：
Intent intent = getIntent();
String path =intent.getStringExtra("com.example.android.apis.Path");
if (path == null) {
path = "";
}
上面的代码首先获得启动ApiDemos这个Activity的Intent.
然后尝试从intent读取指定标签前缀信息。
由于是第一个启动的Activity因此没有相信信息。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 }
)
);
我们主要是关注getData(path)这个方法：
getData(path)中获得整个应用demo Activity的代码在清单四，清单五中有说明：
然后是处理activity信息的标签信息：
清单十：
String[] prefixPath;
String prefixWithSlash = prefix;
if (prefix.equals("")) {
prefixPath = null;
} else {
prefixPath = prefix.split("/");
prefixWithSlash = prefix + "/";
}
其中，prefixPath数组是来存放如果activity的label字符串以'/'分隔的字标签前缀数组：
例如当prefix为"App/Activity"时，
那么prefixPath就等于：数组{"App","Activity"}
prefixWithSlash为"App/Activity/"
(提示：我想我应该提醒一下，slash就是斜杠的意思。
而prefixWithSlash就是因为如果prefix为App而以此作为前缀时，
可能会与前缀为AppThis,AppThat等等前缀弄混。虽然在ApiDemos目前没有这种情况。
所以加了一个slash.因为名称是不能有slash )
但是我们的组织根目录入口时，prefix为空字符串，所以prefixPath为null.
然后是一个for循环来查找所需要根目录入口：
首先是：
获得activity信息的标签信息，如果此activity没有声明标签信息则用activity名作为标签信息：
清单十一：
ResolveInfo info = list.get(i);
CharSequence labelSeq = info.loadLabel(pm);
String label = ( (labelSeq != null) ?
labelSeq.toString()
: info.activityInfo.name);
对于HelloWorld这个Activity来说其activityInfo.name为com.example.android.apis.app.HelloWorld
即其类的全名。对于HelloWorld来说我们知道有标签的：
于是label为： App/Activity/Hello World ，
得到label之后，接下来是一个if语句：
清单十二：
if (prefixWithSlash.length() == 0 || label.startsWith(prefixWithSlash))
prefixWithSlash.length() == 0也就是说此时是查找根目录的入口。
label.startsWith(prefixWithSlash)也就是说，查找查看prefix为前缀的子Activity。
然后是找出为下一次传递给ApiDemos的标签前缀：
清单十三：
String[] labelPath = label.split("/");
String nextLabel = prefixPath == null ? labelPath[0]
: labelPath
还是以HelloWorld这个Acitivity的标签信息为例：
label为"App/Activity/Hello World"
则labelPath为{"App","Activity","Hello World"}
显然对于根目录,prefixPath为空，所以取数组第一项作为一个子目录入口项：
于是,此入口项要传递给子目录的标签前缀
nextLabel为labelPath[0],
此时如下是查找App目录下的子目录,prefixPath为{"App"}，数组长度为1.
则下一个标签则为 App",到App/Activity这一个层级的话，
nextLabel为"Activity"
传递过去的应该是：prefixPath+"/"+nextLabel.
下面会有。
清单十四：
if ((prefixPath != null ? prefixPath.length : 0) == labelPath.length - 1)
上面的代码要判断是，这个条目要打开是一个具体的Demo的Activity呢？
还是用于浏览子目录呢？
还是以HelloWorld为例，
label为"App/Activity/Hello World"
labelPath为{"App","Activity","Hello World"} ，数组长度为3
如果此时：prefixPath为{"App","Activity"} ，数组长度为2
2 ＝＝ （3－1）于是此时入口应该是打开HelloWorld这个Activity
对于们根目录来说,prefixPath为null，
此时如果一个Activity的label为例如"JustADemo"
那么 0 = 1 - 1,
这也是一个应该直接打开的具体的Demo的Activity入口。
否则就是要打开一个子目录入口的目录项了：
将此项添加进列表中：
清单十六：
if (entries.get(nextLabel) == null) {
String nextPrefixLabel = prefix.equals("") ? nextLabel : prefix + "/"
+ nextLabel;
addItem(myData, nextLabel, browseIntent(nextPrefixLabel));
entries.put(nextLabel, true);
}
因为根目录的入口只有那么几个，整个的Activity确有292个左右，所以很多肯定有同一个第一级子目录标签。
如"App"如果已经从之前的Activity的标签中找出App这个子目录入口了，就不需要添加了。
因为使用了entries这样一个Map这样一个数据结构来判断。
如果还没有得到子目录需要传递的下一个标签前缀。然后得到将下一个目录项添加进列表中。
我们来看看browseIntent()这个方法：
清单十七：
protected Intent browseIntent(String path) {
Intent result = new Intent();
result.setClass(this, ApiDemos.class);
result.putExtra("com.example.android.apis.Path", path);
return result;
}
这个方法构造出一个用于打开浏览子目录项的Intent.
显然可以看出，是用ApiDemos这个Activity来浏览的。
然后是：activityIntent()
清单十八：
protected Intent activityIntent(String pkg, String componentName) {
Intent result = new Intent();
result.setClassName(pkg, componentName);
return result;
}
得到某启动某一个具体的Demo的Activity的Intent.
清单十九：
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);
}
组织用于List显示的item.
清单二十：
@Override
@SuppressWarnings("unchecked")
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);
}
当用户点击某一个列表项时，启动对应Intent的Activity.
相信如果你看到这里，对于ApiDemos应该有相当的了解了吧。前面提供了问题都有答案了吧。
其实，如果你自己单步调试下，应该很快就可以了解了。不是吗？
如果你了解了，下面分享一个具体的应用场景：android指定分享到新浪微博
再回到我们之前提到的PackageManager。
一般的分享我们是这样做的：
private void share() {
Intent intent = new Intent(Intent.ACTION_SEND);
intent.setType("text/plain");
intent.putExtra(Intent.EXTRA_SUBJECT, "分享我的文章");
intent.putExtra(
Intent.EXTRA_TEXT,"我刚发表的文章，来看看吧，地址：http://aa.bb.cc/a.html");
intent.putExtra(Intent.EXTRA_TITLE, "分享我的文章");
String title = "分享我的文章给好友";
Intent chooser = Intent.createChooser(intent, title);
startActivity(chooser);
}
这段代码会弹出一个可以用于分享的选择器，然后选择某一项来分享。
但是我们需要直接分享到新浪微博呢?
首先，我们可以通在安装有新浪微博的设备上运行，
Intent intent = new Intent(Intent.ACTION_SEND);
intent.setType("text/plain");
PackageManager pm = getPackageManager();
List<ResolveInfo> list = pm.queryIntentActivities(intent, 0);
还得到所以可以用于分享的组件，然后不管是通过调试或者打印得出来，某你所想要分享的组件的信息。
如新浪微博的的包名为"com.sina.weibo"
于是可以通过判断包名,来打开指定的分享intent，代码如下：
PackageManager pm = getPackageManager();
List<ResolveInfo> matches = pm.queryIntentActivities(intent,
PackageManager.MATCH_DEFAULT_ONLY);
String packageName = "com.sina.weibo";
ResolveInfo info = null;
for (ResolveInfo each : matches) {
String pkgName = each.activityInfo.applicationInfo.packageName;
if (packageName.equals(pkgName)) {
info = each;
break;
}
}
if (info == null) {
ToastUtils.showShort(context, "没有找到新浪微博");
return;
} else {
intent.setClassName(packageName, info.activityInfo.name);
}
startActivity(intent);
