基于Compose桌面的Material You风格ADB文件管理器实现

前言

在Android开发过程中，我们经常需要与设备进行文件交互。虽然Android Studio提供了Device File Explorer，但其界面设计和交互体验一直不尽如人意。为解决这一问题，我开发了一款基于Jetpack Compose桌面的ADB文件管理器，它采用现代化的Material You设计，提供流畅的跨平台文件管理体验。本文将分享这个项目的技术实现思路、架构设计和一些关键功能的实现细节。

项目概览

ADB File Manager是一款使用Kotlin和Compose Desktop开发的跨平台文件管理工具，通过ADB连接实现对Android设备的文件操作。主要特点包括：

Material You设计风格
跨平台支持(Windows/macOS/Linux)
路径导航与目录跳转
文件创建与编辑
文件上传与下载
深色/浅色主题切换

技术栈选择

为什么选择Compose Desktop？

Jetpack Compose是Google推出的现代化UI工具包，而Compose Desktop则是JetBrains基于此开发的桌面应用框架。选择它的原因主要有：

统一的开发体验 - 与Android端Compose使用相同的声明式UI范式
跨平台能力 - 一套代码运行在Windows/macOS/Linux
丰富的组件库 - Material 3组件支持和丰富的动画效果
Kotlin协程支持 - 简化异步操作处理

核心技术栈

Kotlin - 主要开发语言
Compose Desktop - UI框架
Kotlin Coroutines - 异步操作处理
Kotlin Flow - 响应式数据流
ADB命令行工具 - 与Android设备通信

架构设计

项目采用MVVM架构模式，清晰分离UI、业务逻辑和数据层：

js 复制代码

app
 ├── model      // 数据模型
 ├── runtime    // ADB命令执行环境
 ├── view       // Compose UI组件
 │   ├── components  // 可复用UI组件 
 │   └── theme       // 主题定义
 ├── viewmodel  // 视图模型
 └── utils      // 工具类

关键组件

AdbDevicePoller - 管理ADB设备连接和命令执行
FileManagerViewModel - 处理文件操作相关的业务逻辑
FileManagerScreen - 主界面UI实现
主题系统 - 实现深色/浅色主题切换

核心功能实现

ADB命令执行

与Android设备的所有交互都通过执行ADB命令实现。我封装了一个AdbDevicePoller类来管理设备连接和命令执行：

kotlin 复制代码

class AdbDevicePoller(
    private val adb: Adb,
    private val coroutineScope: CoroutineScope
) {
    // 执行ADB命令并返回结果
    fun exec(command: String, callback: (List<String>) -> Unit) {
        coroutineScope.launch {
            val result = adb.exec(command)
            callback(result)
        }
    }
    
    // 获取连接的设备
    fun getDevices(callback: (List<Device>) -> Unit) {
        coroutineScope.launch {
            val devices = adb.getDevices()
            callback(devices)
        }
    }
}

文件列表实现

文件列表使用Compose的LazyColumn实现，结合Flow实现响应式数据更新：

kotlin 复制代码

@Composable
fun FileList(
    files: List<FileItem>,
    onFileClick: (FileItem) -> Unit,
    onFileAction: (FileItem, FileAction) -> Unit
) {
    LazyColumn(
        modifier = Modifier.fillMaxSize(),
        verticalArrangement = Arrangement.spacedBy(4.dp)
    ) {
        items(
            items = files,
            key = { it.fileName }
        ) { file ->
            FileListItem(
                file = file,
                onFileClick = { onFileClick(file) },
                onFileAction = { action -> onFileAction(file, action) }
            )
        }
    }
}

路径导航与目录跳转

路径导航是一个核心功能，实现了面包屑式的路径导航UI：

kotlin 复制代码

@Composable
fun PathNavigator(
    currentPath: List<String>,
    onPathClick: (Int) -> Unit,
    modifier: Modifier = Modifier
) {
    Row(
        modifier = modifier,
        verticalAlignment = Alignment.CenterVertically
    ) {
        // 根目录
        PathItem(
            name = "根目录",
            isRoot = true,
            onClick = { onPathClick(-1) }
        )
        
        // 路径分隔符
        Text(
            text = "/",
            color = MaterialTheme.colorScheme.onSurfaceVariant,
            style = MaterialTheme.typography.bodySmall
        )
        
        // 路径项
        currentPath.forEachIndexed { index, path ->
            PathItem(
                name = path,
                isRoot = false,
                onClick = { onPathClick(index) }
            )
            
            if (index < currentPath.size - 1) {
                Text(
                    text = "/",
                    color = MaterialTheme.colorScheme.onSurfaceVariant,
                    style = MaterialTheme.typography.bodySmall
                )
            }
        }
    }
}

主题切换实现

主题系统使用Kotlin的单例对象和可观察状态实现：

kotlin 复制代码

object ThemeState {
    // 是否使用深色模式，null表示跟随系统
    val isDarkMode = mutableStateOf<Boolean?>(null)
    
    // 切换到深色模式
    fun setDarkMode() {
        isDarkMode.value = true
    }
    
    // 切换到浅色模式
    fun setLightMode() {
        isDarkMode.value = false
    }
    
    // 跟随系统设置
    fun useSystemTheme() {
        isDarkMode.value = null
    }
    
    // 获取当前是否为深色模式
    fun isDark(): Boolean {
        val systemDark = isSystemInDarkTheme()
        return isDarkMode.value ?: systemDark
    }
}

项目优化

性能优化

为了提升应用性能和减小包体积，项目采用了以下优化措施：

ProGuard配置 - 启用代码混淆和优化
减少JDK模块依赖 - 只包含必要的JDK模块
懒加载组件 - 使用Compose的懒加载特性

用户体验优化

平滑动画 - 添加过渡动画提升用户体验
错误处理 - 提供友好的错误提示
响应式UI - 使用Flow实现响应式数据更新

总结与思考

通过这个项目，我深入体验了Compose Desktop的开发流程和特性。相比传统的Swing或JavaFX，Compose Desktop在开发效率和UI表现力方面有明显优势。同时，我也发现了一些挑战：

文档资源有限 - Compose Desktop的文档和示例相对Android端较少
跨平台适配 - 不同平台间存在细微差异需要处理
打包体积 - 初始打包体积较大，需要进行优化

未来，我计划继续完善这个项目，添加更多功能，如文件搜索、权限管理、拖放上传等，同时进一步优化性能和用户体验。

项目开源地址

如果你对这个项目感兴趣，欢迎访问GitHub仓库了解更多详情或参与贡献：github.com/wkbin/AdbFi...

希望这篇文章对你有所帮助，如有任何问题或建议，欢迎在评论区留言或在GitHub上提交Issue。