【起航计划 003】2015 起航计划 Android APIDemo的魔鬼步伐 02 SimpleAdapter,ListActivity,PackageManager参考

01 API Demos

ApiDemos 详细介绍了Android平台主要的 API，android 5.0主要包括下图几个大类，涵盖了数百api示例：

02 入口类: SimpleAdapter,ListActivity,PackageManager的使用

ApiDemos采用分类层次显示，ApiDemo是ApiDemos的入口类，继承自ListActivity，该类的主要功能是分类列出大类，进而更进一步显示示例。

ListActivity可以看做为一个含有ListView的Activity，可以不用setContentView设置布局，除非你想定制自己的List布局，这样的话，你的布局中必须包含一个id为"@id/android:list"的ListView。 若你还指定了一个id为"@id/android:empty"的view，当ListView中没有数据要显示时，这个view就会被显示，同时 ListView会被隐藏。

ListActivity使用方法  

ListActivity英文API

ApiDemo这个类可以作为ListActivity使用的参考示例。

在ApiDemos 的 onCreate()中代码：

　　　　 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);

 这里直接调用ListActivity的setListAdapter给ListView设置适配器。

SimpleAdapter在这里作为数据源getData(path)与ListView（ListActivity）之间的桥梁，它的构造函数如下：

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

 简约而不简单——Android SimpleAdapter

使用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) 返回一个列表

    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 pm = getPackageManager();　　　　　　　　　　　　　　　 //这部分通过PackageManager从 AndroidManifest.xml中读取所
        List<ResolveInfo> list = pm.queryIntentActivities(mainIntent, 0);　　//有Intent-Filter含有：Intent.ACTION_MAIN和 Intent.CATEGORY_SAMPLE_CODE所有Activity信息

        if (null == list)
            return myData;

        String[] prefixPath;
        String prefixWithSlash = prefix;
        
        if (prefix.equals("")) {
            prefixPath = null;
        } else {
            prefixPath = prefix.split("/");
            prefixWithSlash = prefix + "/";
        }
        
        int len = list.size();
        
        Map<String, Boolean> entries = new HashMap<String, Boolean>();

        for (int i = 0; i < len; i++) {
            ResolveInfo info = list.get(i);
            CharSequence labelSeq = info.loadLabel(pm);
            String label = labelSeq != null
                    ? labelSeq.toString()
                    : info.activityInfo.name;
            
            if (prefixWithSlash.length() == 0 || label.startsWith(prefixWithSlash)) {
                
                String[] labelPath = label.split("/");

                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;
    }

它通过PackageManager 从 AndroidManifest.xml中读取所有Intent-Filter含有：Intent.ACTION_MAIN和 Intent.CATEGORY_SAMPLE_CODE所有Activity信息。前面说过数百个示例根据其功能分类，比如 Hello World示例它的Label为

App/Activity/<b>Hello <i>World</i></b>，表示它的分类为分类App下Activity子类。

        <!-- Activity Samples -->

        <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 name="activity_hello_world">App/Activity/<b>Hello <i>World</i></b></string>

getData(String prefix)根据每个Activity的Label属性和当前层次（prefix)来决定当前列表中某项为叶子列表项，还是分类列表项，如果是叶子列表项，则添加为activityIntent，当用户点击改列表项时则会触发该示例。若是分类列表项，则添加为 browseIntent，browseIntent还是触发ApiDemos Activity,但Intent带有Extra信息，表示需要显示该分类下的子类：

    protected Intent activityIntent(String pkg, String componentName) {
        Intent result = new Intent();
        result.setClassName(pkg, componentName);
        return result;
    }
    
    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
    @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 = new Intent((Intent) map.get("intent"));
        intent.addCategory(Intent.CATEGORY_SAMPLE_CODE);
        startActivity(intent);
    }

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 ，如下：

<application android:name="ApiDemosApplication"
            android:label="@string/activity_sample_code"
            android:icon="@drawable/app_sample_code"
            android:hardwareAccelerated="true"
            android:supportsRtl="true">

…

</application>