PreferenceActivity中，Header是如何被加载的？

最新推荐文章于 2022-08-21 15:11:23 发布
最新推荐文章于 2022-08-21 15:11:23 发布
阅读量4k 收藏 1
点赞数 1
分类专栏： Android 设置解析 文章标签： PreferenceActivity 加载Headers 设置应用
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/droyon/article/details/17798697
版权

转载请注明出处：http://blog.csdn.net/droyon/article/details/17798697

 

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

 

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

其一：loadHeadersFromResource

@Override
    public void onBuildHeaders(List
  
  

   
    headers) {
        loadHeadersFromResource(R.xml.settings_headers, headers);

        updateHeaderList(headers);

        mHeaders = headers;
    }

settings_headers.xml

<preference-headers
        xmlns:android="http://schemas.android.com/apk/res/android">


    <!-- WIRELESS and NETWORKS -->
    <header android:title="@string/header_category_wireless_networks" />

    <!-- Wifi -->
    <header
        android:id="@+id/wifi_settings"
        android:fragment="com.android.settings.wifi.WifiSettings"
        android:title="@string/wifi_settings_title"
        android:icon="@drawable/ic_settings_wireless" />

    <!-- Bluetooth -->
    <header
        android:id="@+id/bluetooth_settings"
        android:fragment="com.android.settings.bluetooth.BluetoothSettings"
        android:title="@string/bluetooth_settings_title"
        android:icon="@drawable/ic_settings_bluetooth2" />

</preference-headers>


其二：

 addPreferencesFromResource(R.xml.device_info_settings);

device_info_settings.xml

<PreferenceScreen xmlns:android="http://schemas.android.com/apk/res/android"
        android:title="@string/about_settings">

        <!-- System update settings - launches activity -->
        <PreferenceScreen android:key="system_update_settings"
                android:title="@string/system_update_settings_list_item_title" 
                android:summary="@string/system_update_settings_list_item_summary">
            <intent android:action="android.settings.SYSTEM_UPDATE_SETTINGS" />
        </PreferenceScreen>


        <PreferenceScreen android:key="additional_system_update_settings"
                          android:title="@string/additional_system_update_settings_list_item_title">
            <intent android:action="android.intent.action.MAIN"
                    android:targetPackage="@string/additional_system_update"
                    android:targetClass="@string/additional_system_update_menu" />
        </PreferenceScreen>

</PreferenceScreen>

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

 

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

 

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

流程如下：

PreferenceActivity.java

public void loadHeadersFromResource(int resid, List<Header> target) {
        XmlResourceParser parser = null;
        try {
            parser = getResources().getXml(resid);
            AttributeSet attrs = Xml.asAttributeSet(parser);

            int type;
            while ((type=parser.next()) != XmlPullParser.END_DOCUMENT
                    && type != XmlPullParser.START_TAG) {
                // Parse next until start tag is found
            }

            String nodeName = parser.getName();
            if (!"preference-headers".equals(nodeName)) {
                throw new RuntimeException(
                        "XML document must start with <preference-headers> tag; found"
                        + nodeName + " at " + parser.getPositionDescription());
            }

            Bundle curBundle = null;

            final int outerDepth = parser.getDepth();
            while ((type=parser.next()) != XmlPullParser.END_DOCUMENT
                   && (type != XmlPullParser.END_TAG || parser.getDepth() > outerDepth)) {
                if (type == XmlPullParser.END_TAG || type == XmlPullParser.TEXT) {
                    continue;
                }

                nodeName = parser.getName();
                if ("header".equals(nodeName)) {
                    Header header = new Header();

                    TypedArray sa = getResources().obtainAttributes(attrs,
                            com.android.internal.R.styleable.PreferenceHeader);
                    header.id = sa.getResourceId(
                            com.android.internal.R.styleable.PreferenceHeader_id,
                            (int)HEADER_ID_UNDEFINED);
                    TypedValue tv = sa.peekValue(
                            com.android.internal.R.styleable.PreferenceHeader_title);
                    if (tv != null && tv.type == TypedValue.TYPE_STRING) {
                        if (tv.resourceId != 0) {
                            header.titleRes = tv.resourceId;
                        } else {
                            header.title = tv.string;
                        }
                    }
                    tv = sa.peekValue(
                            com.android.internal.R.styleable.PreferenceHeader_summary);
                    if (tv != null && tv.type == TypedValue.TYPE_STRING) {
                        if (tv.resourceId != 0) {
                            header.summaryRes = tv.resourceId;
                        } else {
                            header.summary = tv.string;
                        }
                    }
                    tv = sa.peekValue(
                            com.android.internal.R.styleable.PreferenceHeader_breadCrumbTitle);
                    if (tv != null && tv.type == TypedValue.TYPE_STRING) {
                        if (tv.resourceId != 0) {
                            header.breadCrumbTitleRes = tv.resourceId;
                        } else {
                            header.breadCrumbTitle = tv.string;
                        }
                    }
                    tv = sa.peekValue(
                            com.android.internal.R.styleable.PreferenceHeader_breadCrumbShortTitle);
                    if (tv != null && tv.type == TypedValue.TYPE_STRING) {
                        if (tv.resourceId != 0) {
                            header.breadCrumbShortTitleRes = tv.resourceId;
                        } else {
                            header.breadCrumbShortTitle = tv.string;
                        }
                    }
                    header.iconRes = sa.getResourceId(
                            com.android.internal.R.styleable.PreferenceHeader_icon, 0);
                    header.fragment = sa.getString(
                            com.android.internal.R.styleable.PreferenceHeader_fragment);
                    sa.recycle();

                    if (curBundle == null) {
                        curBundle = new Bundle();
                    }

                    final int innerDepth = parser.getDepth();
                    while ((type=parser.next()) != XmlPullParser.END_DOCUMENT
                           && (type != XmlPullParser.END_TAG || parser.getDepth() > innerDepth)) {
                        if (type == XmlPullParser.END_TAG || type == XmlPullParser.TEXT) {
                            continue;
                        }

                        String innerNodeName = parser.getName();
                        if (innerNodeName.equals("extra")) {
                            getResources().parseBundleExtra("extra", attrs, curBundle);
                            XmlUtils.skipCurrentTag(parser);

                        } else if (innerNodeName.equals("intent")) {
                            header.intent = Intent.parseIntent(getResources(), parser, attrs);

                        } else {
                            XmlUtils.skipCurrentTag(parser);
                        }
                    }

                    if (curBundle.size() > 0) {
                        header.fragmentArguments = curBundle;
                        curBundle = null;
                    }

                    target.add(header);
                } else {
                    XmlUtils.skipCurrentTag(parser);
                }
            }

        } catch (XmlPullParserException e) {
            throw new RuntimeException("Error parsing headers", e);
        } catch (IOException e) {
            throw new RuntimeException("Error parsing headers", e);
        } finally {
            if (parser != null) parser.close();
        }

    }


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

  • 阶段一：将resId对应的xml文件，加载成为XmlResourceParser、AttributeSet。即：
 parser = getResources().getXml(resid);
            AttributeSet attrs = Xml.asAttributeSet(parser);
if (!"preference-headers".equals(nodeName)) {
                throw new RuntimeException(
                        "XML document must start with <preference-headers> tag; found"
                        + nodeName + " at " + parser.getPositionDescription());
            }


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


 

if ("header".equals(nodeName)) {
                    Header header = new Header();

                    TypedArray sa = getResources().obtainAttributes(attrs,
                            com.android.internal.R.styleable.PreferenceHeader);
                    header.id = sa.getResourceId(
                            com.android.internal.R.styleable.PreferenceHeader_id,
                            (int)HEADER_ID_UNDEFINED);
                    TypedValue tv = sa.peekValue(
                            com.android.internal.R.styleable.PreferenceHeader_title);
                    if (tv != null && tv.type == TypedValue.TYPE_STRING) {
                        if (tv.resourceId != 0) {
                            header.titleRes = tv.resourceId;
                        } else {
                            header.title = tv.string;
                        }
                    }
                    tv = sa.peekValue(
                            com.android.internal.R.styleable.PreferenceHeader_summary);
                    if (tv != null && tv.type == TypedValue.TYPE_STRING) {
                        if (tv.resourceId != 0) {
                            header.summaryRes = tv.resourceId;
                        } else {
                            header.summary = tv.string;
                        }
                    }
                    tv = sa.peekValue(
                            com.android.internal.R.styleable.PreferenceHeader_breadCrumbTitle);
                    if (tv != null && tv.type == TypedValue.TYPE_STRING) {
                        if (tv.resourceId != 0) {
                            header.breadCrumbTitleRes = tv.resourceId;
                        } else {
                            header.breadCrumbTitle = tv.string;
                        }
                    }
                    tv = sa.peekValue(
                            com.android.internal.R.styleable.PreferenceHeader_breadCrumbShortTitle);
                    if (tv != null && tv.type == TypedValue.TYPE_STRING) {
                        if (tv.resourceId != 0) {
                            header.breadCrumbShortTitleRes = tv.resourceId;
                        } else {
                            header.breadCrumbShortTitle = tv.string;
                        }
                    }
                    header.iconRes = sa.getResourceId(
                            com.android.internal.R.styleable.PreferenceHeader_icon, 0);
                    header.fragment = sa.getString(
                            com.android.internal.R.styleable.PreferenceHeader_fragment);
                    sa.recycle();

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

while ((type=parser.next()) != XmlPullParser.END_DOCUMENT
                           && (type != XmlPullParser.END_TAG || parser.getDepth() > innerDepth)) {
                        if (type == XmlPullParser.END_TAG || type == XmlPullParser.TEXT) {
                            continue;
                        }

                        String innerNodeName = parser.getName();
                        if (innerNodeName.equals("extra")) {
                            getResources().parseBundleExtra("extra", attrs, curBundle);
                            XmlUtils.skipCurrentTag(parser);

                        } else if (innerNodeName.equals("intent")) {
                            header.intent = Intent.parseIntent(getResources(), parser, attrs);

                        } else {
                            XmlUtils.skipCurrentTag(parser);
                        }
                    }


这部分解析extra以及Intent。

  • 阶段三、将解析出来的Header加入到列表中。
target.add(header);


这里的target，参见上文，target为：PreferenceActivity中的mHeaders。

 

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

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

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

@Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);

        setContentView(com.android.internal.R.layout.preference_list_content);

//........
                // We need to try to build the headers.
                onBuildHeaders(mHeaders);

                // If there are headers, then at this point we need to show
                // them and, depending on the screen, we may also show in-line
                // the currently selected preference fragment.
                if (mHeaders.size() > 0) {
                    if (!mSinglePane) {
                        if (initialFragment == null) {
                            Header h = onGetInitialHeader();
                            switchToHeader(h);
                        } else {
                            switchToHeader(initialFragment, initialArguments);
                        }
                    }
                }
            }
        }

//........  
}


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

public class Settings extends PreferenceActivity{

 @Override
    public void onBuildHeaders(List<Header> headers) {
        loadHeadersFromResource(R.xml.settings_headers, headers);

        updateHeaderList(headers);

        mHeaders = headers;
    }
}

回答完毕。

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

第二、adapter的构建。

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

同样是在PreferenceActivity的onCreate中，会执行如下代码：

setListAdapter(new HeaderAdapter(this, mHeaders));

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

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

附：HeaderAdapter的源码：

private static class HeaderAdapter extends ArrayAdapter<Header> {
        private static class HeaderViewHolder {
            ImageView icon;
            TextView title;
            TextView summary;
        }

        private LayoutInflater mInflater;

        public HeaderAdapter(Context context, List<Header> objects) {
            super(context, 0, objects);
            mInflater = (LayoutInflater)context.getSystemService(Context.LAYOUT_INFLATER_SERVICE);
        }

        @Override
        public View getView(int position, View convertView, ViewGroup parent) {
            HeaderViewHolder holder;
            View view;

            if (convertView == null) {
                view = mInflater.inflate(com.android.internal.R.layout.preference_header_item,
                        parent, false);
                holder = new HeaderViewHolder();
                holder.icon = (ImageView) view.findViewById(com.android.internal.R.id.icon);
                holder.title = (TextView) view.findViewById(com.android.internal.R.id.title);
                holder.summary = (TextView) view.findViewById(com.android.internal.R.id.summary);
                view.setTag(holder);
            } else {
                view = convertView;
                holder = (HeaderViewHolder) view.getTag();
            }

            // All view fields must be updated every time, because the view may be recycled 
            Header header = getItem(position);
            holder.icon.setImageResource(header.iconRes);
            holder.title.setText(header.getTitle(getContext().getResources()));
            CharSequence summary = header.getSummary(getContext().getResources());
            if (!TextUtils.isEmpty(summary)) {
                holder.summary.setVisibility(View.VISIBLE);
                holder.summary.setText(summary);
            } else {
                holder.summary.setVisibility(View.GONE);
            }

            return view;
        }
    }


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

 

 

hailushijie
关注
  • 1
    点赞
  • 踩
  • 1
    收藏
    觉得还不错? 一键收藏
  • 打赏
    打赏
  • 1
    评论
专栏目录
Android 在frameworks中修改Setting中的默认值 （二）
DMT专栏
11-26 3589
修改设置->关于手机->法律信息 下有一些Item，如开放源代码许可、Google法律信息等，这里分析的是Android 4.4的代码 如下图所示，想添加“Google法律信息”选项 查看Settings的源码在/Settings/src/com/android/settings/DeviceInfoSettings.java文件初始化时有这样一段代码 @Override p
自定义PreferenceActivity的样式
niejing654092427的专栏
07-04 3747
写一个系统的设置界面,将其设置样式就可以了       先建一个SettingActivity工程: AndroidManifest.xml: <manifest xmlns:android="http://schemas.android.com/apk/res/android" package="com.cn.nj.setting" android:ver
Android应用Preference相关及源码浅析(Preference组件家族篇)
热门推荐
工匠若水
09-09 1万+
1 前言前一篇（点我阅读前一篇《Android应用Preference相关及源码浅析(SharePreferences篇)》）我们讨论分析使用了Android的SharePreferences，相信看过的朋友都有了自己的感悟与理解，这一篇我们继续乘热打铁来说说SharePreferences的衍生品—-Preference组件。其实Preference组件大家一定不陌生，因为Android系统的Se
Android本地升级原理及流程(一，上层）
从0到1，突破自己
12-12 8509
1.首先,我们了解一下进入进入系统更新的操作步骤；设置-->关于手机-->系统更新       ①设置界面进入系统更新的设置界面为设置模块下DeviceInfoSettings.java类，所对应preference为Device_info_settings.xml中如下：                android:title="@string/system_update_settin
从零开始--系统深入学习android（实践-让我们开始写代码-Android框架学习-5.设置（Settings））...
weixin_34009794的博客
11-29 285
第5章 设置（Settings） 本章不同于通常网络上经常使用的SharedPreference，而是从底层了解Preference。FAQ QQ群213821767 应用程序通常包括允许用户修改应用程序的特性和行为的设置功能。例如,一些应用程序允许用户指定通知是否启用或指定多久使用云同步数据。如果你想要为你的应用程序提供设置，你应该使用Android的Preference APIs来构建统一...
android PreferenceActivity中的组件源码
09-26
android PreferenceActivity中的组件源码~
Android软件开发之PreferenceActivity中组件的使用
08-28
然后在PreferenceActivity的onCreate()方法中加载这个XML文件，通常使用addPreferencesFromResource()方法。 ```java @Override protected void onCreate(Bundle savedInstanceState) { super.onCreate...
Android之PreferenceActivity应用详解
09-05
PreferenceActivity的使用大大简化了创建设置界面的工作，通过XML定义界面元素和它们的行为，然后在Activity中加载这些元素，就能生成一个功能齐全的设置界面。这种方法不仅易于维护，也方便扩展和自定义。
Android之PreferenceActivity应用详解（2）
09-05
5. 将创建的XML布局文件引用到PreferenceActivity的onCreate()方法中，使用addPreferencesFromResource()方法加载布局。 例如，创建一个包含两个CheckBoxPreference的PreferenceCategory，用于设置“我的位置”的...
PreferenceActivity简介
07-31
PreferenceActivity是Android系统中用于构建设置界面的一种特殊Activity。它主要处理用户在设置应用中进行的各种偏好设置，如开关按钮、选择列表等。在Android开发中，为应用程序创建自定义设置界面时，开发者经常会...
自定义PreferenceActivity的样式和界面
08-05
自定义PreferenceActivity的样式，相关博客：http://www.cnblogs.com/tianzhijiexian/p/3892506.html
Settings界面分析之Settings一级界面
wsb1321的专栏
12-19 2669
AndroidManifest.xml中 com.android.settings.Settings这个类 所在launcher的界面可以直接启动Settings。 Settings的基本关系：public class Settings extends PreferenceActivity implements ButtonBarHandler 可以看出Settings即为Prefere
【读取手机根目录文件并轮询启动action】
weixin_37659322的博客
08-21 241
读取手机根目录文件启动action
Android4.0设置界面修改总结（三)
虾米哥 专栏
07-16 6963
zhu Android4.0设置界面修改总结大概介绍了一下设置改tab风格，其实原理很简单，理解两个主要的函数即可： ①.invalidateHeaders()，调用此函数将重新调用onBuildHeader()来重新读取xml文件中的header，重新刷新HeaderAdapter中的数据，因此刷新了ListView的内容，从而更新了界面。 ②.onBuildHeaders()中调用loa
Android自定义settings,Android系统设置settings应用学习（二）
weixin_34676828的博客
05-25 2196
Android 4.4 系统的设置源码阅读记录----------2014-7-3------------------AndroidManifest.xmllaunch的activity是Settings，另外有40多个activity继承于它，比Android 4.4 系统的设置源码阅读记录----------2014-7-3------------------AndroidManifest.x...
android 播放https 并且可以设置headers
qq_27591421的博客
05-13 2428
查了很多东西，终于发现一个非常不错的第三方框架分享给大家，直接写用法 1.添加类库 gradle dependencies { # 必选，内部默认使用系统mediaplayer进行解码 implementation 'com.github.dueeeke.dkplayer:dkplayer-java:3.2.6' # 可选，包含StandardVideoController的实现 implementation 'com.github.dueeeke.dkpla...
PreferenceActivity 使用了 onBuildHeaders 后在界面点击header不显示fragment
zhbpd的专栏
03-13 693
1. 创建了 PreferenceActivity 使用  onBuildHeaders 加载header；2. 编译运行后，在界面点击header条目，对应的PreferenceFragment不显示；经过分析排查后，发现 AndroidManifest.xml 中此 Activity 添加了 android:launchMode="singleTop" 属性，将其移除解决问题。...
Android Settings 分析一 应用耗电量获取
aa425705261的博客
01-08 3278
之前都没有写博客的习惯，工作上的一些想法和思路过一段时间就忘的差不多了。最近在做Settings相关功能的SDK定制，所以想趁这个机会把手上遇到的思路和解决方法整理下，方便日后回顾。想做成一个系列，其中有的也是参考网络大神的思路，有的是翻看源码整理的，请大家多多关照。 Android的电量信息通常都是指设备的电量信息，例如充电状态、耗电量、充电方式等等。常用的获取方式是注册“Intent.ACT...
preferenceactivity
最新发布
03-16
PreferenceActivity是Android中的一个类，用于创建应用程序的设置界面。它可以帮助开发者快速创建一个具有多个设置项的界面，并且可以自动保存和恢复用户的设置。PreferenceActivity可以通过XML文件来定义设置项的...

“相关推荐”对你有帮助么？

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论 1
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

hailushijie

您的鼓励是我创作最大的动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付：¥1
获取中
扫码支付

您的余额不足，请更换扫码支付或充值

打赏作者

实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

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

余额充值