android preference-headers 属性,用Androidx的方式使用Preference-记一次官方文档错误

用Androidx的方式使用Preference

起因

可能是因为targetApi=29的原因，在使用传统的PreferenceActivity的时候AS提醒我里面的一些方法已经被弃用，作为一个非常激进的业余菜鸟开发者，我的强迫症促使我去寻找其解决方案

近期收到我的小软件AndroCode有些用户反馈设置的第二级打不开，点击没有反应

找轮子

我开始百度找轮子，得知android10使用androidx全面替代，看了一下迁移的对应关系migrate，于是又百度androidx.preference，但结果寥寥无几，只有androidx PreferenceDialogFragmentCompat 和 DialogPreference的配合应用这一篇有一些记载，但对于我们这样的菜鸟很不友好，没有讲基础的使用方法或贴代码，里面的参考文档还被墙打不开。

不得已去看官方API，终于找到了使用方法指南，竟然有中文！！！还这么简洁，我大喜过望，赶紧上手操作

导入依赖

implementation 'androidx.preference:preference:1.1.0'

implementation 'androidx.core:core:1.2.0-beta01'

implementation 'androidx.fragment:fragment:1.2.0-rc01'

官方Demo

xmlns:app="http://schemas.android.com/apk/res-auto">

app:key="notifications"

app:title="Enable message notifications"/>

app:key="feedback"

app:title="Send feedback"

app:summary="Report technical issues or suggest new features"/>

public class MySettingsFragment extends PreferenceFragmentCompat {

@Override

public void onCreatePreferences(Bundle savedInstanceState, String rootKey) {

setPreferencesFromResource(R.xml.preferences, rootKey);

}

}

public class MySettingsActivity extends AppCompatActivity {

@Override

protected void onCreate(Bundle savedInstanceState) {

super.onCreate(savedInstanceState);

getSupportFragmentManager()

.beginTransaction()

.replace(R.id.settings_container, new MySettingsFragment())

.commit();

}

}

首先是没有了header的方式，但我的APP暂时还是需要这种布局，于是用RecyclerView模拟了一个

activity_settings_item.xml

android:layout_width="match_parent"

android:layout_height="wrap_content"

android:background="?android:attr/selectableItemBackground"

android:clickable="true"

android:focusable="true"

android:orientation="vertical"

android:paddingStart="15dp"

android:paddingTop="10dp"

android:paddingEnd="15dp"

android:paddingBottom="10dp">

android:id="@+id/activity_settings_label"

android:layout_width="match_parent"

android:layout_height="wrap_content"

android:textAllCaps="true"

android:textStyle="bold"

android:textAppearance="@style/TextAppearance.AppCompat.Medium" />

android:id="@+id/activity_settings_message"

android:layout_width="match_parent"

android:layout_height="wrap_content"

android:textAppearance="@style/TextAppearance.AppCompat.Small" />

activity_settings.xml

android:layout_width="match_parent"

android:id="@+id/activity_settings_layout"

android:layout_height="match_parent"

android:orientation="vertical">

android:id="@+id/activity_settings_recyclerv"

android:layout_width="match_parent"

android:layout_height="match_parent" />

android:id="@+id/activity_settings_container"

android:layout_width="match_parent"

android:layout_height="match_parent" />

这里偷了个懒，用显示隐藏RecycerView的方式来给Fragment腾地方

由于PreferenceScreen还要用Fragment显示， 于是在AppCompatActivity中用recyclerview来触发事件显示fragment

onCreate:

headers.add(new SettingHeader("应用", "配置应用主题、会话", new SettingFragment(R.xml.settings_app)));

headers.add(new SettingHeader("编辑器", "配置编辑器、代码、保存", new SettingFragment(R.xml.settings_editor)));

headers.add(new SettingHeader("构建、运行", "配置工程构建和运行设置", new SettingFragment(R.xml.settings_build)));

headers.add(new SettingHeader("关于", "介绍等", new SettingFragment(R.xml.settings_about)));

recyclerv.setAdapter(new BaseRecyclerAdapter(headers) {

@Override

protected int getItemLayoutId(int viewType) {

return R.layout.activity_settings_item;

}

@Override

protected void bindData(@NonNull RecyclerViewHolder holder, int position, SettingHeader item) {

holder.getTextView(R.id.activity_settings_label).setText(item.label);

holder.getTextView(R.id.activity_settings_message).setText(item.message);

holder.itemView.setOnClickListener(v -> {

getSupportFragmentManager()

.beginTransaction()

.replace(R.id.activity_settings_container, item.fragmentCompat)

.commit();

recyclerv.setVisibility(View.GONE);

});

}

});

recyclerv.setLayoutManager(new LinearLayoutManager(this, RecyclerView.VERTICAL, false));

为了减少代码，我机智地复用一个SettingFragment来加载不同xml

public static class SettingHeader {

public String label;

public String message;

public PreferenceFragmentCompat fragmentCompat;

public SettingHeader(String label, String message, PreferenceFragmentCompat fragmentCompat) {

this.label = label;

this.message = message;

this.fragmentCompat = fragmentCompat;

}

}

public static class SettingFragment extends PreferenceFragmentCompat {

private final int id;

public SettingFragment(int xmlId) {

super();

this.id = xmlId;

}

@Override

public void onCreatePreferences(Bundle savedInstanceState, String rootKey) {

setPreferencesFromResource(id, rootKey);

}

@Override

public void onDisplayPreferenceDialog(Preference preference) {

if (preference instanceof GenKeystorePreference) {

((GenKeystorePreference) preference).showDialog();

} else

super.onDisplayPreferenceDialog(preference);

}

}

于是我满怀信心地用AS跑了起来，一起看起来是那么地完美

没问题，打开应用item

？？？这是什么鬼

寻找错误原因

因为用到了一个换肤框架，有些兼容问题，起初我以为是字体颜色和背景一样，于是开始捣鼓主题，禁用框架，但毫无结果

终于，机缘巧合之下，log提示我自定义的Preference有问题，DialogPreference不再提供默认的新建Dialog操作，要通过onDisplayPreferenceDialog来设置，将其修复后log提示我没有Preference have no Key!

但我明明有定义，完全是按照官方的教程来的啊！思考半天，我尝试用android:替换app:，最后运行如下

官方文档有错！本人记下了！！！

看这架势应该是支持icon，预留了一个ImageView

结论

官方文档有错，还是用android:而不是app:，估计是升级lib忘了同步还是写错了？