Circuit实战教程：10分钟构建你的第一个Compose应用

Circuit实战教程10分钟构建你的第一个Compose应用【免费下载链接】circuit⚡️ A Compose-driven architecture for Kotlin and Android applications.项目地址: https://gitcode.com/gh_mirrors/cir/circuitCircuit是一个基于Compose驱动的Kotlin和Android应用架构能帮助开发者快速构建现代化、跨平台的应用界面。本教程将带你在10分钟内完成一个简单的邮件应用体验Circuit的核心功能和开发流程。准备工作环境搭建首先确保你的开发环境已配置好Compose。如果从零开始可以按照以下步骤添加Circuit依赖克隆仓库git clone https://gitcode.com/gh_mirrors/cir/circuit在项目的build.gradle.kts中添加核心依赖dependencies { implementation(com.slack.circuit:circuit-foundation:version) }Circuit提供了多种模块化组件包括circuit-runtime核心运行时、circuit-presenter状态管理和circuit-ui界面渲染等完整的依赖说明可参考docs/setup.md。第一步创建Screen组件在Circuit中Screen是应用的导航基本单元通常用数据类表示。我们先创建一个邮件列表界面的InboxScreen// 多平台版本 data object InboxScreen : ScreenAndroid平台还需添加Parcelize注解以支持状态保存Parcelize data object InboxScreen : Screen第二步设计状态与UICircuit采用单向数据流架构状态(State)由Presenter产生并传递给UI渲染。我们先定义邮件列表的状态结构data object InboxScreen : Screen { data class State( val emails: ListEmail, val eventSink: (Event) - Unit ) : CircuitUiState sealed class Event : CircuitUiEvent { data class EmailClicked(val emailId: String) : Event() } }接着实现UI组件使用Compose的LazyColumn展示邮件列表Composable fun Inbox(state: InboxScreen.State, modifier: Modifier Modifier) { Scaffold(topBar { TopAppBar(title { Text(Inbox) }) }) { innerPadding - LazyColumn(modifier Modifier.padding(innerPadding)) { items(state.emails) { email - EmailItem( email email, onClick { state.eventSink(InboxScreen.Event.EmailClicked(email.id)) } ) } } } }邮件列表界面效果如下第三步实现PresenterPresenter负责业务逻辑和状态管理我们创建一个简单的InboxPresenter来提供邮件数据class InboxPresenter( private val navigator: Navigator, private val emailRepository: EmailRepository ) : PresenterInboxScreen.State { Composable override fun present(): InboxScreen.State { val emails by produceState(emptyList()) { value emailRepository.getEmails() } return InboxScreen.State(emails) { event - when (event) { is InboxScreen.Event.EmailClicked - navigator.goTo(DetailScreen(event.emailId)) } } } }第四步配置Circuit实例将Screen、Presenter和UI组件通过Circuit实例关联起来val circuit Circuit.Builder() .addPresenterFactory(InboxPresenter.Factory(emailRepository)) .addUiInboxScreen, InboxScreen.State { state, modifier - Inbox(state, modifier) } .build()第五步添加导航功能Circuit提供了BackStack和Navigator实现页面导航。在应用入口处设置导航val backStack rememberSaveableBackStack(root InboxScreen) val navigator rememberCircuitNavigator(backStack) { finish() } CircuitCompositionLocals(circuit) { NavigableCircuitContent(navigator navigator, backStack backStack) }添加邮件详情页后点击列表项即可导航到详情界面完整代码结构完成的项目结构应包含以下核心文件InboxScreen.kt定义列表界面的Screen、State和UIDetailScreen.kt定义详情界面的Screen、State和UIInboxPresenter.kt处理列表页业务逻辑DetailPresenter.kt处理详情页业务逻辑MainActivity.kt应用入口配置Circuit和导航运行应用根据平台不同使用相应的命令运行应用Android./gradlew :samples:tutorial:installDebug桌面端./gradlew :samples:tutorial:run总结通过本教程你已掌握Circuit的核心概念使用Screen定义导航单元通过State和Event实现单向数据流用Presenter处理业务逻辑配置Circuit连接各组件使用Navigator实现页面导航Circuit还提供了状态保留、共享元素过渡、测试工具等高级功能更多内容可参考官方文档docs/index.md。现在就开始用Circuit构建你的下一个Compose应用吧 【免费下载链接】circuit⚡️ A Compose-driven architecture for Kotlin and Android applications.项目地址: https://gitcode.com/gh_mirrors/cir/circuit创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考