Gallery架构设计解析：Clean Architecture在Android应用中的最佳实践-平芜编程栈

Gallery架构设计解析：Clean Architecture在Android应用中的最佳实践

【免费下载链接】ReFraMedia Gallery app for Android made with Jetpack Compose项目地址: https://gitcode.com/gh_mirrors/galler/ReFra

Gallery是一款基于Jetpack Compose开发的Android媒体库应用，采用Clean Architecture架构模式实现了高度解耦的代码结构。本文将深入剖析Gallery如何通过分层设计实现业务逻辑与UI组件的分离，为Android开发者提供可复用的架构设计思路。

Clean Architecture核心思想与项目结构

Clean Architecture强调关注点分离和依赖规则，通过将系统划分为不同层次，确保核心业务逻辑独立于外部框架和实现细节。Gallery项目严格遵循这一原则，主要分为以下层次：

Gallery应用采用Clean Architecture的分层结构示意图

1. 领域层（Domain Layer）

领域层包含应用的核心业务逻辑和实体模型，是整个架构中最稳定的部分。在Gallery项目中，领域层主要由以下组件构成：

实体模型（Entities）：位于app/src/main/kotlin/com/dot/gallery/feature_node/domain/model/目录，如Album.kt、Media.kt等数据类，定义了应用的核心数据结构。
仓库接口（Repository Interfaces）：如MediaRepository.kt，定义了数据操作的契约，不涉及具体实现：

// app/src/main/kotlin/com/dot/gallery/feature_node/domain/repository/MediaRepository.kt interface MediaRepository { fun getMedia(): Flow<Resource<List<UriMedia>>> fun getAlbums(mediaOrder: MediaOrder): Flow<Resource<List<Album>>> suspend fun toggleFavorite( result: ActivityResultLauncher<IntentSenderRequest>, mediaList: List<T>, favorite: Boolean ) // 其他核心业务方法... }

用例（Use Cases）：封装具体业务逻辑，协调多个仓库操作。

2. 数据层（Data Layer）

数据层负责数据的获取和存储，实现领域层定义的仓库接口。Gallery的数据层结构如下：

仓库实现：如MediaRepositoryImpl.kt，实现MediaRepository接口，协调不同数据源：

// app/src/main/kotlin/com/dot/gallery/feature_node/data/repository/MediaRepositoryImpl.kt class MediaRepositoryImpl( private val context: Context, private val workManager: WorkManager, private val database: InternalDatabase, private val keychainHolder: KeychainHolder, private val geocoder: Geocoder?, private val isolatedParser: IsolatedMetadataParser ) : MediaRepository { override fun getMedia(): Flow<Resource<List<UriMedia>>> = MediaFlow( contentResolver = contentResolver, buckedId = MediaStoreBuckets.MEDIA_STORE_BUCKET_TIMELINE.id ).flowData().map { Resource.Success(MediaOrder.Date(OrderType.Descending).sortMedia(it)) }.flowOn(Dispatchers.IO) // 其他实现方法... }

数据源：包括本地数据库（InternalDatabase.kt）和远程数据源，位于app/src/main/kotlin/com/dot/gallery/feature_node/data/data_source/目录。

3. 表现层（Presentation Layer）

表现层负责UI展示和用户交互，主要由ViewModel和Compose UI组件构成：

ViewModel：如AlbumsViewModel.kt，持有UI状态并处理用户交互，通过调用仓库接口获取数据：

// app/src/main/kotlin/com/dot/gallery/feature_node/presentation/albums/AlbumsViewModel.kt @HiltViewModel class AlbumsViewModel @Inject constructor( private val repository: MediaRepository ) : ViewModel() { fun onAlbumClick(navigate: (String) -> Unit): (Album) -> Unit = { album -> navigate(Screen.AlbumViewScreen.route + "?albumId=${album.id}&albumName=${album.label}") } fun toggleAlbumPin(album: Album, isPinned: Boolean = true) { viewModelScope.launch(Dispatchers.IO) { if (isPinned) { repository.insertPinnedAlbum(PinnedAlbum(album.id)) } else { repository.removePinnedAlbum(PinnedAlbum(album.id)) } } } // 其他UI逻辑处理... }

UI组件：使用Jetpack Compose构建，位于app/src/main/kotlin/com/dot/gallery/feature_node/presentation/目录下的各个屏幕和组件。

依赖注入与模块划分

Gallery使用Dagger Hilt实现依赖注入，通过AppModule.kt配置依赖关系，确保各层之间的低耦合：

// app/src/main/kotlin/com/dot/gallery/injection/AppModule.kt @Module @InstallIn(SingletonComponent::class) object AppModule { @Provides @Singleton fun provideMediaRepository( context: Context, workManager: WorkManager, database: InternalDatabase, keychainHolder: KeychainHolder, geocoder: Geocoder?, isolatedParser: IsolatedMetadataParser ): MediaRepository = MediaRepositoryImpl( context, workManager, database, keychainHolder, geocoder, isolatedParser ) // 其他依赖提供方法... }

项目还通过功能模块划分（如core/、feature_node/）进一步实现关注点分离，每个模块内部仍遵循Clean Architecture的分层原则。

实际应用场景与优势

Gallery的架构设计在实际应用中展现出显著优势：

1. 可测试性

领域层与数据层的分离使单元测试变得简单。例如，测试AlbumsViewModel时，可以轻松模拟MediaRepository接口：

class AlbumsViewModelTest { @Mock private lateinit var mockRepository: MediaRepository @InjectMocks private lateinit var viewModel: AlbumsViewModel @Before fun setup() { MockitoAnnotations.initMocks(this) } @Test fun `toggleAlbumPin inserts pinned album when isPinned is true`() = runTest { // Arrange val testAlbum = Album(id = 1, label = "Test Album") // Act viewModel.toggleAlbumPin(testAlbum, true) // Assert verify(mockRepository).insertPinnedAlbum(PinnedAlbum(1)) } }

2. 维护性与扩展性

分层架构使代码维护和功能扩展更加高效。例如，添加新的媒体分类功能时，只需：

在领域层添加新的分类模型和仓库接口方法
在数据层实现新的数据库操作
在表现层添加对应的ViewModel方法和UI组件

3. 关注点分离

通过严格的分层，业务逻辑、数据处理和UI展示各自独立。例如，媒体加密功能集中在core/decryption/目录，不会与UI代码混杂：

// app/src/main/kotlin/com/dot/gallery/core/decryption/DecryptManager.kt class DecryptManager @Inject constructor( private val keychainHolder: KeychainHolder, private val context: Context ) { suspend fun decryptFile(vault: Vault, file: File): InputStream { // 加密逻辑实现... } // 其他加密相关方法... }