
















之前研究那么久 KMP…但是直到现在也没写什么 demo 项目,这次因为身体原因刚好出不去,唉,正好有时间探索这个了。
[!NOTE]
目前只是个 demo ,之后我有时间有精力会慢慢添加功能
项目地址:https://github.com/grtsinry43/PureFlow
整个项目其实就写了四天,不过因为几乎 90% 的时间都在写代码,并且现在有 claude code 能干一点脏活累活,所以说自己写好重要部分就行。
它基于 Kotlin Multiplatform 和 Compose Multiplatform 技术栈,一套代码,同时支持 Android、iOS、macOS、Windows、Linux 甚至 Web 平台。
原本我计划用 ovCompose 跨到 HarmonyOS 的,但是没有 UI 库,先这样吧。
Kotlin Multiplatform 和 Compose Multiplatform 无疑是项目首选,实现了几乎全栈 Kotlin,从 UI 到业务逻辑,甚至服务端和数据库交互,带来的是开发者开发效率提升和心智统一。
Kotlin Multiplatform: 跨平台的核心引擎。Compose Multiplatform: 声明式 UI 的未来,一套代码搞定多端 UI。SQLDelight: 类型安全的 SQL 数据库。Multiplatform Settings: 跨平台配置存储。Ktor Client: JetBrains 自家的 HTTP 客户端,跨平台支持很到位。RSS Parser: 使用 com.prof18.rssparser 开源解析库。Coil: 强大的图片加载和缓存库,多平台版本用起来也很香。StateFlow & SharedFlow: 响应式状态管理的核心,数据流转非常清晰。ViewModel: MVVM 架构模式中的核心组件。Kotlin Coroutines: 异步编程的利器,让复杂任务变得简单。这几乎是一个纯正的 Kotlin 全家桶方案,也是我认为其值得一试的原因所在。
PureFlow 设计成一个典型的模块化架构,就像搭积木一样,每块积木都有明确的功能和边界。
shared 模块 包含了所有平台共享的业务逻辑、数据模型、数据库接口、网络请求封装和 RSS 解析器。它的 build.gradle.kts 配置编译到了各个平台目标:
通过这个配置,共享代码能编译成 Android 的 .jar、iOS 的 .framework、桌面端的 .jar 和 Web 用的 .js 库,真正实现了一套代码,多端运行。其中 generateTypeScriptDefinitions() 为 webApp 模块的 TypeScript 集成铺平了道路,TypeScript 可以直接使用 Kotlin 共享模块定义的接口和数据结构,减少了重复定义。
composeApp 模块:统一的 UI 界面 这里是 Compose Multiplatform 的战场…终于 iOS stable,可以放心去写。它负责所有平台的 UI 渲染。得益于 shared 模块提供的稳定业务逻辑,composeApp 可以专注于 UI 交互和视觉呈现。
isStatic = true 让 ComposeApp 模块在 iOS 上打包成静态框架,便于在 iosApp 中集成。
server 模块:轻量级后端支持(Planned) 虽然 PureFlow 主要是一个客户端应用,但我还是打算用 Ktor 实现一个轻量级后端。它的主要任务是提供 RSS 同步和用户数据管理功能,为将来的云同步、多设备数据一致性打下基础。
数据存储是任何应用的核心,这里选择 SQLDelight 来处理本地数据库。它提供类型安全的 Kotlin API,避免了运行时错误,开发体验直线提升。
项目使用 SQLDelight 配置了数据库:
从项目的 RssDatabase.sq 文件可以看到表设计:
RSS 条目表 (rssItem)
订阅源表 (subscription)
收藏表 (favorite)
这些索引优化了常见查询的性能,比如按订阅源查询文章、按时间排序等操作。
还记得之前说的 expect/actual 吗?(现代 Android 开发探索)
它在这里完美解决了不同平台数据库驱动的差异:
这种分离让共享逻辑无需关心底层实现细节。
PureFlow 的 UI 完全由 Compose Multiplatform 构建,目标是实现真正的“一次编写,多端体验优化”。
从 composeApp/build.gradle.kts 可以看到项目使用的 UI 相关依赖:
项目采用了完整的 Material 3 设计系统,使用 Coil 进行图片加载,KSoup 进行 HTML 解析。
项目包含了完整的主题系统,在 THEME_GUIDE.md 中详细说明了如何使用和自定义主题。支持浅色/深色模式切换,以及 Material Design 3 的动态颜色特性。
(这部分是Claude Code写的)
网络请求选择了 Ktor Client,它的跨平台能力让不同平台复用了 HTTP 客户端的配置。
项目使用了 com.prof18.rssparser 库而不是手动解析:
这种做法的好处是利用了成熟的开源库,避免了重复造轮子,同时保持了代码的简洁性。
shared/build.gradle.kts 为不同平台选择了合适的 HTTP 引擎:
这个没啥说的:Android 使用 Android 引擎,iOS 使用 Darwin 引擎,Desktop 使用 OkHttp 引擎。
项目采用了 Repository 模式来抽象数据源,实际的实现比较直接:
这种实现直接使用 Kotlin 的 Result 类型处理成功/失败状态,并通过 SQLDelight 的 Flow 支持实现响应式数据更新。
项目实现了一个 RssServiceManager 作为核心服务管理器:
这个服务管理器整合了所有核心功能,包括订阅管理、增量更新、定时同步等。
项目采用了简洁的依赖注入方案,基于 expect/actual 模式:
这种方式避免了重型 DI 框架的复杂性,同时保持了清晰的依赖关系。
项目实现了多平台的自动化构建和发布。
package.sh) 项目包含了一个真实的多平台打包脚本,支持:
从 composeApp/build.gradle.kts 可以看到详细的桌面应用打包配置,包括:
GitHub Actions 配置实现了:
这个项目算是一个活生生的案例,证明了在保证代码质量的同时,完全可以实现真正的一次编写、多端运行。
因为时间问题,这里选择了务实写法,使用成熟的第三方库而不是重复造轮子,采用简洁的依赖注入方案而不是重型框架
如果你也对跨平台开发感兴趣,或者正纠结于技术选型,希望这篇文章能为你带来一些启发和帮助。项目展现了现代 Kotlin 生态的强大能力,也让我对跨平台开发的未来充满信心。
此内容由惯性聚合(RSS阅读器)自动聚合整理,仅供阅读参考。 原文来自 — 版权归原作者所有。