RecycleView使用指北

设定 xml 布局

首先在 .xml 文件中放置一个 RecyclerView

<!-- 🌰 -->
<androidx.recyclerview.widget.RecyclerView
            android:id="@+id/unpair_device_list"
            android:layout_width="match_parent"
            android:layout_height="wrap_content"
            android:scrollbars="vertical"
            app:layout_constraintStart_toStartOf="parent"
            app:layout_constraintTop_toTopOf="parent" />

其次新建一个 .xml 文件用于对 RecyclerView 中每一条数据进行布局，姑且称为「子布局」

<!-- 🌰 -->
<LinearLayout
        android:id="@+id/unpair_linear"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:orientation="horizontal"
        android:background="@drawable/recycler_touch_bg"
        android:minHeight="28dp"
        android:layout_marginTop="8dp"
        app:layout_constraintTop_toTopOf="parent">

        <TextView
            android:id="@+id/unpair_device_name"
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:width="200dp"
            android:singleLine="false"
            android:text="name" />

        <Space
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:layout_weight="0.5" />

        <TextView
            android:id="@+id/unpair_device_status"
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:width="84dp"
            android:gravity="end"
            android:text="status" />

        <ImageButton
            android:id="@+id/device_detail"
            android:layout_width="32dp"
            android:layout_height="32dp"
            android:layout_marginEnd="4dp"
            android:layout_marginStart="4dp"
            android:background="@android:color/transparent"
            android:contentDescription="@string/device_detail_ico"
            android:scaleType="fitCenter"
            app:layout_constraintBottom_toBottomOf="parent"
            app:layout_constraintEnd_toEndOf="parent"
            app:layout_constraintTop_toTopOf="parent"
            app:srcCompat="@drawable/back_ico" />
    </LinearLayout>

构建 RecyclerViewAdapter

接着新建一个 RecyclerViewAdapter.kt(这里以 kotlin 为例)

// 类一般包含上下文，继承RecyclerView.Adapter，类型为自身的ViewHolder(稍后创建)
class UnpairRecyclerViewAdapter(private val context: Activity) :RecyclerView.Adapter<UnpairRecyclerViewAdapter.ViewHolder>() {
    // 创建一个数据集，用于存储数据
    private var devices: List<BluetoothDevice> = listOf()
    
    // 创建一个内部类，包含子布局的 view
    class ViewHolder(itemView: View) : RecyclerView.ViewHolder(itemView) {
        val unpairDeviceName: TextView = itemView.findViewById(R.id.unpair_device_name)
        val unpairDeviceStatus: TextView = itemView.findViewById(R.id.unpair_device_status)
	}
    
    // 重写获取创建 ViewHolder 方法，用于获取子布局(这里获取的是.xml文件，这才能让上面的内部类访问其中的 view)
    override fun onCreateViewHolder(parent: ViewGroup, viewType: Int): ViewHolder {
        val view =
            LayoutInflater.from(parent.context).inflate(R.layout.unpair_list_item, parent, false)
        return ViewHolder(view)
    }
    
    // 用于将数据绑定到 view 中
    override fun onBindViewHolder(holder: ViewHolder, position: Int) {
        val device = devices[position]
        if (!Utils.checkPermission(context, BLUETOOTH_CONNECT)) {
            Utils.requestPermission(context, BLUETOOTH_CONNECT)
            return
        }
        holder.unpairDeviceName.text = device.name ?: "Unknown"
        holder.unpairDeviceStatus.text = "未配对"
    }
    
    // 用于获取数据的个数
    override fun getItemCount(): Int {
        return devices.size
    }
    
    // 这里是自行创建的方法，用于更新数据集并提醒 RecycleView 的更新
    @SuppressLint("NotifyDataSetChanged")
    fun setUnpairList(deviceList: List<BluetoothDevice>) {
        devices = deviceList
        
        context.runOnUiThread {// 防止在非UI线程中被调用抛出错误
            Handler(Looper.getMainLooper()).post {// 将提醒数据更新的行为放在主线程，防止与UI绘制打架抛出错误
                notifyDataSetChanged()
            }
        }
    }
}

在 Activity 中实例化

接下来需要在目标 activity 中加载RecycleView的适配器和更新数据

// 获取目标 RecyclerView，
val pairDevicesList: RecyclerView = view.findViewById(R.id.pair_device_list)
// 实例化适配器
val pairAdapter = PairRecyclerViewAdapter(requireActivity(), this)

// 为 RecyclerView 设置适配器
pairDevicesList.adapter = pairAdapter
// 为 RecyclerView 设置布局管理器(经常忘记导致老是不出数据)
pairDevicesList.layoutManager = LinearLayoutManager(requireActivity())

// 接下来就可以更新数据了
pairAdapter.setUnpairList(/* 传入的数据 */)