能否在Android Preference Screen的单个设置项中添加多个复选框？

Android Jetpack Preference库未提供原生的多复选框内嵌Preference组件，你需要通过自定义Preference的方式实现需求，具体步骤如下：

步骤1：编写自定义Preference布局 #

在res/layout目录下新建布局文件preference_multi_check.xml，示例代码如下：

<?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:orientation="horizontal"
    android:paddingVertical="16dp"
    android:paddingHorizontal="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="wrap_content"
            android:layout_height="wrap_content"
            android:textSize="16sp"
            android:textColor="?android:attr/textColorPrimary"/>
        <TextView
            android:id="@android:id/summary"
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:textSize="14sp"
            android:layout_marginTop="4dp"
            android:textColor="?android:attr/textColorSecondary"/>
    </LinearLayout>

    <!-- 右侧复选框区域 -->
    <LinearLayout
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:orientation="horizontal"
        android:gap="12dp">
        <CheckBox
            android:id="@+id/check1"
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:text="选项1"/>
        <CheckBox
            android:id="@+id/check2"
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:text="选项2"/>
        <CheckBox
            android:id="@+id/check3"
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:text="选项3"/>
    </LinearLayout>
</LinearLayout>

步骤2：实现自定义Preference类 #

新建MultiCheckPreference类继承自Preference，处理布局绑定、状态读写逻辑：

class MultiCheckPreference(context: Context, attrs: AttributeSet?) : Preference(context, attrs) {
    // 存储三个复选框的选中状态
    private var checkStates = booleanArrayOf(false, false, false)

    init {
        // 指定自定义布局
        layoutResource = R.layout.preference_multi_check
    }

    override fun onBindViewHolder(holder: PreferenceViewHolder) {
        super.onBindViewHolder(holder)
        // 绑定复选框组件
        val check1 = holder.findViewById(R.id.check1) as CheckBox
        val check2 = holder.findViewById(R.id.check2) as CheckBox
        val check3 = holder.findViewById(R.id.check3) as CheckBox

        // 回显已存储的状态
        check1.isChecked = checkStates[0]
        check2.isChecked = checkStates[1]
        check3.isChecked = checkStates[2]

        // 监听选中变化，存储状态
        val checkListener = CompoundButton.OnCheckedChangeListener { buttonView, isChecked ->
            when(buttonView.id) {
                R.id.check1 -> checkStates[0] = isChecked
                R.id.check2 -> checkStates[1] = isChecked
                R.id.check3 -> checkStates[2] = isChecked
            }
            // 持久化存储状态，这里将布尔数组转为字符串存储，可根据需求调整存储格式
            persistString(checkStates.joinToString(",") { if (it) "1" else "0" })
        }
        check1.setOnCheckedChangeListener(checkListener)
        check2.setOnCheckedChangeListener(checkListener)
        check3.setOnCheckedChangeListener(checkListener)
    }

    override fun onGetDefaultValue(a: TypedArray, index: Int): Any {
        // 读取XML中配置的默认值
        return a.getString(index) ?: "0,0,0"
    }

    override fun onSetInitialValue(defaultValue: Any?) {
        // 初始化状态
        val savedValue = getPersistedString(defaultValue as? String ?: "0,0,0")
        checkStates = savedValue.split(",").map { it == "1" }.toBooleanArray()
    }
}

步骤3：添加到PreferenceScreen配置 #

在你的Preference XML配置文件中引用自定义组件即可：

<PreferenceScreen xmlns:android="http://schemas.android.com/apk/res/android">
    <!-- 其他原有配置项 -->
    <com.yourpackage.MultiCheckPreference
        android:key="multi_check_setting"
        android:title="多选项设置"
        android:summary="这是一个内嵌多复选框的设置项"
        android:defaultValue="0,0,0"/>
</PreferenceScreen>

注意：将com.yourpackage替换为你实际的MultiCheckPreference类所在的包路径。

扩展提示 #

如果需要适配不同场景的多选项需求，不要把选项写死在布局中，可以通过自定义declare-styleable属性，在XML中配置选项文本、数量，在自定义Preference类中动态生成CheckBox组件，灵活性更高。

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