Android Architecture Samples代码重构：从臃肿到清晰的转变-优快云博客

Android Architecture Samples代码重构：从臃肿到清晰的转变

【免费下载链接】architecture-samples A collection of samples to discuss and showcase different architectural tools and patterns for Android apps. 项目地址: https://gitcode.com/gh_mirrors/ar/architecture-samples

你是否曾面对数千行的Activity代码感到无从下手？是否在修改一个功能时，担心会影响到其他看似无关的模块？Android Architecture Samples项目通过一次彻底的重构，展示了如何将传统臃肿的代码转变为清晰、可维护的现代架构。本文将带你深入了解这一转变过程，以及如何在自己的项目中应用这些重构技巧。

读完本文后，你将能够：

理解MVVM架构在Android应用中的具体实现
掌握使用Jetpack组件简化代码的方法
学会如何将业务逻辑从UI中分离
了解数据层设计的最佳实践
掌握依赖注入的应用技巧

重构前的痛点分析

传统Android应用开发中，我们常常会遇到以下问题：

Activity/Fragment承担了过多责任，既处理UI逻辑，又包含业务逻辑和数据操作
代码耦合严重，修改一个功能需要在多个文件中进行修改
单元测试困难，因为组件之间相互依赖
异步操作处理复杂，容易导致内存泄漏

Android Architecture Samples项目在重构前也面临这些问题。让我们通过重构前后的对比，看看现代Android架构如何解决这些痛点。

整体架构设计

重构后的项目采用了清晰的分层架构，主要分为以下几层：

表现层：包含UI组件（Compose屏幕）和ViewModel
数据层：包含仓库(Repository)和数据源(DataSource)
依赖注入层：使用Hilt管理依赖关系

这种架构的优势在于：

关注点分离，每个组件只负责单一职责
高内聚低耦合，便于维护和扩展
便于单元测试，因为依赖关系清晰
符合单一数据源原则，确保数据一致性

表现层重构：UI与逻辑分离

重构的核心之一是将UI与业务逻辑分离。在重构后的项目中，这一目标通过Jetpack Compose和ViewModel实现。

ViewModel的引入

以任务列表功能为例，重构前的代码可能将数据加载、过滤和用户交互处理都放在Activity中。重构后，这些逻辑被移至TasksViewModel：

@HiltViewModel
class TasksViewModel @Inject constructor(
    private val taskRepository: TaskRepository,
    private val savedStateHandle: SavedStateHandle
) : ViewModel() {
    // 状态管理和业务逻辑
}

ViewModel负责：

持有和管理UI数据，确保配置变化时数据不丢失
处理业务逻辑，如任务过滤、添加、完成等操作
通过数据流(Flow)向UI暴露状态变化

UI组件的简化

UI部分则由Compose实现，如TasksScreen：

@Composable
fun TasksScreen(
    viewModel: TasksViewModel,
    navigateToTaskDetail: (String) -> Unit,
    navigateToAddTask: () -> Unit,
    modifier: Modifier = Modifier,
    state: TasksUiState = viewModel.uiState.collectAsStateWithLifecycle().value
) {
    // UI渲染逻辑
}

Compose屏幕只负责：

接收ViewModel提供的状态
根据状态渲染UI
将用户操作通过回调通知ViewModel

这种分离使得UI代码更加简洁，业务逻辑也更容易测试。

数据层重构：仓库模式的应用

数据层的重构是项目变得清晰的另一个关键。重构后的数据层采用了仓库模式，统一管理数据访问。

仓库实现

DefaultTaskRepository是数据层的核心组件：

@Singleton
class DefaultTaskRepository @Inject constructor(
    private val networkDataSource: NetworkDataSource,
    private val localDataSource: TaskDao,
    @DefaultDispatcher private val dispatcher: CoroutineDispatcher,
    @ApplicationScope private val scope: CoroutineScope,
) : TaskRepository {
    // 数据操作实现
}

仓库的主要职责：

统一数据访问入口，对上层提供一致的API
协调本地和远程数据源，实现数据同步
处理数据转换和映射

数据源分离

项目将数据源分为本地和网络两种：

本地数据源：使用Room数据库
网络数据源：模拟网络请求

这种分离使得应用可以轻松实现离线优先(Offline-First)策略，提高应用的健壮性和用户体验。

依赖注入：Hilt的应用

为了解决组件间依赖管理的问题，重构后的项目引入了Hilt。Hilt是基于Dagger的Android专用依赖注入库，它简化了依赖注入的实现。

在TodoApplication中，我们只需添加@HiltAndroidApp注解：

@HiltAndroidApp
class TodoApplication : Application()

然后在需要依赖的地方使用@Inject注解，如ViewModel的构造函数：

@HiltViewModel
class TasksViewModel @Inject constructor(
    private val taskRepository: TaskRepository,
    private val savedStateHandle: SavedStateHandle
) : ViewModel() { ... }

Hilt会自动处理依赖的创建和提供，大大简化了代码，同时提高了可测试性。

关键技术点解析

状态管理

重构后的项目采用了单向数据流的模式管理状态，主要通过以下组件实现：

StateFlow：用于在ViewModel中持有和发射状态
UiState类：如TasksUiState，封装UI所需的所有数据
collectAsStateWithLifecycle：在Compose中观察状态变化

这种模式使得状态变化可预测，便于调试和测试。

数据转换

为了保持各层之间的独立性，项目使用了数据模型转换：

// 在ModelMappingExt.kt中定义的转换函数
fun Task.toLocal() = LocalTask(
    id = id,
    title = title,
    description = description,
    isCompleted = isCompleted,
    createdAt = createdAt
)

fun LocalTask.toExternal() = Task(
    id = id,
    title = title,
    description = description,
    isCompleted = isCompleted,
    createdAt = createdAt
)

这些转换函数确保了不同层可以使用最适合自己的数据模型，同时保持数据一致性。

异步操作处理

项目使用Kotlin协程和Flow处理异步操作：

override fun getTasksStream(): Flow<List<Task>> {
    return localDataSource.observeAll().map { tasks ->
        withContext(dispatcher) {
            tasks.toExternal()
        }
    }
}

这种方式比传统的AsyncTask或Handler更加简洁、安全，且不易出错。

重构效果与收益

通过以上重构，项目获得了以下收益：

代码可读性提高：清晰的架构和命名使新开发者能快速理解项目
可维护性增强：模块化设计使得修改功能时影响范围更小
可测试性提高：依赖注入和关注点分离使单元测试更容易编写
开发效率提升：明确的代码组织减少了开发决策负担

总结与展望

Android Architecture Samples项目的重构展示了现代Android架构的最佳实践。通过采用MVVM架构、Jetpack组件和依赖注入，项目从臃肿变得清晰，从难以维护变得易于扩展。

这些重构技巧不仅适用于示例项目，也可以应用到实际开发中。关键是要记住：

遵循单一职责原则，每个组件只做一件事
注重分离关注点，避免组件承担过多责任
使用合适的架构模式和工具简化开发

随着Android开发技术的不断发展，我们还可以进一步探索：

更精细化的状态管理，如使用StateFlow和SharedFlow
更高效的数据同步策略，实现真正的离线优先
采用Compose Multiplatform实现跨平台开发

希望本文介绍的重构经验能帮助你改善自己的Android项目架构，编写出更高质量的代码。

Android Architecture Samples代码重构：从臃肿到清晰的转变