Android Jetpack 架构组件实战指南

Android Jetpack 架构组件实战指南 | 极客日志

Android Jetpack 架构组件实战指南

前言

自 2018 年面世，Jetpack 已迎来多个版本迭代，在原有基础上增加了许多新组件。然而，仍有不少 Android 工程师停留在知道或了解过，但实际使用较少的阶段。Jetpack 是 Google 官方推出的 Android 开发工具包集合，旨在帮助开发者遵循最佳实践、减少样板代码并简化复杂任务，使开发者能将精力集中于业务逻辑的实现。

1. 什么是 Jetpack

1.1 简介

Jetpack 是一系列库和工具的集合，可帮助开发者更轻松地构建高质量的应用程序。它涵盖了从 UI 构建到数据持久化的各个方面。

1.2 特性

向后兼容：大部分库支持旧版本的 Android API。
模块化：按需引入依赖，减小应用体积。
测试友好：内置对单元测试和集成测试的支持。

1.3 分类

Jetpack 组件主要分为以下几类：

基础：如 Lifecycle, ViewModel, LiveData。
UI：如 Navigation, Compose, DataBinding。
数据存储：如 Room, DataStore。
后台处理：如 WorkManager。

1.4 应用架构

推荐采用 MVVM（Model-View-ViewModel）架构模式，结合 Jetpack 组件实现解耦。Activity/Fragment 作为 View，负责 UI 展示；ViewModel 负责业务逻辑和数据状态；Repository 负责数据源管理。

2.1 概述

Navigation 组件用于管理应用内的导航流，支持深链接、动态图生成等功能。

2.2 核心概念

NavGraph：定义所有目的地（Destination）及其连接关系。
NavController：控制导航操作的对象。
Safe Args：类型安全的参数传递机制。

2.3 实战步骤

添加依赖：在 build.gradle 中配置 navigation 插件及库。

implementation 'androidx.navigation:navigation-fragment-ktx:2.7.0'
implementation 'androidx.navigation:navigation-ui-ktx:2.7.0'

创建 NavGraph：在 res/navigation 目录下创建 xml 文件，定义 Fragment 和 Action。
初始化 NavController：在 Activity 或 Fragment 中获取 NavController 实例。
界面跳转：调用 navController.navigate(R.id.action_fragment_to_fragment)。
参数传递：使用 Safe Args 插件自动生成序列化代码。

2.4 总结

Navigation 组件大大简化了碎片间跳转的逻辑，减少了硬编码的 Intent 传递。

3. Android Jetpack - Data Binding

3.1 介绍

Data Binding 允许将布局中的视图与应用程序中的数据源直接绑定，减少 findViewById 的使用。

3.2 开启方式

在 app/build.gradle 中启用 dataBinding：

android {
    ...
    dataBinding {
        enabled = true
    }
}

3.3 实战示例

在布局 XML 中设置 binding 变量：

<layout>
    <data>
        <variable name="user" type="com.example.User" />
    </data>
    <TextView
        android:text="@{user.name}"
        ... />
</layout>

在代码中获取 binding 对象并设置数据：

val binding = ActivityMainBinding.inflate(layoutInflater)
binding.user = user
binding.executePendingBindings()

3.4 双向绑定

通过 @Bindable 和 @Observable 注解实现视图与数据的实时同步更新。

4. Android Jetpack - ViewModel & LiveData

4.1 ViewModel

ViewModel 设计用于存储和管理与 UI 相关的数据，并在配置更改（如屏幕旋转）时保持数据存活。

4.2 LiveData

LiveData 是一个可观察的数据持有者，具有生命周期感知能力，仅在活动处于活跃状态时通知观察者。

4.3 使用方法

创建 ViewModel：继承 AndroidX 的 ViewModel 类。

class MainViewModel : ViewModel() {
    val userName = MutableLiveData<String>()
    fun loadUser() {
        userName.value = "Guest"
    }
}

在 Fragment 中观察：

private val viewModel: MainViewModel by viewModels()
viewModel.userName.observe(viewLifecycleOwner) { name ->
    textView.text = name
}

4.4 数据共享

可在同一 Activity 的不同 Fragment 之间共享 ViewModel 实例，实现跨组件通信。

5. Android Jetpack - Room

5.1 简介

Room 是 SQLite 的抽象层，提供编译时检查的数据库访问，减少运行时错误。

5.2 实战步骤

添加依赖：

implementation 'androidx.room:room-runtime:2.5.0'
kapt 'androidx.room:room-compiler:2.5.0'

定义实体：使用 @Entity 注解标记数据表。

@Entity(tableName = "notes")
data class Note(@PrimaryKey(autoGenerate = true) val id: Int, val title: String)

创建 DAO：使用 @Dao 接口定义 SQL 查询方法。

@Dao
interface NoteDao {
    @Insert fun insert(note: Note)
    @Query("SELECT * FROM notes") fun getAll(): List<Note>
}

构建数据库：继承 RoomDatabase 类。

@Database(entities = [Note::class], version = 1)
abstract class AppDatabase : RoomDatabase() {
    abstract fun noteDao(): NoteDao
}

6. Android Jetpack - Paging

6.1 介绍

Paging 库用于高效地加载和显示大型数据集，避免一次性加载导致内存溢出。

6.2 实战流程

添加依赖：implementation 'androidx.paging:paging-runtime-ktx:3.1.1'
创建 PagedList：使用 Pager 构建器。
适配 RecyclerView：使用 PagedListAdapter 自动处理数据变化。

7. Android Jetpack - WorkManager

7.1 介绍

WorkManager 用于调度延迟执行且保证执行的后台任务，即使应用退出或设备重启。

7.2 实战示例

创建 Worker：继承 Worker 类。

class MyWorker(appContext: Context, params: WorkerParameters) : Worker(appContext, params) {
    override fun doWork(): Result {
        // 执行任务
        return Result.success()
    }
}

提交任务：

val workRequest = OneTimeWorkRequestBuilder<MyWorker>().build()
WorkManager.getInstance(context).enqueue(workRequest)

8. Android Jetpack 架构组件之 Lifecycle

8.1 简介

Lifecycle 描述了组件的生命周期状态（INITIALIZED, CREATED, STARTED, RESUMED, DESTROYED），其他组件可以监听这些状态变化。

8.2 使用场景

常用于处理生命周期敏感的操作，如停止地图渲染、暂停视频播放等。

9. Android Jetpack Compose 最全上手指南

9.1 声明式 UI

Compose 采用声明式编程范式，UI 是状态的函数，状态改变时 UI 自动重组。

9.2 环境准备

在 build.gradle 中添加 Compose 依赖，并配置 composeOptions。

9.3 Hello World

使用 @Composable 注解定义第一个 UI 组件。

@Composable
fun Greeting(name: String) {
    Text(text = "Hello $name!")
}

9.4 布局

使用 Column, Row, Box 等组合器进行布局，配合 Modifier 修饰属性。

10. Android Jetpack 架构组件–App Startup

10.1 解决的问题

解决 Application onCreate 中初始化过多组件导致的启动缓慢问题。

10.2 使用方式

通过 InitializationProvider 异步初始化组件，如 Analytics, Crashlytics。

11. Android Jetpack 最新更新组件介绍

11.1 Hilt

Hilt 是建立在 Dagger 之上的依赖注入框架，为 Android 提供了开箱即用的 DI 支持。

11.2 Paging3

相比 Paging2，Paging3 基于 Kotlin Flow，提供更灵活的数据流处理。

12. Android Jetpack 项目实战

12.1 项目目的

从零搭建一个基于 Jetpack 架构的 WanAndroid 客户端，整合上述所有组件。

12.2 模块划分

Network：Retrofit + OkHttp。
Local：Room + DataStore。
UI：Compose + Navigation。
Logic：ViewModel + Repository。

12.3 总结

通过完整的项目实践，能够深入理解各组件间的协作关系，提升架构设计能力。

结尾

掌握 Jetpack 组件是现代 Android 开发的必备技能。建议在实际项目中逐步替换旧有方案，持续优化代码质量与用户体验。

Android Jetpack 架构组件实战指南