KMP/CMP 鸿蒙社区 · 鸿蒙跨端实战项目 · 会议预约源码与 README
前言
在平板上填会议预约,前几个字段通常不会暴露问题。选择时间、切换会议室时,页面占着整个窗口,底部按钮也一直在。真正容易卡住的是备注。用户刚把光标放到最后一个字段,输入法占去一截屏幕。要是窗口里还照着弹出前的高度摆放控件,备注和确认按钮就可能一起落在键盘下面。
同样一份表单,在全屏里只是需要向上滚一点,放到悬浮窄窗里却可能只剩几行。此时把整个页面平移,容易连标题和操作区一起推走。给底部再补一段固定留白,也会让没有键盘时的页面变得空荡。实际要解决的是两件具体的事。第一,输入框获焦后还看得见自己正在编辑的位置。第二,填完以后能够从原来的页面提交,无须为找到按钮而先退出输入。
示例由 ArkUI 托管 Compose Multiplatform 页面。鸿蒙宿主负责让出被固定软键盘占用的区域,Compose 根据收到的新布局约束重新测量表单,把获焦字段滚进可见位置。预约示例只有本地确认页,关注的是窗口、输入和提交的连续操作。
先看最后一栏
在 MatePad Edge 上分别以全屏和悬浮窗打开预约页。两次都从主题输入切到备注,收起键盘后保留原文,再打开键盘,从页面底栏直接提交。确认页显示刚才输入的主题与备注。

打开键盘后,从备注框直接点「确认预约」。如果触摸确实落在应用底栏,确认页会显示刚才输入的备注。验证时同时看按钮位置和提交结果,才能确认键盘展开后这条操作仍然能走完。
从编辑备注到保存预约

另一组动作是先收起键盘。这个分支要看两件事,备注是否仍在,按钮是否随可用空间恢复。收起键盘后如果备注变成空白,说明编辑状态依附在了临时布局节点上。要是按钮留在先前的高度,页面可能把键盘高度缓存成了固定边距。两种错误的表现不同,录屏也应把这两个阶段拍进去。



验证时保留了同一条备注,方便确认截图前后是一次连贯操作。只在开头拍到输入框、结尾拍到一个空白确认页,中间若发生过切换焦点或重开页面,很难知道是哪次输入触发了提交。因此先填主题,再打开备注,输入一小段可辨认的文字。收起键盘后回看同一个字段,再次打开键盘并从按钮提交,最后在确认页核对主题和备注。路径中的每个检查都围绕用户实际要完成的一件事。
全屏与悬浮窗也要分开记录。全屏时,表单通常还能同时显示多个字段。悬浮窗里只剩下局部内容时,界面必须仍能从地点选项滚到备注,再回到前面的字段。前者比较容易把问题隐藏在多余空间里。后者暴露的是布局缩小后,哪些内容真的可以操作,哪些只是计算上还有一个位置。
页面为什么会被挡住
键盘弹出不会把一个窗口变成另一种设备。表单仍在原来的窗口内,只是当前可分配给内容的高度发生了变化。若界面用启动时读取的物理屏幕高度,键盘出现以后这个数也不会变。悬浮窗的窗口边界和物理屏幕边界本来就不一致,用整屏高度算表单可见范围,在键盘弹出之前就可能已经算错。
也不能仅凭键盘回调的高度直接决定某个组件移动多少。该回调给的是键盘占用高度,可用于确认输入法出现或收起。应用真正能用的空间还取决于窗口位置、容器收到的约束和系统当前采用的避让方式。宿主若已经缩短视口,Compose 又用同一键盘高度追加底部内边距,布局就会被压两次。第一次让出系统占用区域,第二次却从剩余的区域里再挖掉一块。
这里选择宿主压缩模式。ArkUI 页面出现时设置 KeyboardAvoidMode.RESIZE,让其子内容按新高度重新布局。离开页面时恢复之前的模式,因为它作用在当前窗口上。若以后把这个示例接进已有导航栈,可以在不同页面采用不同策略,但要明确谁修改模式、离开时谁恢复,避免一个表单影响后续页面。
上抬模式依赖当前光标的位置,适合只需把正在输入的内容露出来的场景。它有可能让备注可见,却没有为页面底部的操作区重新分配高度。对本例而言,提交与输入应当在同一次窗口布局中成立,因此采用压缩模式。选择这一模式以后,应该再检查页面上的图片、标签和操作区有没有固定高度。若加起来已经超过父容器给出的高度,即便宿主正确压缩,子树也可能没有可用的滚动区域。
宿主与 CMP 的连接位置也有影响。示例将 Compose 容器挂在被压缩页面的子树中,并让它填满父容器。如果宿主在外层缓存了初始高度,再将那个高度传给容器,压缩后的约束就送不到共享布局。排查顺序可以从外往内走,先确认窗口层启用压缩,再确认 Compose 容器的可用高度是否改变,最后才检查字段有没有滚到正确位置。先从字段组件反复调偏移,往往会掩盖前面两层的问题。

华为文档说明了上抬与压缩模式的差别,也有底部操作区随压缩布局调整的示例。文中采用的是固定态系统软键盘。悬浮输入法可能只覆盖屏幕的一小块,并不等同于底部固定键盘。要扩展到浮动或拆分键盘,需要实测其位置和遮挡方式,再决定如何定位焦点。 软键盘布局适配 · 窗口常见问题
滚动范围与确认按钮
Compose 页面从上到下分成标题、可滚动的表单和确认区。表单所在的 Column 用 weight(1f) 占用剩余高度,确认区是它的兄弟节点。这样父布局先为标题和确认区留出所需空间,再把剩下的高度给滚动容器。无论键盘是否出现,按钮都通过同一套布局规则排在当前视口底部。
如果把确认按钮也放进滚动容器,这种结构也可以做,但在备注滚到可见位置时,按钮可能仍在下一屏。用户需要继续滚动,或者用输入法上的完成键来触发另一条提交路径。这个示例要求键盘打开时同样能触摸提交,所以把按钮移出了滚动区。这个取舍应由操作需求决定。比如一份很短的调查问卷,按钮只在末尾偶尔被点到,就未必需要始终占据底栏。
选择可滚动容器还有一个原因。悬浮窄窗的高度可能比全屏小很多,即使没有键盘,也不一定能同时容纳所有字段。滚动容器应在任何窗口形态下成立,键盘只让它更短。若进入键盘状态才用条件分支换成另一棵滚动布局,旧布局里的滚动位置、焦点和输入值就容易一起消失。
界面把会议地点和时段作为明确的选项,备注仍是多行输入。空间不足时,允许这些字段离开可视区域,并保留用户滚回去查看的能力。底栏保持固定的触摸高度,没有为了放进更短的窗口而把按钮缩成很薄的一条。最小窗口的验收要同时看编辑区能否滚动,以及按钮是否仍能可靠点按。
这里的滚动区也可以换成惰性列表,适合字段很多的表单。不过切换实现以后,定位方法也要跟着核对。尚未创建的列表项没有可直接定位的节点,需要先滚到该项所在的位置,再把焦点交给实际输入组件。这份示例的字段数量固定,直接保留在一个普通滚动容器里就能覆盖窗口压缩和焦点重测。它把复现需要的变量控制在宿主大小、焦点和键盘三处。
底栏的显示范围还关系到校验。主题为空时,确认按钮可以看见,但按下去不会提交。测试人员若只填备注,很容易把禁用误认为被键盘截断。把主题填好后观察底栏是否变为可用,再带着键盘点击。若点击没有响应,还可以看按下时焦点是否变化、确认页是否出现,以及同样的触点在键盘收起时能否正常触发。通过这些现象能区分表单校验、触点位置和提交状态三个问题。
什么时候滚到焦点
触摸备注时,焦点事件往往比键盘布局更早发生。若在这个回调里只滚一次,程序看到的还是键盘弹出前的大视口,可能认为备注已经完全可见。稍后宿主压缩了内容,备注的下半部分就可能消失。解决这个时序差的关键,是在获焦目标变化时处理一次,也在滚动容器重新测量后用新高度检查一次。
示例给主题和备注各一个 BringIntoViewRequester,同时在可滚动容器上记录测量后的高度。协程观察当前焦点与容器高度。焦点移动时会请求让对应控件可见,键盘使视口变小时也会再次请求。这里的高度只用来判断布局发生了变化,代码不会拿这个高度去硬算某个滚动目标,也不会把键盘回调中的像素值直接写进以 dp 为单位的内边距。

请求定位的是实际输入框。给外层整组表单加定位目标,在空间特别小时可能只看到标题,真正要编辑的光标却留在下面。目标也不能设置成备注以外的说明文字。定位范围需要和用户正在操作的组件一致,裁剪、布局和父滚动区的计算才有意义。
另一个容易被忽略的点是重新获焦。用户从主题切到备注时,旧组件的失焦事件与新组件的获焦事件都会到达。更新焦点状态时只允许原来的字段清除自己,避免旧字段随后发出的失焦把新字段的状态覆盖。页面进入确认态时,不再发起定位请求。这可以防止表单节点从视图树移除后还执行上一次的定位动作。
多行输入的边界和单行字段不同。备注区域显示固定范围内的行数,更多文本由输入组件自行滚动。页面级的滚动负责把整个备注框放进当前视口,输入组件内部的滚动负责露出长文本的光标。极小窗口里,若备注框本身比剩余区域还高,无法保证整个框完全可见。实际扩展时应检查产品支持的最小窗口尺寸,并在该尺寸下验证键盘打开后的可编辑区域。
用户也可能在键盘显示过程中手动滚动。布局变化触发的位置请求应该以当前焦点为准,不应反复把页面强行拉回一个已经失焦的字段。这里在焦点或视口改变时才提出请求。用户输入普通字符时,页面不用跟着每个字符重新滚动。若产品确实要求在光标跨行后主动调整,可以把光标位置作为另一项触发条件,再验证它与输入组件自身的滚动是否冲突。
同一份表单的字段都有稳定的含义。会议主题不会因为窗口变窄而换成另一个输入组件,备注也不会因为键盘关闭而换一份内容。这样更新视口高度时,只需要让容器重测,已有文字自然留在共享状态里。要保存到数据库或恢复应用进程,需要额外的持久化设计。本文只检查系统键盘和窗口变化期间的输入连续性。
验证时看什么
键盘监听放在 EntryAbility,只打印系统回调中的高度。日志中的非零值表示输入法报告占用空间,零值用于核对收起。页面不会通过这条日志决定自己的边距。读证据时把键盘回调、界面截图、提交后的确认页对在一起。单条日志能说明系统发生了变化,确认页才说明用户的输入和操作成功抵达业务层。
新版在 MatePad Edge 全屏运行时,系统报告键盘高度为 874 像素,确认按钮底边从 2006 移到 1193 像素。切到悬浮窗后,再输入备注并在键盘展开时提交,确认页仍显示刚才输入的内容。宽窗数据用于说明底栏随可用高度上移,窄窗则通过实际点击验证按钮可用。

把按钮与软键盘是否重叠写成一个简单的检查时,可以对比屏幕坐标下的按钮底边与固定键盘上沿。若直接把键盘高度从悬浮窗自身的底边扣掉,容易错把两套坐标混在一起。屏幕高度、窗口位置和按钮位置可能来自不同接口,也可能用了不同单位。这个示例把几何读数作为辅助,再通过实际点击验证。设备形态或输入法布局变了,应重新读取相同环境里的坐标。
收起键盘还需要确认内容有没有被重置。示例的文本、地点和时段保存在 Compose 状态里,窗口大小变化只改变测量结果。点击确认后清除焦点并进入确认页。保持同一个编辑状态对象,也方便扩展服务端提交。若加入真实预约接口,提交成功与否应由服务结果决定,失败后需要能回到原表单继续编辑。
表单标题旁的「收起键盘」在输入框获焦时出现。点按后先请求隐藏输入法,再清除当前焦点,表单值仍留在原来的状态中。这个按钮也方便在录屏里区分主动结束编辑和直接提交。两条操作都不需要重新进入表单,页面可以继续沿用原来的字段和滚动状态。
在代码层,键盘回调只做记录是刻意的分工。读取系统日志的时候可以知道当前报告了多少像素,但换成不同语言输入法、打开候选条或修改键盘大小,数值可能随之变化。硬编码一次测试中看到的高度会让示例过早适配某一种输入法。让窗口继续提供约束,记录的高度就只用于复盘,而不会在换键盘之后成为额外的限制条件。
还有一种情况是系统或外接键盘已经能输入文字,屏幕上却没有出现固定软键盘。这时不应该因为字段获得了焦点,就主动为一个不存在的键盘留空。该页面的布局只依赖实测视口,不会把“字段获焦”直接写成“需要减去固定高度”。外接键盘是否参与、屏幕上是否显示候选条,则要以当前设备设置和实际输入法为准。
复现
真机为华为 MatePad Edge(QXS-W00),HarmonyOS 7.0.0,软件版本 7.0.0.111(SP16C00E111R6P5),API 26。模拟器采用 DevEco Emulator 26.0.0.402 的 Mate X7 配置(PHEMU-FD01,x86_64),HarmonyOS 7.0.0,镜像软件版本 7.0.0.107(SP8DEVC00E999R4P11),API 26。模拟器已安装并打开预约页面,输入法停在首次使用授权。文中的备注输入、键盘避让、提交和测量结果均来自平板真机。


工程根目录中的 Gradle 任务把两个目标架构的动态库和头文件同步给鸿蒙宿主。宿主依赖由 OHPM 安装,再用 Hvigor 组装 HAP。项目使用 DevEco Studio 6.1.1.300 所带的 JBR 21,鸿蒙 SDK 为 API 26。Kotlin/Native OHOS 版本是 2.2.21-1.2.0,Compose Multiplatform OHOS 和宿主依赖版本是 1.9.2-1.2.0。构建命令与目录说明见 README。
调试时先填会议主题,让提交按钮变成可用状态,再进入备注。若按钮一直灰色,应先排除表单校验导致的禁用。若看到输入法但整个页面高度不变,检查宿主是否在 Compose 容器创建前为该窗口启用了压缩,以及外层容器是否依然把自身高度锁为屏幕大小。若按钮已经在键盘上方但备注还不可见,再检查可滚动容器和焦点定位请求。
推荐在窄窗里单独检查一次键盘收起。全屏可见不代表悬浮窗也足够高,悬浮窗的应用区域还可能由系统移动到另一处。在改动窗口尺寸时,应观察表单能否继续滚动,而不假定选中的会议室和文字会自动恢复。排查时从一个变量开始,例如固定窗口形态只切换键盘,记录输入和按钮状态,再测试窗口切换。这样出现故障时容易分辨是输入法、系统布局还是页面状态造成的。
若要移植到已有 CMP 项目,可以先用一张最小表单接入宿主压缩模式,然后把业务表单放到同一个窗口里对比。先移除会随键盘高度变化的额外底部留白,再检查是否还有来自框架或原生容器的避让处理。此时不必改所有页面。只要确认窗口中确实只有一层在处理键盘所占区域,就能沿着当前业务保留需要的滚动和焦点规则。
如果在已有页面里同时用了系统键盘避让、Compose 的窗口边距和弹窗自带的避让,最好把三处的作用范围列出来。先记清哪一处改变宿主约束,哪一处改变容器内边距,哪一处只影响弹窗内容。最常见的检查办法是记录键盘弹出前后滚动区的尺寸,再和底栏高度对照。尺寸正常而点击失败时,转而检查遮挡和触点坐标。尺寸本身过小,则先回头检查是否重复扣减。区分这两种情况可以减少来回改动组件样式的次数。
复测时也可以加入更长的备注。长备注能够发现一个短字符串不容易暴露的问题,即输入区的最后一行有内容,但光标已经滚出编辑区域。建议用几行没有个人信息的示例文字,先检查每一行能否正常输入,再将光标移回中间进行修改。对于生产中的附件、选择器和日期弹窗,也要在各自的窗口形态下单独复测,因为它们可能使用不同的宿主布局。
总结
这份预约表单把软键盘占用的空间交给宿主处理,Compose 页面用重测量后的空间安排滚动与底栏。获焦字段会被带回可见区域,确认按钮始终留在滚动区外。相同的思路也能用在反馈表、会议记录或工单编辑页,先让宿主正确缩小视口,再由共享界面判断当前应当看见的控件。
完整代码
以下列出共享页面、鸿蒙宿主、窗口日志和原生桥接的完整实现。Gradle 配置负责生成并同步双架构产物,工程里的其他资源及模块配置保留在项目目录内。
会议预约页面
composeApp/src/commonMain/kotlin/dev/booking/sample/BookingScreen.kt
package dev.booking.sample
import androidx.compose.foundation.ExperimentalFoundationApi
import androidx.compose.foundation.background
import androidx.compose.foundation.border
import androidx.compose.foundation.layout.*
import androidx.compose.foundation.relocation.BringIntoViewRequester
import androidx.compose.foundation.relocation.bringIntoViewRequester
import androidx.compose.foundation.rememberScrollState
import androidx.compose.foundation.shape.RoundedCornerShape
import androidx.compose.foundation.verticalScroll
import androidx.compose.material3.*
import androidx.compose.runtime.*
import androidx.compose.runtime.saveable.rememberSaveable
import androidx.compose.ui.Alignment
import androidx.compose.ui.Modifier
import androidx.compose.ui.focus.onFocusChanged
import androidx.compose.ui.graphics.Color
import androidx.compose.ui.layout.onSizeChanged
import androidx.compose.ui.platform.LocalFocusManager
import androidx.compose.ui.platform.LocalSoftwareKeyboardController
import androidx.compose.ui.semantics.contentDescription
import androidx.compose.ui.semantics.semantics
import androidx.compose.ui.text.font.FontWeight
import androidx.compose.ui.unit.dp
import androidx.compose.ui.unit.sp
private val Background = Color(0xFFF4F5FB)
private val Ink = Color(0xFF232644)
private val Muted = Color(0xFF5A617E)
private val Rule = Color(0xFFDCE0F0)
private val Indigo = Color(0xFF5143BA)
private val Selected = Color(0xFFEEEBFE)
private val Panel = RoundedCornerShape(18.dp)
private val Rooms = listOf("松间会议室", "栖云会议室")
private val Times = listOf("14:00–14:45", "15:00–15:45")
@OptIn(ExperimentalFoundationApi::class)
@Composable
fun BookingScreen() {
val focusManager = LocalFocusManager.current
val keyboardController = LocalSoftwareKeyboardController.current
var room by rememberSaveable { mutableStateOf(Rooms.first()) }
var time by rememberSaveable { mutableStateOf(Times.first()) }
var subject by rememberSaveable { mutableStateOf("") }
var note by rememberSaveable { mutableStateOf("") }
var submitted by rememberSaveable { mutableStateOf(false) }
var viewportHeight by remember { mutableIntStateOf(0) }
var focusedField by remember { mutableIntStateOf(0) }
val subjectRequester = remember { BringIntoViewRequester() }
val noteRequester = remember { BringIntoViewRequester() }
val scroll = rememberScrollState()
// 宿主改变可用高度后,按新的视口再次定位当前输入框。
LaunchedEffect(viewportHeight, focusedField, submitted) {
if (viewportHeight > 0 && !submitted) {
when (focusedField) {
1 -> subjectRequester.bringIntoView()
2 -> noteRequester.bringIntoView()
}
}
}
MaterialTheme(colorScheme = lightColorScheme(primary = Indigo, onPrimary = Color.White,
surface = Color.White, onSurface = Ink, outline = Rule)) {
Column(Modifier.fillMaxSize().background(Background), horizontalAlignment = Alignment.CenterHorizontally) {
Row(
Modifier.fillMaxWidth().background(Color.White).height(56.dp).padding(horizontal = 18.dp),
verticalAlignment = Alignment.CenterVertically,
horizontalArrangement = Arrangement.SpaceBetween
) {
Text("会议预约", color = Ink, fontSize = 22.sp, fontWeight = FontWeight.Bold)
if (focusedField != 0 && !submitted) {
TextButton(onClick = {
keyboardController?.hide()
focusManager.clearFocus()
}) { Text("收起键盘") }
}
}
HorizontalDivider(color = Rule)
// 底栏与滚动容器是兄弟节点。宿主缩小后,滚动区域先让出底栏的高度。
BoxWithConstraints(
Modifier.weight(1f).widthIn(max = 1040.dp).fillMaxWidth().onSizeChanged { viewportHeight = it.height }
) {
val wide = maxWidth >= 740.dp
val content = Modifier.fillMaxWidth().verticalScroll(scroll)
.padding(horizontal = if (wide) 28.dp else 14.dp, vertical = 16.dp)
if (submitted) {
Column(content, verticalArrangement = Arrangement.spacedBy(14.dp)) {
ScheduleCard(room, time, Modifier.fillMaxWidth())
Column(Modifier.fillMaxWidth().background(Color.White, Panel).padding(18.dp),
verticalArrangement = Arrangement.spacedBy(7.dp)) {
Text("预约已保存", color = Indigo, fontSize = 24.sp, fontWeight = FontWeight.Bold)
Text(subject, color = Ink, fontSize = 19.sp, fontWeight = FontWeight.Medium)
if (note.isNotBlank()) Text(note, color = Muted)
}
}
} else {
val form: @Composable (Modifier) -> Unit = { modifier ->
Column(modifier.background(Color.White, Panel).border(1.dp, Rule, Panel).padding(16.dp),
verticalArrangement = Arrangement.spacedBy(12.dp)) {
Text("预约详情", color = Ink, fontSize = 20.sp, fontWeight = FontWeight.Bold)
ChoiceGroup("会议地点", Rooms, room) { room = it }
ChoiceGroup("可选时段", Times, time) { time = it }
Text("会议主题", fontWeight = FontWeight.SemiBold, color = Ink)
OutlinedTextField(value = subject, onValueChange = { if (it.length <= 48) subject = it },
singleLine = true, placeholder = { Text("例如:产品评审") },
modifier = Modifier.fillMaxWidth().bringIntoViewRequester(subjectRequester)
.onFocusChanged { if (it.isFocused) focusedField = 1 else if (focusedField == 1) focusedField = 0 }
.semantics { contentDescription = "会议主题输入框" })
Text("备注", fontWeight = FontWeight.SemiBold, color = Ink)
OutlinedTextField(value = note, onValueChange = { if (it.length <= 120) note = it },
minLines = 2, maxLines = 3, placeholder = { Text("例如:提前准备投影") },
modifier = Modifier.fillMaxWidth().bringIntoViewRequester(noteRequester)
.onFocusChanged { if (it.isFocused) focusedField = 2 else if (focusedField == 2) focusedField = 0 }
.semantics { contentDescription = "备注输入框" })
}
}
if (wide) {
Row(content, horizontalArrangement = Arrangement.spacedBy(16.dp)) {
ScheduleCard(room, time, Modifier.weight(1f))
form(Modifier.weight(2.2f))
}
} else {
Column(content, verticalArrangement = Arrangement.spacedBy(12.dp)) {
ScheduleCard(room, time, Modifier.fillMaxWidth())
form(Modifier.fillMaxWidth())
}
}
}
}
if (submitted) {
ActionBar("继续编辑", true) { submitted = false }
} else {
ActionBar("确认预约", subject.isNotBlank()) {
keyboardController?.hide()
focusManager.clearFocus()
submitted = true
}
}
}
}
}
@Composable
private fun ScheduleCard(room: String, time: String, modifier: Modifier) {
Column(modifier.background(Selected, Panel).padding(17.dp),
verticalArrangement = Arrangement.spacedBy(10.dp)) {
Row(verticalAlignment = Alignment.CenterVertically, horizontalArrangement = Arrangement.spacedBy(12.dp)) {
Column(Modifier.background(Indigo, RoundedCornerShape(10.dp)).padding(horizontal = 11.dp, vertical = 6.dp),
horizontalAlignment = Alignment.CenterHorizontally) {
Text("11 月", color = Color.White, fontSize = 10.sp)
Text("13", color = Color.White, fontSize = 22.sp, fontWeight = FontWeight.Bold)
}
Column(verticalArrangement = Arrangement.spacedBy(3.dp)) {
Text(room, color = Ink, fontSize = 16.sp, fontWeight = FontWeight.Bold)
Text(time, color = Muted, fontSize = 13.sp)
}
}
Text("45 分钟", color = Indigo, fontSize = 12.sp, fontWeight = FontWeight.SemiBold)
}
}
@Composable
private fun ChoiceGroup(title: String, values: List<String>, current: String, select: (String) -> Unit) {
Column(verticalArrangement = Arrangement.spacedBy(5.dp)) {
Text(title, fontWeight = FontWeight.SemiBold, color = Ink)
Row(Modifier.fillMaxWidth(), horizontalArrangement = Arrangement.spacedBy(7.dp)) {
for (value in values) {
val selected = value == current
val shape = RoundedCornerShape(9.dp)
TextButton(onClick = { select(value) },
modifier = Modifier.weight(1f).border(1.dp, if (selected) Indigo else Rule, shape)
.background(if (selected) Selected else Color.White, shape),
shape = shape, contentPadding = PaddingValues(horizontal = 5.dp, vertical = 5.dp)) {
Text(value, color = if (selected) Indigo else Ink, fontSize = 13.sp,
fontWeight = if (selected) FontWeight.SemiBold else FontWeight.Normal)
}
}
}
}
}
@Composable
private fun ActionBar(label: String, enabled: Boolean, action: () -> Unit) {
Column(Modifier.fillMaxWidth().background(Color.White), horizontalAlignment = Alignment.CenterHorizontally) {
HorizontalDivider(color = Rule)
Button(action, Modifier.widthIn(max = 1040.dp).fillMaxWidth().padding(horizontal = 18.dp, vertical = 6.dp)
.height(42.dp), enabled = enabled, shape = RoundedCornerShape(9.dp)) {
Text(label, fontWeight = FontWeight.SemiBold)
}
}
}
键盘避让的鸿蒙宿主
example/ohos/entry/src/main/ets/pages/Index.ets
import { KeyboardAvoidMode } from '@kit.ArkUI';
import { ArkUIViewController, Compose } from '@cpf-kmp-cmp/compose';
import nativeApi from 'libentry.so';
@Entry
@Component
struct Index {
private controller: ArkUIViewController | undefined = undefined;
private previousMode: KeyboardAvoidMode | undefined = undefined;
aboutToAppear(): void {
const context = this.getUIContext();
this.previousMode = context.getKeyboardAvoidMode();
// ArkUI 负责缩短 Compose 宿主视口,共享页面不再叠加键盘高度。
context.setKeyboardAvoidMode(KeyboardAvoidMode.RESIZE);
this.controller = nativeApi.createController();
}
aboutToDisappear(): void {
if (this.previousMode !== undefined) {
this.getUIContext().setKeyboardAvoidMode(this.previousMode);
this.previousMode = undefined;
}
}
build() {
Column() {
if (this.controller) {
Compose({ controller: this.controller, libraryName: 'entry' })
.width('100%')
.height('100%');
}
}.width('100%').height('100%').backgroundColor('#F4F1EB');
}
}
窗口与键盘日志
example/ohos/entry/src/main/ets/entryability/EntryAbility.ets
import { UIAbility } from '@kit.AbilityKit';
import { window } from '@kit.ArkUI';
import { hilog } from '@kit.PerformanceAnalysisKit';
export default class EntryAbility extends UIAbility {
private mainWindow: window.Window | undefined = undefined;
private readonly keyboardChanged = (heightPx: number): void => {
hilog.info(0x0132, 'BookingIme', 'keyboard heightPx=%{public}d', heightPx);
};
onWindowStageCreate(stage: window.WindowStage): void {
const win = stage.getMainWindowSync();
this.mainWindow = win;
win.on('keyboardHeightChange', this.keyboardChanged);
stage.loadContent('pages/Index', (error) => {
if (error.code) {
hilog.error(0x0132, 'BookingIme', 'page_load_failed code=%{public}d', error.code);
}
});
}
onWindowStageDestroy(): void {
this.mainWindow?.off('keyboardHeightChange', this.keyboardChanged);
this.mainWindow = undefined;
}
}
Kotlin 原生入口
composeApp/src/ohosMain/kotlin/dev/booking/sample/Platform.kt
package dev.booking.sample
import androidx.compose.ui.window.ComposeArkUIViewController
import kotlinx.cinterop.ExperimentalForeignApi
import kotlinx.coroutines.initMainHandler
import kotlin.experimental.ExperimentalNativeApi
import platform.ArkTS.ArkTS_Napi_NativeModule.napi_env
import platform.ArkTS.ArkTS_Napi_NativeModule.napi_value
@OptIn(ExperimentalNativeApi::class, ExperimentalForeignApi::class)
@CName("MainArkUIViewController")
fun MainArkUIViewController(env: napi_env): napi_value {
initMainHandler(env)
return ComposeArkUIViewController(env) { BookingScreen() }
}
N-API 桥接
example/ohos/entry/src/main/cpp/napi_init.cpp
#include "libkn_api.h"
#include "napi/native_api.h"
namespace {
napi_value CreateController(napi_env env, napi_callback_info)
{
return reinterpret_cast<napi_value>(MainArkUIViewController(env));
}
napi_value Init(napi_env env, napi_value exports)
{
androidx_compose_ui_arkui_init(env, exports);
napi_property_descriptor controller = {
"createController", nullptr, CreateController, nullptr, nullptr, nullptr, napi_default, nullptr
};
napi_define_properties(env, exports, 1, &controller);
return exports;
}
}
static napi_module module = {1, 0, nullptr, Init, "entry", nullptr, {0}};
extern "C" __attribute__((constructor)) void RegisterEntryModule()
{
napi_module_register(&module);
}
桥接声明
example/ohos/entry/src/main/cpp/types/libentry/Index.d.ts
import type { ArkUIViewController } from '@cpf-kmp-cmp/compose/src/main/cpp/types/libcompose_arkui_utils';
export const createController: () => ArkUIViewController;
示例构建与产物同步
composeApp/build.gradle.kts
import org.jetbrains.kotlin.gradle.plugin.mpp.NativeBuildType
plugins {
alias(libs.plugins.kotlinMultiplatform)
alias(libs.plugins.composeMultiplatform)
alias(libs.plugins.composeCompiler)
}
kotlin {
// 共享界面分别生成平板 ARM64 与模拟器 X64 动态库。
listOf(ohosArm64(), ohosX64()).forEach { target ->
target.binaries.sharedLib {
baseName = "kn"
if (buildType == NativeBuildType.RELEASE) {
optimized = false
}
export(libs.compose.multiplatform.export)
linkerOpts("-lz")
val backend = rootProject.findProperty("rendererBackend")?.toString() ?: "skia"
if (backend == "fusion-renderer") {
linkerOpts(
"-lnative_drawing", "-limage_source", "-lpixelmap", "-lpixelmap_ndk.z",
"-lnative_window", "-lace_napi.z", "-lhilog_ndk.z", "-lhitrace_ndk.z",
"-luv", "-lunwind", "-licu"
)
}
}
target.compilations.getByName("main") {
val resource by cinterops.creating {
defFile(file("src/ohosMain/cinterop/resource.def"))
includeDirs(file("src/ohosMain/cinterop/include"))
}
}
}
sourceSets {
commonMain.dependencies {
implementation(compose.runtime)
implementation(compose.foundation)
implementation(compose.material)
implementation(compose.material3)
implementation(compose.ui)
implementation(compose.components.resources)
implementation(compose.components.uiToolingPreview)
implementation(libs.kotlinx.coroutines.core)
implementation(libs.atomicFu)
}
val ohosMain by creating {
dependsOn(commonMain.get())
dependencies {
api(libs.compose.multiplatform.export)
}
}
getByName("ohosArm64Main").dependsOn(ohosMain)
getByName("ohosX64Main").dependsOn(ohosMain)
}
}
// 成套复制动态库与头文件,鸿蒙宿主不依赖 Android 或 iOS SDK。
arrayOf("debug", "release").forEach { type ->
val capitalized = type.replaceFirstChar { it.uppercase() }
tasks.register<Copy>("publish${capitalized}BinariesToHarmonyApp") {
group = "harmony"
dependsOn("link${capitalized}SharedOhosArm64", "link${capitalized}SharedOhosX64")
duplicatesStrategy = DuplicatesStrategy.INCLUDE
into(rootProject.file("example/ohos"))
from("build/bin/ohosArm64/${type}Shared/libkn_api.h") {
into("entry/src/main/cpp/include/arm64-v8a/")
}
from("build/bin/ohosArm64/${type}Shared/libkn.so") {
into("entry/libs/arm64-v8a/")
}
from("build/bin/ohosX64/${type}Shared/libkn_api.h") {
into("entry/src/main/cpp/include/x86_64/")
}
from("build/bin/ohosX64/${type}Shared/libkn.so") {
into("entry/libs/x86_64/")
}
val resourcePackage = "${rootProject.name}.${project.name.lowercase()}.generated.resources"
from("src/commonMain/composeResources") {
into("entry/src/main/resources/rawfile/composeResources/$resourcePackage/")
}
}
}
宿主版本配置
example/ohos/build-profile.json5
{
"app": {
"signingConfigs": [],
"products": [
{
"name": "default",
"compatibleSdkVersion": "26.0.0",
"targetSdkVersion": "26.0.0",
"compileSdkVersion": "26.0.0",
"runtimeOS": "HarmonyOS",
"buildOption": {
"nativeCompiler": "BiSheng",
"strictMode": {
"caseSensitiveCheck": true,
"useNormalizedOHMUrl": true
}
}
}
],
"buildModeSet": [
{
"name": "debug",
},
{
"name": "release"
}
]
},
"modules": [
{
"name": "entry",
"srcPath": "./entry",
"targets": [
{
"name": "default",
"applyToProducts": [
"default"
]
}
]
}
]
}
5



被折叠的 条评论
为什么被折叠?



