Android Settings 设置中 PreferenceActivity中,Header是如何被加载的?

-----------------------------------------------------
本文主要回答下面这个问题:
Android中,Header是如何被PreferenceActivity进行加载的?
-----------------------------------------------------

 

在Android应用程序中,我们可以在继承自PreferenceActivity的页面中通过两种方式,加载设置项。

其一:loadHeadersFromResource

[java]  view plain copy 在CODE上查看代码片 派生到我的代码片
  1. @Override  
  2.     public void onBuildHeaders(List<header> headers) {  
  3.         loadHeadersFromResource(R.xml.settings_headers, headers);  
  4.   
  5.         updateHeaderList(headers);  
  6.   
  7.         mHeaders = headers;  
  8.     }</header>  

settings_headers.xml

[html]  view plain copy 在CODE上查看代码片 派生到我的代码片
  1. <preference-headers  
  2.         xmlns:android="http://schemas.android.com/apk/res/android">  
  3.   
  4.   
  5.     <!-- WIRELESS and NETWORKS -->  
  6.     <header android:title="@string/header_category_wireless_networks" />  
  7.   
  8.     <!-- Wifi -->  
  9.     <header  
  10.         android:id="@+id/wifi_settings"  
  11.         android:fragment="com.android.settings.wifi.WifiSettings"  
  12.         android:title="@string/wifi_settings_title"  
  13.         android:icon="@drawable/ic_settings_wireless" />  
  14.   
  15.     <!-- Bluetooth -->  
  16.     <header  
  17.         android:id="@+id/bluetooth_settings"  
  18.         android:fragment="com.android.settings.bluetooth.BluetoothSettings"  
  19.         android:title="@string/bluetooth_settings_title"  
  20.         android:icon="@drawable/ic_settings_bluetooth2" />  
  21.   
  22. </preference-headers>  


其二:

[java]  view plain copy 在CODE上查看代码片 派生到我的代码片
  1. addPreferencesFromResource(R.xml.device_info_settings);  

device_info_settings.xml

[html]  view plain copy 在CODE上查看代码片 派生到我的代码片
  1. <PreferenceScreen xmlns:android="http://schemas.android.com/apk/res/android"  
  2.         android:title="@string/about_settings">  
  3.   
  4.         <!-- System update settings - launches activity -->  
  5.         <PreferenceScreen android:key="system_update_settings"  
  6.                 android:title="@string/system_update_settings_list_item_title"   
  7.                 android:summary="@string/system_update_settings_list_item_summary">  
  8.             <intent android:action="android.settings.SYSTEM_UPDATE_SETTINGS" />  
  9.         </PreferenceScreen>  
  10.   
  11.   
  12.         <PreferenceScreen android:key="additional_system_update_settings"  
  13.                           android:title="@string/additional_system_update_settings_list_item_title">  
  14.             <intent android:action="android.intent.action.MAIN"  
  15.                     android:targetPackage="@string/additional_system_update"  
  16.                     android:targetClass="@string/additional_system_update_menu" />  
  17.         </PreferenceScreen>  
  18.   
  19. </PreferenceScreen>  

这两种方式都可以满足我们的需求,今天我们主要来看一下第一种方式。

 

使用Header,内部大体经历了两个阶段,第一、解析xml配置文件,构建Header列表。第二、构建adapter进行Header列表的加载以及显示。

 

1、在PreferenceActivity.java中,调用loadHeadersFromResource进行Header的加载。

流程如下:

PreferenceActivity.java

[java]  view plain copy 在CODE上查看代码片 派生到我的代码片
  1. public void loadHeadersFromResource(int resid, List<Header> target) {  
  2.         XmlResourceParser parser = null;  
  3.         try {  
  4.             parser = getResources().getXml(resid);  
  5.             AttributeSet attrs = Xml.asAttributeSet(parser);  
  6.   
  7.             int type;  
  8.             while ((type=parser.next()) != XmlPullParser.END_DOCUMENT  
  9.                     && type != XmlPullParser.START_TAG) {  
  10.                 // Parse next until start tag is found  
  11.             }  
  12.   
  13.             String nodeName = parser.getName();  
  14.             if (!"preference-headers".equals(nodeName)) {  
  15.                 throw new RuntimeException(  
  16.                         "XML document must start with <preference-headers> tag; found"  
  17.                         + nodeName + " at " + parser.getPositionDescription());  
  18.             }  
  19.   
  20.             Bundle curBundle = null;  
  21.   
  22.             final int outerDepth = parser.getDepth();  
  23.             while ((type=parser.next()) != XmlPullParser.END_DOCUMENT  
  24.                    && (type != XmlPullParser.END_TAG || parser.getDepth() > outerDepth)) {  
  25.                 if (type == XmlPullParser.END_TAG || type == XmlPullParser.TEXT) {  
  26.                     continue;  
  27.                 }  
  28.   
  29.                 nodeName = parser.getName();  
  30.                 if ("header".equals(nodeName)) {  
  31.                     Header header = new Header();  
  32.   
  33.                     TypedArray sa = getResources().obtainAttributes(attrs,  
  34.                             com.android.internal.R.styleable.PreferenceHeader);  
  35.                     header.id = sa.getResourceId(  
  36.                             com.android.internal.R.styleable.PreferenceHeader_id,  
  37.                             (int)HEADER_ID_UNDEFINED);  
  38.                     TypedValue tv = sa.peekValue(  
  39.                             com.android.internal.R.styleable.PreferenceHeader_title);  
  40.                     if (tv != null && tv.type == TypedValue.TYPE_STRING) {  
  41.                         if (tv.resourceId != 0) {  
  42.                             header.titleRes = tv.resourceId;  
  43.                         } else {  
  44.                             header.title = tv.string;  
  45.                         }  
  46.                     }  
  47.                     tv = sa.peekValue(  
  48.                             com.android.internal.R.styleable.PreferenceHeader_summary);  
  49.                     if (tv != null && tv.type == TypedValue.TYPE_STRING) {  
  50.                         if (tv.resourceId != 0) {  
  51.                             header.summaryRes = tv.resourceId;  
  52.                         } else {  
  53.                             header.summary = tv.string;  
  54.                         }  
  55.                     }  
  56.                     tv = sa.peekValue(  
  57.                             com.android.internal.R.styleable.PreferenceHeader_breadCrumbTitle);  
  58.                     if (tv != null && tv.type == TypedValue.TYPE_STRING) {  
  59.                         if (tv.resourceId != 0) {  
  60.                             header.breadCrumbTitleRes = tv.resourceId;  
  61.                         } else {  
  62.                             header.breadCrumbTitle = tv.string;  
  63.                         }  
  64.                     }  
  65.                     tv = sa.peekValue(  
  66.                             com.android.internal.R.styleable.PreferenceHeader_breadCrumbShortTitle);  
  67.                     if (tv != null && tv.type == TypedValue.TYPE_STRING) {  
  68.                         if (tv.resourceId != 0) {  
  69.                             header.breadCrumbShortTitleRes = tv.resourceId;  
  70.                         } else {  
  71.                             header.breadCrumbShortTitle = tv.string;  
  72.                         }  
  73.                     }  
  74.                     header.iconRes = sa.getResourceId(  
  75.                             com.android.internal.R.styleable.PreferenceHeader_icon, 0);  
  76.                     header.fragment = sa.getString(  
  77.                             com.android.internal.R.styleable.PreferenceHeader_fragment);  
  78.                     sa.recycle();  
  79.   
  80.                     if (curBundle == null) {  
  81.                         curBundle = new Bundle();  
  82.                     }  
  83.   
  84.                     final int innerDepth = parser.getDepth();  
  85.                     while ((type=parser.next()) != XmlPullParser.END_DOCUMENT  
  86.                            && (type != XmlPullParser.END_TAG || parser.getDepth() > innerDepth)) {  
  87.                         if (type == XmlPullParser.END_TAG || type == XmlPullParser.TEXT) {  
  88.                             continue;  
  89.                         }  
  90.   
  91.                         String innerNodeName = parser.getName();  
  92.                         if (innerNodeName.equals("extra")) {  
  93.                             getResources().parseBundleExtra("extra", attrs, curBundle);  
  94.                             XmlUtils.skipCurrentTag(parser);  
  95.   
  96.                         } else if (innerNodeName.equals("intent")) {  
  97.                             header.intent = Intent.parseIntent(getResources(), parser, attrs);  
  98.   
  99.                         } else {  
  100.                             XmlUtils.skipCurrentTag(parser);  
  101.                         }  
  102.                     }  
  103.   
  104.                     if (curBundle.size() > 0) {  
  105.                         header.fragmentArguments = curBundle;  
  106.                         curBundle = null;  
  107.                     }  
  108.   
  109.                     target.add(header);  
  110.                 } else {  
  111.                     XmlUtils.skipCurrentTag(parser);  
  112.                 }  
  113.             }  
  114.   
  115.         } catch (XmlPullParserException e) {  
  116.             throw new RuntimeException("Error parsing headers", e);  
  117.         } catch (IOException e) {  
  118.             throw new RuntimeException("Error parsing headers", e);  
  119.         } finally {  
  120.             if (parser != null) parser.close();  
  121.         }  
  122.   
  123.     }  


上面的这段代码是基于android 4.0版本截取的,代码内容大体可以分为三个阶段。

  • 阶段一:将resId对应的xml文件,加载成为XmlResourceParser、AttributeSet。即:
[java]  view plain copy 在CODE上查看代码片 派生到我的代码片
  1. parser = getResources().getXml(resid);  
  2.            AttributeSet attrs = Xml.asAttributeSet(parser);  
[java]  view plain copy 在CODE上查看代码片 派生到我的代码片
  1. if (!"preference-headers".equals(nodeName)) {  
  2.                 throw new RuntimeException(  
  3.                         "XML document must start with <preference-headers> tag; found"  
  4.                         + nodeName + " at " + parser.getPositionDescription());  
  5.             }  


首先xml的标题头部必须为“preference-headers”,否则,抛出Runntime异常。


 

[java]  view plain copy 在CODE上查看代码片 派生到我的代码片
  1. if ("header".equals(nodeName)) {  
  2.                     Header header = new Header();  
  3.   
  4.                     TypedArray sa = getResources().obtainAttributes(attrs,  
  5.                             com.android.internal.R.styleable.PreferenceHeader);  
  6.                     header.id = sa.getResourceId(  
  7.                             com.android.internal.R.styleable.PreferenceHeader_id,  
  8.                             (int)HEADER_ID_UNDEFINED);  
  9.                     TypedValue tv = sa.peekValue(  
  10.                             com.android.internal.R.styleable.PreferenceHeader_title);  
  11.                     if (tv != null && tv.type == TypedValue.TYPE_STRING) {  
  12.                         if (tv.resourceId != 0) {  
  13.                             header.titleRes = tv.resourceId;  
  14.                         } else {  
  15.                             header.title = tv.string;  
  16.                         }  
  17.                     }  
  18.                     tv = sa.peekValue(  
  19.                             com.android.internal.R.styleable.PreferenceHeader_summary);  
  20.                     if (tv != null && tv.type == TypedValue.TYPE_STRING) {  
  21.                         if (tv.resourceId != 0) {  
  22.                             header.summaryRes = tv.resourceId;  
  23.                         } else {  
  24.                             header.summary = tv.string;  
  25.                         }  
  26.                     }  
  27.                     tv = sa.peekValue(  
  28.                             com.android.internal.R.styleable.PreferenceHeader_breadCrumbTitle);  
  29.                     if (tv != null && tv.type == TypedValue.TYPE_STRING) {  
  30.                         if (tv.resourceId != 0) {  
  31.                             header.breadCrumbTitleRes = tv.resourceId;  
  32.                         } else {  
  33.                             header.breadCrumbTitle = tv.string;  
  34.                         }  
  35.                     }  
  36.                     tv = sa.peekValue(  
  37.                             com.android.internal.R.styleable.PreferenceHeader_breadCrumbShortTitle);  
  38.                     if (tv != null && tv.type == TypedValue.TYPE_STRING) {  
  39.                         if (tv.resourceId != 0) {  
  40.                             header.breadCrumbShortTitleRes = tv.resourceId;  
  41.                         } else {  
  42.                             header.breadCrumbShortTitle = tv.string;  
  43.                         }  
  44.                     }  
  45.                     header.iconRes = sa.getResourceId(  
  46.                             com.android.internal.R.styleable.PreferenceHeader_icon, 0);  
  47.                     header.fragment = sa.getString(  
  48.                             com.android.internal.R.styleable.PreferenceHeader_fragment);  
  49.                     sa.recycle();  

这部分解析出来Header对象,并且对Header对象的title,summary,以及id,frament进行赋值。

[java]  view plain copy 在CODE上查看代码片 派生到我的代码片
  1. while ((type=parser.next()) != XmlPullParser.END_DOCUMENT  
  2.                            && (type != XmlPullParser.END_TAG || parser.getDepth() > innerDepth)) {  
  3.                         if (type == XmlPullParser.END_TAG || type == XmlPullParser.TEXT) {  
  4.                             continue;  
  5.                         }  
  6.   
  7.                         String innerNodeName = parser.getName();  
  8.                         if (innerNodeName.equals("extra")) {  
  9.                             getResources().parseBundleExtra("extra", attrs, curBundle);  
  10.                             XmlUtils.skipCurrentTag(parser);  
  11.   
  12.                         } else if (innerNodeName.equals("intent")) {  
  13.                             header.intent = Intent.parseIntent(getResources(), parser, attrs);  
  14.   
  15.                         } else {  
  16.                             XmlUtils.skipCurrentTag(parser);  
  17.                         }  
  18.                     }  


这部分解析extra以及Intent。

  • 阶段三、将解析出来的Header加入到列表中。
[java]  view plain copy 在CODE上查看代码片 派生到我的代码片
  1. target.add(header);  


这里的target,参见上文,target为:PreferenceActivity中的mHeaders。

 

有人可能有疑问:为什么要在PreferenceActivity的继承类的onBuildHeaders方法中进行xml加载,onBuildHeaders什么时候调用?

理解了这个问题,也就明白了为什么上文中的target为PreferenceActivity中的mHeaders了。

答案就是,在PreferenceActivity的onCreate方法中,会调用onBuildHeader方法,同时将成员变量mHeader作为参数。

[java]  view plain copy 在CODE上查看代码片 派生到我的代码片
  1. @Override  
  2.     protected void onCreate(Bundle savedInstanceState) {  
  3.         super.onCreate(savedInstanceState);  
  4.   
  5.         setContentView(com.android.internal.R.layout.preference_list_content);  
  6.   
  7. //........  
  8.                 // We need to try to build <span style="color:#ff0000;"><strong>the headers.</strong>  
  9.                </span> <span style="color:#ff0000;"><strong>onBuildHeaders(mHeaders);</strong>  
  10. </span>  
  11.                 // If there are headers, then at this point we need to show  
  12.                 // them and, depending on the screen, we may also show in-line  
  13.                 // the currently selected preference fragment.  
  14.                 if (mHeaders.size() > 0) {  
  15.                     if (!mSinglePane) {  
  16.                         if (initialFragment == null) {  
  17.                             Header h = onGetInitialHeader();  
  18.                             switchToHeader(h);  
  19.                         } else {  
  20.                             switchToHeader(initialFragment, initialArguments);  
  21.                         }  
  22.                     }  
  23.                 }  
  24.             }  
  25.         }  
  26.   
  27. //........    
  28. }  


 我们在继承自PreferenceActivity的子类中:

[java]  view plain copy 在CODE上查看代码片 派生到我的代码片
  1. public class Settings extends PreferenceActivity{  
  2.   
  3.  @Override  
  4.     public void onBuildHeaders(List<Header> headers) {  
  5.         loadHeadersFromResource(R.xml.settings_headers, headers);  
  6.   
  7.         updateHeaderList(headers);  
  8.   
  9.         mHeaders = headers;  
  10.     }  
  11. }  

回答完毕。

通过上面的介绍,我们完成了第一步,即:xml配置文件的解析以及Header的列表加载。

第二、adapter的构建。

通过第一步,PreferenceActivity得到了一个Header的List集合,mHeaders。

同样是在PreferenceActivity的onCreate中,会执行如下代码:

[java]  view plain copy 在CODE上查看代码片 派生到我的代码片
  1. setListAdapter(new HeaderAdapter(this, mHeaders));  

PreferenceActivity继承自ListActivity,内部拥有ListView的引用。

上段代码就是我们常用的Adapter,ListView形式,不需要再介绍了吧。

附:HeaderAdapter的源码:

[java]  view plain copy 在CODE上查看代码片 派生到我的代码片
  1. private static class HeaderAdapter extends ArrayAdapter<Header> {  
  2.         private static class HeaderViewHolder {  
  3.             ImageView icon;  
  4.             TextView title;  
  5.             TextView summary;  
  6.         }  
  7.   
  8.         private LayoutInflater mInflater;  
  9.   
  10.         public HeaderAdapter(Context context, List<Header> objects) {  
  11.             super(context, 0, objects);  
  12.             mInflater = (LayoutInflater)context.getSystemService(Context.LAYOUT_INFLATER_SERVICE);  
  13.         }  
  14.   
  15.         @Override  
  16.         public View getView(int position, View convertView, ViewGroup parent) {  
  17.             HeaderViewHolder holder;  
  18.             View view;  
  19.   
  20.             if (convertView == null) {  
  21.                 view = mInflater.inflate(com.android.internal.R.layout.preference_header_item,  
  22.                         parent, false);  
  23.                 holder = new HeaderViewHolder();  
  24.                 holder.icon = (ImageView) view.findViewById(com.android.internal.R.id.icon);  
  25.                 holder.title = (TextView) view.findViewById(com.android.internal.R.id.title);  
  26.                 holder.summary = (TextView) view.findViewById(com.android.internal.R.id.summary);  
  27.                 view.setTag(holder);  
  28.             } else {  
  29.                 view = convertView;  
  30.                 holder = (HeaderViewHolder) view.getTag();  
  31.             }  
  32.   
  33.             // All view fields must be updated every time, because the view may be recycled   
  34.             Header header = getItem(position);  
  35.             holder.icon.setImageResource(header.iconRes);  
  36.             holder.title.setText(header.getTitle(getContext().getResources()));  
  37.             CharSequence summary = header.getSummary(getContext().getResources());  
  38.             if (!TextUtils.isEmpty(summary)) {  
  39.                 holder.summary.setVisibility(View.VISIBLE);  
  40.                 holder.summary.setText(summary);  
  41.             } else {  
  42.                 holder.summary.setVisibility(View.GONE);  
  43.             }  
  44.   
  45.             return view;  
  46.         }  
  47.     }  


以上就是PreferenceActivity加载Header的整个流程。不当之处,欢迎大家提出宝贵意见,共同学习。

  • 0
    点赞
  • 8
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值