Android Academy · Pelajaran

Penyesuai & DiffUtil

Bina penyesuai senarai yang cekap dan beranimasi dengan ListAdapter dan DiffUtil.ItemCallback. Gunakan submitList() untuk kemas kini separa yang lancar.

Pelajaran 6 daripada 613 langkah

Penyesuai & DiffUtil ialah pelajaran Android Academy percuma di CoddyKit. Ini ialah pelajaran 6 daripada 6. Sebanyak 3 pelajaran dalam laluan pembelajaran ini boleh dibaca sepenuhnya secara percuma — selepas itu, CoddyKit PRO membuka akses kepada semua pelajaran, serta latihan praktikal dengan penyunting kod terbina dalam dan tutor kecerdasan buatan yang tersedia 24/7. Pelajaran ini merupakan sebahagian daripada laluan pembelajaran Android Academy, dan kemajuan anda disegerakkan merentas web serta aplikasi CoddyKit. Kursus Android Academy merangkumi sejumlah 6 pelajaran.

Masalah dengan notifyDataSetChanged()

Apabila data RecyclerView berubah, pemanggilan notifyDataSetChanged() melukis semula setiap item — termasuk item yang tidak berubah. Hal ini menyebabkan:

  • Tiada animasi item
  • Prestasi lemah untuk senarai besar
  • UI berkelip

DiffUtil mengira set perubahan minimum dan menggunakannya dengan animasi yang lancar.

DiffUtil.ItemCallback

Tentukan cara dua item dibandingkan. Terdapat dua soalan yang perlu dijawab:

  • areItemsTheSame — adakah item tersebut mewakili item logik yang sama? (biasanya bandingkan ID)
  • areContentsTheSame — adakah semua medan yang kelihatan adalah sama?
data class Post(val id: Int, val title: String, val likes: Int)

class PostDiffCallback : DiffUtil.ItemCallback<Post>() {

    override fun areItemsTheSame(oldItem: Post, newItem: Post): Boolean {
        return oldItem.id == newItem.id   // same post?
    }

    override fun areContentsTheSame(oldItem: Post, newItem: Post): Boolean {
        return oldItem == newItem         // data class equality (all fields)
    }
}

ListAdapter

ListAdapter ialah RecyclerView.Adapter dengan DiffUtil terbina dalam. Hantar ItemCallback kepada pembinanya dan panggil submitList() untuk mengemas kini data:

class PostAdapter : ListAdapter<Post, PostAdapter.ViewHolder>(PostDiffCallback()) {

    inner class ViewHolder(val binding: ItemPostBinding) : RecyclerView.ViewHolder(binding.root)

    override fun onCreateViewHolder(parent: ViewGroup, viewType: Int): ViewHolder {
        val binding = ItemPostBinding.inflate(LayoutInflater.from(parent.context), parent, false)
        return ViewHolder(binding)
    }

    override fun onBindViewHolder(holder: ViewHolder, position: Int) {
        val post = getItem(position)   // use getItem(), not a manual list
        holder.binding.tvTitle.text = post.title
        holder.binding.tvLikes.text = "${post.likes} likes"
    }
}

Menghantar Senarai Baharu

Panggil submitList() setiap kali data anda berubah. ListAdapter membandingkan senarai lama dan baharu pada bebenang latar, kemudian menggunakan perubahan yang diperlukan sahaja:

// In Activity or Fragment:
val adapter = PostAdapter()
binding.recyclerView.adapter = adapter

// Observe ViewModel LiveData:
viewModel.posts.observe(viewLifecycleOwner) { posts ->
    adapter.submitList(posts)   // diff calculated off main thread
}

// Important: always submit a NEW list, not a mutated old one
// WRONG:  currentList.add(newPost); adapter.submitList(currentList)
// RIGHT:  adapter.submitList(currentList + newPost)

Pendengar Klik dalam ListAdapter

Hantar pengendali klik melalui pembina — ini ialah corak yang biasa dan kemas:

class PostAdapter(
    private val onLike: (Post) -> Unit,
    private val onOpen: (Post) -> Unit
) : ListAdapter<Post, PostAdapter.ViewHolder>(PostDiffCallback()) {

    override fun onBindViewHolder(holder: ViewHolder, position: Int) {
        val post = getItem(position)
        holder.binding.tvTitle.text = post.title
        holder.binding.btnLike.setOnClickListener { onLike(post) }
        holder.itemView.setOnClickListener { onOpen(post) }
    }
}

// Usage:
val adapter = PostAdapter(
    onLike = { viewModel.likePost(it) },
    onOpen = { navigateToDetail(it.id) }
)

getChangePayload() — Kemas Kini Separa

Apabila hanya satu medan berubah, contohnya bilangan suka, elakkan pengikatan semula penuh dengan getChangePayload():

class PostDiffCallback : DiffUtil.ItemCallback<Post>() {
    override fun areItemsTheSame(oldItem: Post, newItem: Post) = oldItem.id == newItem.id
    override fun areContentsTheSame(oldItem: Post, newItem: Post) = oldItem == newItem

    override fun getChangePayload(oldItem: Post, newItem: Post): Any? {
        // Return non-null payload to trigger partial bind
        return if (oldItem.likes != newItem.likes) "likes_changed" else null
    }
}

// In Adapter.onBindViewHolder with payloads:
override fun onBindViewHolder(holder: ViewHolder, position: Int, payloads: List<Any>) {
    if (payloads.contains("likes_changed")) {
        holder.binding.tvLikes.text = "${getItem(position).likes} likes"
    } else {
        super.onBindViewHolder(holder, position, payloads)
    }
}

Berbilang Jenis Paparan

Gunakan getItemViewType() untuk memaparkan susun atur item yang berbeza dalam senarai yang sama:

class FeedAdapter : ListAdapter<FeedItem, RecyclerView.ViewHolder>(FeedDiffCallback()) {

    companion object {
        const val TYPE_POST = 0
        const val TYPE_AD   = 1
    }

    override fun getItemViewType(position: Int): Int {
        return when (getItem(position)) {
            is FeedItem.Post -> TYPE_POST
            is FeedItem.Ad   -> TYPE_AD
        }
    }

    override fun onCreateViewHolder(parent: ViewGroup, viewType: Int) = when (viewType) {
        TYPE_POST -> PostViewHolder(ItemPostBinding.inflate(LayoutInflater.from(parent.context), parent, false))
        else      -> AdViewHolder(ItemAdBinding.inflate(LayoutInflater.from(parent.context), parent, false))
    }
}

ConcatAdapter — Menggabungkan Senarai

ConcatAdapter menggabungkan berbilang penyesuai menjadi satu RecyclerView — sesuai untuk pengepala, pengaki dan keadaan pemuatan:

// Separate adapters for different sections
val headerAdapter = HeaderAdapter()
val postAdapter   = PostAdapter()
val loaderAdapter = LoadingAdapter()

// Combine them in order
binding.recyclerView.adapter = ConcatAdapter(headerAdapter, postAdapter, loaderAdapter)

// Update each independently
postAdapter.submitList(posts)
loaderAdapter.showLoading(true)

AsyncListDiffer — Kawalan Manual

Jika anda tidak boleh melanjutkan ListAdapter, gunakan AsyncListDiffer secara terus:

class CustomAdapter : RecyclerView.Adapter<CustomAdapter.ViewHolder>() {

    private val differ = AsyncListDiffer(this, PostDiffCallback())

    fun submitList(list: List<Post>) = differ.submitList(list)
    fun getItem(position: Int): Post = differ.currentList[position]

    override fun getItemCount() = differ.currentList.size
}

Petua Prestasi

Pastikan RecyclerView anda pantas:

  • Gunakan setHasStableIds(true) jika item anda mempunyai ID unik dan stabil
  • Elakkan mencipta objek di dalam onBindViewHolder
  • Gunakan RecycledViewPool untuk berkongsi paparan yang dikitar semula antara berbilang RecyclerViews
  • Gunakan setItemViewCacheSize() untuk meningkatkan cache di luar skrin

Animasi Tersedia Secara Automatik

Integrasi DiffUtil ListAdapter mencetuskan DefaultItemAnimator secara automatik untuk:

  • Kemunculan beransur-ansur bagi item baharu
  • Penyamaran beransur-ansur bagi item yang dibuang
  • Animasi pergerakan apabila kedudukan item berubah

Tetapkan animator tersuai: recyclerView.itemAnimator = MyAnimator(). Tetapkan kepada null untuk melumpuhkan semua animasi.

Semakan Pantas

Apakah dua kaedah yang mesti anda laksanakan dalam DiffUtil.ItemCallback?

Ulang Kaji: Penyesuai & DiffUtil

Senarai yang cekap dan beranimasi dengan kod minimum:

  • DiffUtil.ItemCallback — tentukan identiti (areItemsTheSame) dan kesamaan (areContentsTheSame)
  • ListAdapter — perbandingan tak segerak terbina dalam; panggil submitList()
  • Sentiasa hantar rujukan senarai baharu, jangan ubah senarai semasa
  • getChangePayload() untuk pengikatan semula separa
  • ConcatAdapter untuk menggabungkan berbilang penyesuai

Seterusnya: navigasi berbilang skrin dengan Navigation Component.

Percuma untuk bermula

Pelajari Kotlin dengan tutor kecerdasan buatan — percuma

Tulis dan jalankan kod sebenar dalam pelayar anda, dapatkan bantuan segera daripada tutor kecerdasan buatan yang tersedia 24/7, dan sambung semula dari tempat anda berhenti di web atau dalam aplikasi.

Kursus
36
Pelajaran
152

Soalan Lazim

Adakah pelajaran “Penyesuai & DiffUtil” percuma?

Ya — sebanyak 3 pelajaran dalam laluan pembelajaran Android Academy, termasuk “Penyesuai & DiffUtil”, boleh dibaca sepenuhnya secara percuma di web ini. Selepas itu, CoddyKit PRO membuka akses kepada semua pelajaran, serta latihan interaktif dengan penyunting kod terbina dalam dan tutor kecerdasan buatan yang tersedia 24/7. Kursus Android Academy merangkumi sejumlah 6 pelajaran.

Apakah yang akan saya pelajari dalam “Penyesuai & DiffUtil”?

Bina penyesuai senarai yang cekap dan beranimasi dengan ListAdapter dan DiffUtil.ItemCallback. Gunakan submitList() untuk kemas kini separa yang lancar. Anda berlatih Android Academy menggunakan kod praktikal yang dijalankan terus dalam pelayar, manakala tutor kecerdasan buatan 24/7 menjawab soalan anda semasa anda mengikuti pelajaran.

Adakah saya memerlukan pengalaman untuk memulakan Android Academy?

Tiada pengalaman terdahulu diperlukan. Pembelajaran Android Academy di CoddyKit disusun untuk pelajar daripada peringkat pemula hingga lanjutan, jadi anda boleh bermula di sini atau dari awal dan belajar mengikut kadar anda sendiri. Ini ialah pelajaran 6 daripada 6.

Berapa lamakah pelajaran “Penyesuai & DiffUtil” diambil?

Kebanyakan pelajaran CoddyKit mengambil masa kira-kira 5–10 minit. Setiap pelajaran ringkas dan interaktif, jadi anda boleh membuat kemajuan secara berterusan dan menyambung tepat dari tempat anda berhenti di web atau aplikasi.

Bolehkah saya menulis dan menjalankan kod dalam pelajaran Android Academy ini?

Ya. Setiap pelajaran Android Academy menyertakan penyunting kod terbina dalam, jadi anda boleh menulis dan menjalankan kod sebenar terus dalam pelayar serta menerima maklum balas kecerdasan buatan serta-merta — tanpa memerlukan persediaan setempat.

Semua pelajaran dalam kursus ini

  1. Koleksi Kotlin
  2. Asas RecyclerView
  3. Peristiwa Klik RecyclerView
  4. SharedPreferences
  5. Pilihan DataStore
  6. Penyesuai & DiffUtil
← Kembali ke Android Academy