码农之重学安卓：利用androidx.preference 快速创建一、二级设置菜单(demo)

卷首语

• 目前android上的设置菜单，大多使用preference来构建，尤其是原生的settings

• 目前老的android.support库已经被废弃

• 刚好重学android，今天跟大家分享下使用androidx.preference来创建系统设置菜单的方法，非常简单和方便

• 分析AOSP源码后，此处就依葫芦画瓢，利用 androidx.preference 做一个具有一、二级菜单的demo试试！

谷歌API参考

androidx.preference | Android Developers (google.cn)

com.android.support:preference-leanback-v17	androidx.leanback:leanback-preference
com.android.support:preference-v14	androidx.legacy:legacy-preference-v14
com.android.support:preference-v7	androidx.preference:preference

其中Leanback版本，是专门给大屏TV使用的，意为沙发上躺着看

.

1. 基本步骤

• 创建一个AS项目，NoActivity
• AS创建一级菜单的SettingsFragment
• AS创建二级菜单的SettingsFragment
• 在一级菜单的配置文件xml/root_preferences.xml中增加二级菜单的Item入口，并指向二级菜单的SettingsFragment
• AS创建MainActivity，编写代码，用于加载一级菜单的SettingsFragment
• 编译、运行、DEMO完成
• 可选：如需其他二三级、多级别菜单，依照添加二级菜单的方法，添加

.

2. 创建一个AS项目，NoActivity

1. Create New Project --> No Activity
2. 不要勾选 Use legacy android.support libraries （即使用最新的：androidx）
   

3. AS创建一级菜单的SettingsFragment

1. 选中app->com.xxxx.xxxxm目录
2. 右键->New->Fragment->Settings Fragment
3. 创建一级菜单的fragment
   

• 命名为：Level_1_SettingsFragment
  

• 一级菜单的XML文件，以及自动生成默认版本，并被fragment加载
  

• 通过XML Design界面，可以看到创建的默认菜单样式，以及一些demo组件，例如switch Widget
  

• 改下Title：一级菜单
  

4. AS创建二级菜单的SettingsFragment

1. 使用创建Level_1_SettingsFragment的方法，创建二级菜单的Level_2_SettingsFragment

2. 创建Level_2_SettingsFragment后，发现其未创建新的菜单XML文件

3. 所以通过复制res\xml\xml\root_preferences.xml文件，创建二级菜单的XML:res\xml\level_2_preferences.xml

4. 修改Level_2_SettingsFragment，加载level_2_preferences.xml
   

• 创建Level_2_SettingsFragment后，发现其未创建新的菜单XML文件
  

• 复制、创建二级菜单的XML:res\xml\level_2_preferences.xml
  

• 修改XML:res\xml\level_2_preferences.xml Title: 二级菜单
  

• 修改Level_2_SettingsFragment，加载level_2_preferences.xml

  public class Level_2_SettingsFragment extends PreferenceFragmentCompat {
  
      @Override
      public void onCreatePreferences(Bundle savedInstanceState, String rootKey) {
          setPreferencesFromResource(R.xml.level_2_preferences, rootKey);  --> 加载level_2_preferences.xml
      }
  }
  

5. 编辑一级菜单，添加二级菜单的入口

到此处，一二级菜单，尚无关联，我们需要在一级菜单上，添加二级菜单的入口。如需添加更多级别的菜单，也是相同的方法。

1. 编辑一级菜单root_preferences.xml

       <PreferenceScreen xmlns:app="http://schemas.android.com/apk/res-auto">
       <PreferenceCategory app:title="一级菜单 ">
            ……省略……
           <Preference
               app:fragment="com.amizhou.example.Level_2_SettingsFragment"   这是最关键的地方，要指向二级菜单的fragment类
               app:key="Level_2_SettingsFragment"
               app:title="Level_2_SettingsFragment"
               app:summary="二级菜单页面"/>        
                ……省略……
   

到这里，一二级菜单的fragment和菜单项xml都创建好了，也做好了级别菜单之间的关联。

.

6.AS创建MainActivity

开始创建MainActivity，用于加载一级菜单的fragment。二级菜单会自动被一级菜单所加载

1. 选中如下目录

2. 右键->New->Acitivity->Empty Activity：命名为MainActivity

3. 给MainActivity的layout加一个资源id

​ 路径：src\main\res\layout\activity_main.xml

<?xml version="1.0" encoding="utf-8"?>
<androidx.constraintlayout.widget.ConstraintLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    xmlns:tools="http://schemas.android.com/tools"
    android:id="@+id/layout_activity_main"    -》给MainActivity的layout加一个资源id
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    tools:context=".MainActivity">

</androidx.constraintlayout.widget.ConstraintLayout>

.

7.在MainActivity中，添加加载frament的语句

public class MainActivity extends AppCompatActivity {

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        //添加下列语句，加载一级菜单的fragment
        getSupportFragmentManager()
                .beginTransaction()
                .replace(R.id.layout_activity_main, new Level_1_SettingsFragment())
                .commit();

    }
}

.

8.编译、运行、成功demo的画面

• 启动后，先显示 Level_1_SettingsFragment 一级菜单

• 点击Item选项：Level_2_SettingsFragment 后，进入二级菜单

• 因为一、二级菜单的其他item都是默认的，所以样子比较像，我们通过修改一二级菜单的Title来识别
  

• 二级菜单画面如下：
  

9. 结束语

重学android，发现目前看谷歌这方面资料，比较少，而网上大部分还是使用的旧的support库的例子，没想看；通过研究TV settings APK的源码，仿照着终于写出个demo~，有点寒碜……但路还是必须走