2025年如何创建Compose Multiplatform（CMM）跨端UI组件库？

一、项目初始化 #

• 直接使用JetBrains官方提供的Multiplatform Library模板创建项目，创建时勾选iOS、Android、Desktop（JVM）三个目标平台，确保使用2025年最新稳定版模板。
• 在根目录build.gradle.kts中统一配置Compose Multiplatform版本，共享模块默认已划分commonMain（通用代码）、iosMain、androidMain、desktopMain（平台专属代码）目录结构，无需手动调整。

二、通用UI组件开发 #

• 核心UI逻辑优先放在commonMain中编写，比如按钮、卡片、列表这类无平台依赖的组件，确保跨平台外观和行为一致。
• 用expect/actual机制处理平台差异：在commonMain中定义expect函数/类，比如expect fun showToast(message: String)，再在各平台的*Main模块中实现actual方法，调用原生Toast（Android）、UIAlertController（iOS）、Desktop弹窗。
• 状态管理遵循Compose原生规范，用MutableState、StateFlow管理组件内部状态，避免引入过多第三方库增加复杂度。

三、平台适配细节 #

iOS端适配 #

• 统一控件样式：Compose for iOS的字体、间距默认与Android不同，可通过LocalTypography、LocalDensity配置全局样式，对齐跨平台视觉效果。
• 处理键盘交互：用SoftwareKeyboardController监听键盘弹出/收起事件，调整布局避免被遮挡。
• 封装原生能力：对于iOS特有的交互（比如长按菜单、触觉反馈），通过actual方法调用UIKit原生API。

Desktop端适配 #

• 窗口配置：在desktopMain的启动代码中设置窗口最小尺寸、高DPI适配策略，支持窗口缩放时的UI自适应。
• 桌面专属交互：用Modifier.onHover实现鼠标悬停效果，Modifier.contextMenu添加右键菜单，匹配桌面端用户操作习惯。

Android端适配 #

• 屏幕适配：用LocalConfiguration获取屏幕尺寸、密度，结合ConstraintLayout实现多屏幕适配。
• 系统主题兼容：遵循Android暗黑模式、动态色彩规范，用LocalContentColor、LocalTheme同步系统主题变化。

四、构建与发布 #

• 本地验证：分别在Android Studio模拟器、Xcode模拟器、Desktop端运行组件示例，验证交互和外观一致性。
• 打包配置：
  • Android：配置maven-publish插件，生成AAR包，可上传到本地Maven或私有仓库供其他Android项目依赖。
  • iOS：生成XCFramework包，通过CocoaPods发布，或直接提供XCFramework文件给iOS项目手动引入。
  • Desktop：发布JAR包到Maven仓库，支持Gradle依赖声明。
• 版本管理：采用语义化版本（SemVer），确保三个平台的组件库版本号完全一致，避免依赖冲突。

五、测试方案 #

• 通用UI测试：在commonTest中编写Compose UI测试，复用测试代码验证跨平台组件的状态变化、交互逻辑，比如按钮点击后的状态切换。
• 平台特定测试：在各平台的测试模块中编写原生交互测试，比如iOS的键盘弹出测试、Desktop的右键菜单功能测试。

内容的提问来源于stack exchange，提问作者Neeraj Kumar