Android如何实现类似系统设置的Split Preference分拆偏好控件

直接用AndroidX Preference库提供的TwoTargetPreference即可，这也是安卓原生设置里所有同类控件的官方实现基类，不需要自己从零写布局逻辑、也不需要做点击坐标判断，是成本最低、体验和原生完全一致的方案。

为什么你之前的尝试走不通 #

• 继承PreferenceGroup的方向错误：PreferenceGroup的设计定位是纵向承载多个子偏好（比如PreferenceCategory、PreferenceScreen的容器逻辑），不会做同一行内的横向布局拆分
• 继承LinearLayout的方案不符合PreferenceScreen的添加规则：PreferenceScreen的视图树只接受Preference及其子类作为子节点，直接继承普通View无法被正常挂载

具体实现步骤 #

• 先引入稳定版AndroidX Preference依赖
  在模块级build.gradle中添加依赖：

  implementation "androidx.preference:preference-ktx:1.2.1"
  

  TwoTargetPreference从1.1.0版本开始就已内置，不需要额外引入其他第三方库。

• 自定义偏好类继承TwoTargetPreference
  这个抽象类已经提前把偏好布局拆成了「主内容区」「右侧widget区」两个独立可点击区域，你只需要给两个区域分别绑定点击逻辑即可，最简Kotlin实现如下：

  class SplitActionPreference(
      context: Context,
      attrs: AttributeSet?
  ) : TwoTargetPreference(context, attrs) {
  
      // 对外暴露两个点击回调，业务层直接设置即可
      var onMainAreaClick: (() -> Unit)? = null
      var onRightAreaClick: (() -> Unit)? = null
  
      init {
          // 绑定自定义布局，样式和系统原生偏好保持一致
          layoutResource = R.layout.layout_preference_split
      }
  
      override fun onBindViewHolder(holder: PreferenceViewHolder) {
          super.onBindViewHolder(holder)
          // 拿到两个点击区域的实例
          val mainContent = holder.itemView
          val rightWidget = holder.findViewById(android.R.id.widget_frame)
  
          // 列表复用场景下先清空旧监听，避免事件错乱
          mainContent.setOnClickListener(null)
          rightWidget.setOnClickListener(null)
          mainContent.isClickable = true
          rightWidget.isClickable = true
  
          // 绑定点击事件
          mainContent.setOnClickListener { onMainAreaClick?.invoke() }
          rightWidget.setOnClickListener { onRightAreaClick?.invoke() }
      }
  }
  

• 编写对应布局文件layout_preference_split.xml
  布局结构和普通偏好一致即可，注意右侧容器必须使用系统预留id@android:id/widget_frame，示例：

  <?xml version="1.0" encoding="utf-8"?>
  <LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
      android:layout_width="match_parent"
      android:layout_height="wrap_content"
      android:background="?attr/selectableItemBackground"
      android:gravity="center_vertical"
      android:minHeight="72dp"
      android:paddingStart="16dp"
      android:paddingEnd="16dp">
  
      <LinearLayout
          android:layout_width="0dp"
          android:layout_height="wrap_content"
          android:layout_weight="1"
          android:orientation="vertical">
          <TextView
              android:id="@android:id/title"
              android:layout_width="match_parent"
              android:layout_height="wrap_content"
              android:textColor="?android:attr/textColorPrimary"
              android:textSize="16sp"/>
          <TextView
              android:id="@android:id/summary"
              android:layout_width="match_parent"
              android:layout_height="wrap_content"
              android:layout_marginTop="4dp"
              android:textColor="?android:attr/textColorSecondary"
              android:textSize="14sp"/>
      </LinearLayout>
  
      <FrameLayout
          android:id="@android:id/widget_frame"
          android:layout_width="wrap_content"
          android:layout_height="match_parent"
          android:background="?attr/selectableItemBackgroundBorderless"
          android:gravity="center"
          android:paddingStart="16dp">
          <!-- 在这里放你右侧的控件，比如CheckBox、Switch、箭头图标都可以 -->
      </FrameLayout>
  
  </LinearLayout>
  

其他方案的弊端 #

你之前考虑的「点击时判断坐标位置」的方案不推荐：需要自行适配RTL布局、字体大小变化、布局动态调整的场景，很容易出现点击区域错位的问题，维护成本远高于直接用官方基类。

如果需要实现和系统设置里自适应亮度偏好完全一致的效果，只需要在右侧widget_frame里放入SwitchMaterial控件，点击主区域时跳转到亮度调节说明页、点击右侧区域时切换开关状态即可，体验和原生完全无差异。

注：之前搜索不到相关方案是因为关键词偏差，搜索TwoTargetPreference就能找到官方文档和大量成熟实现参考，不需要参考十年前的过时方案。

内容的提问来源于stack exchange，提问作者Aragorn Crozier