当前位置：首页 > news >正文

现代化Android开发：Compose提示信息的最佳封装方案

news 来源：原创 2025/4/28 10:44:48

在 Android 开发中，良好的用户反馈机制至关重要。Jetpack Compose 提供了现代化的 UI 构建方式，但提示信息(Toast/Snackbar)的管理往往显得分散。本文将介绍如何优雅地封装提示信息，提升代码可维护性。

一、基础封装方案

1. 简单 Snackbar 封装

@Composable
fun SnackbarHelper(hostState: SnackbarHostState,message: String?,duration: SnackbarDuration = SnackbarDuration.Short,actionLabel: String? = null,onAction: (() -> Unit)? = null,onDismiss: () -> Unit = {}
) {val scope = rememberCoroutineScope()LaunchedEffect(message) {message?.let {hostState.showSnackbar(message = it,duration = duration,actionLabel = actionLabel).also { result ->if (result == SnackbarResult.ActionPerformed) {onAction?.invoke()}}onDismiss()}}
}

2. 简单 Toast 封装

@Composable
fun ToastHelper(message: String?) {val context = LocalContext.currentLaunchedEffect(message) {message?.let {Toast.makeText(context, it, Toast.LENGTH_SHORT).show()}}
}

二、进阶状态管理方案

1. 消息状态模型

sealed class MessageState {object Idle : MessageState()data class Snackbar(val message: String,val duration: SnackbarDuration = SnackbarDuration.Short,val action: SnackbarAction? = null) : MessageState()data class Toast(val message: String) : MessageState()
}data class SnackbarAction(val label: String,val onClick: () -> Unit,val withDismiss: Boolean = true
)

2. 消息管理器 ViewModel

class MessageManager : ViewModel() {private val _messageState = mutableStateOf<MessageState>(MessageState.Idle)val messageState: State<MessageState> = _messageStatefun showSnackbar(message: String,duration: SnackbarDuration = SnackbarDuration.Short,action: SnackbarAction? = null) {_messageState.value = MessageState.Snackbar(message, duration, action)}fun showToast(message: String) {_messageState.value = MessageState.Toast(message)}fun reset() {_messageState.value = MessageState.Idle}
}

3. 消息处理器组件

@Composable
fun MessageHandler(state: MessageState,snackbarHostState: SnackbarHostState,onMessageShown: () -> Unit
) {val context = LocalContext.currentLaunchedEffect(state) {when (state) {is MessageState.Snackbar -> {val result = snackbarHostState.showSnackbar(message = state.message,duration = state.duration,actionLabel = state.action?.label)if (result == SnackbarResult.ActionPerformed) {state.action?.onClick?.invoke()}if (state.action?.withDismiss != false) {onMessageShown()}}is MessageState.Toast -> {Toast.makeText(context, state.message, Toast.LENGTH_SHORT).show()onMessageShown()}MessageState.Idle -> Unit}}
}

三、完整使用示例

1. 项目级封装

@Composable
fun MessageScaffold(messageManager: MessageManager = viewModel(),content: @Composable (PaddingValues) -> Unit
) {val snackbarHostState = remember { SnackbarHostState() }Scaffold(snackbarHost = { SnackbarHost(hostState = snackbarHostState) }) { padding ->Box(modifier = Modifier.fillMaxSize()) {content(padding)MessageHandler(state = messageManager.messageState.value,snackbarHostState = snackbarHostState,onMessageShown = { messageManager.reset() })}}
}

2. 具体页面使用

@Composable
fun ProductDetailScreen() {val messageManager: MessageManager = viewModel()MessageScaffold {Column(modifier = Modifier.padding(it)) {// 页面内容...Button(onClick = {messageManager.showSnackbar(message = "商品已加入购物车",action = SnackbarAction(label = "查看",onClick = { /* 导航到购物车 */ }))}) {Text("加入购物车")}Button(onClick = {messageManager.showToast("收藏成功")}) {Text("收藏商品")}}}
}

四、高级功能扩展

1. 消息队列支持

class QueuedMessageManager : ViewModel() {private val _messageQueue = mutableStateListOf<MessageState>()private var isProcessing = falsefun sendMessage(message: MessageState) {_messageQueue.add(message)processNext()}private fun processNext() {if (isProcessing || _messageQueue.isEmpty()) returnisProcessing = true_currentMessage.value = _messageQueue.removeAt(0)}fun onMessageProcessed() {isProcessing = falseprocessNext()}// 其余实现与基础MessageManager类似...
}

2. 自动消失控制

fun MessageManager.showTimedSnackbar(message: String,durationMillis: Long = 3000,action: SnackbarAction? = null
) {showSnackbar(message = message,duration = if (action != null) SnackbarDuration.Indefinite else SnackbarDuration.Short,action = action)if (action == null) {viewModelScope.launch {delay(durationMillis)reset()}}
}