Android入门到实战（七）：从零开始实现App的发现页面

发布于：2025-09-05 ⋅ 阅读:(21) ⋅ 点赞:(0)

一. 引言

在系列博客中，我们已经介绍了 App 架构、网络请求封装、图片加载等基础知识。现在，我们正式进入页面实战环节——从零实现 App 的 发现页。

这个页面主要用于展示剧集列表，每个条目包含封面、标题、描述、标签和词汇量信息，同时支持点击操作和空状态提示。

本篇重点讲解 页面结构、RecyclerView 使用、ViewModel 与网络请求整合、图片加载。

二. 页面结构设计

2.1 主布局 fragment_discover.xml

主布局采用 ConstraintLayout，结构清晰：

<androidx.constraintlayout.widget.ConstraintLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:tools="http://schemas.android.com/tools"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    tools:context=".page.discover.fragment.DiscoverFragment">
<!--渐变-->
    <View
        android:id="@+id/header_bg"
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        android:background="@drawable/discover_gradient_bg" />
<!--    导航栏-->
    <com.google.android.material.appbar.MaterialToolbar
        android:id="@+id/toolbar"
        android:layout_width="0dp"
        android:layout_height="?attr/actionBarSize"
        android:background="@android:color/transparent"
        android:titleTextColor="@android:color/black"
        app:layout_constraintTop_toTopOf="parent"
        app:layout_constraintStart_toStartOf="parent"
        app:layout_constraintEnd_toEndOf="parent"
        style="@style/Widget.MaterialComponents.Toolbar"/>
<!--    列表-->

    <androidx.recyclerview.widget.RecyclerView
        android:id="@+id/recyclerView"
        android:layout_width="match_parent"
        android:layout_height="0dp"
        app:layout_constraintTop_toBottomOf="@id/toolbar"
        app:layout_constraintBottom_toBottomOf="parent" />
<!--    空-->
    <TextView
        android:id="@+id/tip_view"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:text="暂无内容"
        android:textSize="16sp"
        android:textColor="@android:color/darker_gray"
        app:layout_constraintTop_toTopOf="parent"
        app:layout_constraintBottom_toBottomOf="parent"
        app:layout_constraintStart_toStartOf="parent"
        app:layout_constraintEnd_toEndOf="parent" />

</androidx.constraintlayout.widget.ConstraintLayout>
  • View 实现渐变背景效果
  • MaterialToolbar 透明背景，实现自定义标题
  • RecyclerView 用于显示剧集列表
  • TextView 提供空状态提示

2.2 列表项布局 discover_drama_item.xml

每个条目使用 MaterialCardView 包裹，左侧封面、右侧信息区，标签可以横向滚动：

<com.google.android.material.card.MaterialCardView xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="wrap_content"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    android:layout_margin="8dp"
    app:cardCornerRadius="8dp"
    app:cardElevation="4dp">

    <LinearLayout
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:orientation="horizontal"
        android:padding="12dp">

        <com.google.android.material.card.MaterialCardView
            android:layout_width="100dp"
            android:layout_height="140dp"
            android:layout_marginEnd="12dp"
            app:cardCornerRadius="8dp"
            app:cardElevation="0dp">

            <ImageView
                android:id="@+id/dramaCover"
                android:layout_width="match_parent"
                android:layout_height="match_parent"
                android:scaleType="centerCrop"
                android:contentDescription="封面图片"/>
        </com.google.android.material.card.MaterialCardView>

        <LinearLayout
            android:layout_width="0dp"
            android:layout_height="wrap_content"
            android:layout_weight="1"
            android:orientation="vertical"
            android:layout_marginStart="12dp">

            <TextView
                android:id="@+id/dramaTitle"
                android:layout_width="wrap_content"
                android:layout_height="wrap_content"
                android:text="剧名"
                android:textSize="16sp"
                android:textStyle="bold" />

            <TextView
                android:id="@+id/dramaDesc"
                android:layout_width="wrap_content"
                android:layout_height="wrap_content"
                android:text="剧目描述"
                android:textSize="14sp"
                android:lines="3"
                android:textColor="@android:color/darker_gray"
                android:layout_marginTop="4dp"/>

            <HorizontalScrollView
                android:layout_width="match_parent"
                android:layout_height="wrap_content"
                android:layout_marginTop="8dp"
                android:scrollbars="none">

                <LinearLayout
                    android:id="@+id/tagContainer"
                    android:layout_width="wrap_content"
                    android:layout_height="wrap_content"
                    android:orientation="horizontal" />
            </HorizontalScrollView>

            <TextView
                android:id="@+id/wordCount"
                android:layout_width="wrap_content"
                android:layout_height="wrap_content"
                android:text="词汇量: 0"
                android:textSize="14sp"
                android:textColor="@android:color/darker_gray"
                android:layout_marginTop="8dp"/>
        </LinearLayout>
    </LinearLayout>

</com.google.android.material.card.MaterialCardView>
  • 封面使用 ImageView，加载剧集图片
  • 标签通过 HorizontalScrollView + LinearLayout 动态添加
  • 信息区显示标题、描述和词汇量

三. 数据模型与 Repository

3.1 数据模型

@JsonClass(generateAdapter = true)
data class DiscoverDrama(
    var id: Int? = null,
    var dramaId: String = "",
    var title: String = "",
    var coverUrl: String? = null,
    var description: String? = null,
    var tags: String? = null,
    var vocabularyCount: String? = null
) {
    val realCoverUrl: String?
        get() { ... } // 修正 URL
}
@JsonClass(generateAdapter = true)
data class DramaResponse(
    val code: Int,
    val message: String,
    @Json(name = "data") val data: List<DiscoverDrama> = emptyList()
)

3.2 Repository

class DiscoverRespository {
    private var apiService = NetworkClient.apiService

    suspend fun fetchDramas(): Result<List<DiscoverDrama>> {
        return try {
            val response: DramaResponse = apiService.fetchDiscoverDramas()
            if (response.code == 200) Result.success(response.data)
            else Result.failure(Exception("服务器返回错误码: ${response.code}"))
        } catch (e: Exception) {
            Result.failure(e)
        }
    }
}

  • Repository 封装网络请求
  • 使用 Result 区分成功/失败
  • 异步请求结合 ViewModel 使用

四. ViewModel层

class DiscoverViewModel: ViewModel() {
    private val discoverDramaRepository by lazy { DiscoverRespository() }
    val dramas = MutableLiveData<List<DiscoverDrama>>()
    val isLoading = MutableLiveData<Boolean>()

    fun fetchDramas() {
        isLoading.value = true
        viewModelScope.launch {
            val result = discoverDramaRepository.fetchDramas()
            result.onSuccess { dramas.value = it }
                  .onFailure { dramas.value = emptyList() }
            isLoading.value = false
        }
    }
}
  • 管理剧集列表和加载状态
  • 使用 Coroutine 异步请求数据
  • LiveData 自动通知 UI 更新

五. RecyclerView 与 Adapter

5.1 Adapter 实现

class DiscoverDramaAdapter(
    private val onItemClick:(DiscoverDrama)-> Unit
): RecyclerView.Adapter<DiscoverDramaAdapter.DiscoverDramaViewHolder>() {

    private val dramas: MutableList<DiscoverDrama> = mutableListOf()

    fun updateData(newDramas: List<DiscoverDrama>) {
        dramas.clear()
        dramas.addAll(newDramas)
        notifyDataSetChanged()
    }

    override fun onBindViewHolder(holder: DiscoverDramaViewHolder, position: Int) {
        val drama = dramas[position]
        Glide.with(holder.itemView.context)
            .load(drama.realCoverUrl)
            .apply(RequestOptions.bitmapTransform(RoundedCorners(8)))
            .into(holder.cover)
        holder.title.text = drama.title
        holder.desc.text = drama.description
        holder.wordCount.text = "词汇量: ${drama.vocabularyCount ?: 0}"
        
        holder.tagContainer.removeAllViews()
        drama.tags?.split("，")?.forEach { tag ->
            val tv = TextView(holder.itemView.context).apply { ... }
            holder.tagContainer.addView(tv)
        }
    }
}

5.2 RecyclerView 配置

recyclerView.layoutManager = LinearLayoutManager(requireContext())
recyclerView.adapter = adapter

viewModel.dramas.observe(viewLifecycleOwner) { dramas ->
    if (dramas.isNullOrEmpty()) tipTextView.isVisible = true
    else { tipTextView.isVisible = false; adapter.updateData(dramas) }
}

六. Fragment 实现

class DiscoverFragment : Fragment() {

    /// 导航栏
    private lateinit var toolbar: MaterialToolbar
    /// 列表
    private lateinit var recyclerView: androidx.recyclerview.widget.RecyclerView
    /// 提示
    private lateinit var tipTextView: TextView
    /// viewModel
    private val viewModel = DiscoverViewModel()


    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)

    }

    override fun onCreateView(
        inflater: LayoutInflater, container: ViewGroup?,
        savedInstanceState: Bundle?
    ): View? {
        // Inflate the layout for this fragment
        return inflater.inflate(R.layout.fragment_discover, container, false)
    }

    override fun onViewCreated(view: View, savedInstanceState: Bundle?) {
        super.onViewCreated(view, savedInstanceState)
        setupView(view)
        setupToolbar()
        setupRecyclerView()
        fetchData()
        Log.d("DiscoverFragment", "onViewCreated: DiscoverFragment created")
    }


    private fun setupView(view: View) {
        toolbar = view.findViewById<MaterialToolbar>(R.id.toolbar)
        recyclerView = view.findViewById<androidx.recyclerview.widget.RecyclerView>(R.id.recyclerView)
        tipTextView = view.findViewById<TextView>(R.id.tip_view)
        tipTextView.isVisible = false
    }

    private fun setupToolbar() {
        toolbar.title = "发现"

    }

    private fun setupRecyclerView() {
        // 设置 RecyclerView 的布局管理器和适配器
        recyclerView.layoutManager = androidx.recyclerview.widget.LinearLayoutManager(requireContext())
        // 模拟数据



        val adapter = DiscoverDramaAdapter(onItemClick =
        { drama ->
            Toast.makeText(
                requireContext(),
                "点击了: ${drama.title ?: "未知剧集"}",
                Toast.LENGTH_SHORT
            ).show()
        }
        )

        recyclerView.adapter = adapter
        Log.d("DiscoverFragment", "开始观察 dramas LiveData")
        viewModel.dramas.observe(viewLifecycleOwner) { dramas ->
            Log.d("DiscoverFragment", "dramas 更新: ${dramas?.size ?: 0} 条")
            if (dramas.isNullOrEmpty()) {
                Log.d("DiscoverFragment", "dramas 为空")
                tipTextView.isVisible = true
                tipTextView.text = "暂无剧集数据"
            } else {
                Log.d("DiscoverFragment", "dramas 有数据，更新 adapter")
                tipTextView.isVisible = false
                adapter.updateData(dramas)
            }
        }

    }

    // 请求数据
    private fun fetchData() {
        // 请求列表数据
        viewModel.fetchDramas()
    }



}
  • 绑定视图控件
  • 配置 Toolbar
  • 初始化 RecyclerView
  • 观察 ViewModel 更新 UI
  • 空状态显示/隐藏
  • 点击事件回调

七. 总结

本篇博客实现了发现页的完整页面：

  • 布局：ConstraintLayout + RecyclerView + MaterialCardView
  • 数据：Repository + ViewModel + LiveData
  • UI 渲染：Adapter + Glide + 动态标签
  • 交互：点击事件和空状态提示

通过这个示例，我们展示了如何将 页面结构、数据请求、图片加载 整合到一个完整的发现页中，为后续页面开发打下基础。

网站公告

今日签到

点亮在社区的每一天
去签到

热门文章

最新发布