【Jetpack Compose进阶学与练】第20课 KMP Compose‑Multiplatform基础；一套UI跨Android、桌面

前言前面1‑19课学习的是Android平台原生Jetpack Compose只能运行在安卓手机。Compose‑MultiplatformC‑MP基于KMP(Kotlin Multiplatform)同一套Compose UI代码可以编译运行Android、Windows/macOS/Linux桌面iOS尚处于逐步完善。本节课区分原生Jetpack‑Compose 和 Compose‑Multiplatform基础工程结构共享模块简单HelloWorld。知识点清单Jetpack Compose(Android专属) vs Compose‑Multiplatform(KMP跨平台)KMP工程结构shared共享模块 各平台独立模块(android、desktop)expect‑actual 声明‑实际用来处理平台特定代码共享模块编写跨平台UI桌面入口main函数Android的Activity入口简单HelloWorld示例环境前置IDEAndroid Studio安装KMP插件JDK17Gradle版本尽量新。完整示例源码/** * shared 共享模块‑跨平台UI代码android、desktop都复用这部分 */importandroidx.compose.foundation.layout.Arrangementimportandroidx.compose.foundation.layout.Columnimportandroidx.compose.foundation.layout.fillMaxSizeimportandroidx.compose.material3.Buttonimportandroidx.compose.material3.Textimportandroidx.compose.runtime.Composableimportandroidx.compose.ui.Alignmentimportandroidx.compose.ui.ModifierComposablefunSharedMainScreen(){Column(modifierModifier.fillMaxSize(),verticalArrangementArrangement.Center,horizontalAlignmentAlignment.CenterHorizontally){Text(textCompose‑Multiplatform 跨平台演示)Button(onClick{}){Text(通用按钮)}}}/** * desktop桌面端入口独立main函数没有Activity */funmain(){androidx.compose.ui.window.application{androidx.compose.ui.window.Window(onCloseRequest::exitApplication){SharedMainScreen()}}}/** * Android端入口 Activityandroid模块 */importandroid.os.Bundleimportandroidx.activity.ComponentActivityimportandroidx.activity.compose.setContentclassAndroidMainActivity:ComponentActivity(){overridefunonCreate(savedInstanceState:Bundle?){super.onCreate(savedInstanceState)setContent{SharedMainScreen()}}}/** * expect‑actual平台差异化代码示例 */expectfungetPlatformName():String//android实现(android源集)actualfungetPlatformName():String{returnAndroid}//desktop实现(desktop源集)actualfungetPlatformName():String{returnDesktop}逐行解读Jetpack‑Compose VS Compose‑MultiplatformJetpack ComposeAndroid专属只能跑安卓手机依赖Android FrameworkAPI由Google Android团队维护。Compose‑MultiplatformKMP跨平台UI渲染层独立一套Compose声明式UI编译输出Android App、桌面exe/dmgiOS还在持续完善⚠️注意不是写一次就所有平台完全适配依然会存在平台差异平台特定逻辑需要expect‑actual。工程模块结构shared 共享模块存放大部分Compose UI、业务逻辑这部分代码会被Android模块和Desktop模块同时引用androidApp 安卓应用模块只保留Activity直接复用shared里面的Composable页面desktopApp 桌面应用模块入口是普通fun main()没有Activity没有Android生命周期使用Window创建应用窗口。expect‑actual声明‑实际当业务需要调用平台独有的能力比如读取Android权限Windows读取本地文件iOS通知先在shared的common源集写 expect fun xxx() 做抽象声明然后分别在android、desktop源集编写 actual fun xxx() 提供对应平台的实现。common共享代码就可以调用这个函数编译期会自动链接对应平台的实现。expect‑actual是KMP解决平台差异化的核心机制。桌面端入口 application{}与Window{}桌面端没有Activity application {} 代表整个桌面应用程序 Window{} 代表一个窗口可以打开多个窗口 exitApplication() 关闭整个程序。资源处理痛点图片、字符串资源C‑MP现在有统一资源方案旧项目经常需要分别维护各平台资源新项目优先使用新版gradle的KMP资源管理。容易踩坑❌误以为KMP写一套代码之后所有平台不用做任何适配UI控件行为、系统权限、文件路径各个平台都不一样平台相关逻辑仍然要用expect‑actual隔离。❌ 在common共享代码里面直接调用Android SDKContext、Toastcommon源集看不到Android框架API编译报错必须抽象之后交给平台层actual实现。❌ 直接把原生Android Jetpack Compose项目简单改一改就当成C‑MP工程需要重新搭建KMP模块结构。❌ 桌面端照搬Android的Activity生命周期桌面没有Activity窗口生命周期自己管理。✅ shared模块放通用UIandroidApp、desktopApp作为外壳expect‑actual隔离平台独有逻辑桌面入口mainapplicationWindow。多元化习题练习习题1【基础‑改错题】直接在KMP的common共享代码里面调用Android的Toast为什么编译报错答案common共享源集不依赖Android SDK看不到Android平台API不能直接调用需要用expect声明接口Android模块使用actual完成平台实现。解读共享层只写跨平台通用逻辑平台能力通过expect‑actual向外抽象。习题2【基础‑代码修改题】common里面声明一个获取操作系统版本名称的expect函数只写expect声明答案expectfungetOsVersionName():String解读之后分别在android、desktop源集编写actual实现。习题3【进阶‑补充代码题】desktop端Compose‑Multiplatform如何关闭整个桌面应用答案调用 exitApplication() 该函数需要放在application作用域内一般写在窗口关闭回调onCloseRequest。解读桌面没有finish()使用exitApplication退出进程。习题4【综合‑逻辑应用题】KMP Compose‑Multiplatform项目为什么要拆分成shared共享模块 androidApp、desktopApp外壳模块答案UI与业务尽量全部放在shared实现最大程度复用androidApp与desktopApp仅仅作为各平台薄薄的外壳负责提供平台入口、平台特定实现后续新增iOS目标时只需要新增一层外壳模块尽量不用修改shared业务代码。解读分离通用业务与平台外壳是KMP工程的核心思想。习题5【概念简答题】Jetpack Compose(Android原生)与Compose‑Multiplatform最核心区别是什么答案Jetpack Compose深度绑定Android系统框架仅支持AndroidCompose‑Multiplatform基于KMP渲染引擎独立同一套Compose UI可以编译到Android、桌面正在完善iOS但各平台系统能力依然需要expect‑actual做适配。解读二者的Compose语法几乎一样底层渲染和平台绑定程度不一样。本节课知识点总结Jetpack Compose是Android专属Compose‑Multiplatform(KMP)实现跨Android、桌面iOS持续演进二者UI语法基本一致。KMP推荐工程架构shared共享模块存放UI业务androidApp与desktopApp作为平台外壳Android依靠Activity桌面以main函数、applicationWindow作为程序入口。expect‑actual声明‑实际机制用来隔离平台差异化APIcommon层只做抽象各平台源集完成具体实现。不要幻想完全零适配跨平台系统权限、文件、弹窗依然存在平台差异必须针对性处理。新版KMP已经支持统一资源管理新项目优先采用新版资源方案减少多平台资源维护负担。到此【Jetpack Compose基础语法学与练】全套20课完结。