KMP/CMP 鸿蒙社区:CPF-KMP-CMP。
鸿蒙 PC 的 ArkUI 页面上,尺寸条读到 1280 × 800 · 横屏 · large · 12 栏 · 侧轨 · 分栏。这行字是 ArkUI 画的,数字却不是:页面把窗口宽高从 px 换成 vp,交给 N-API;Kotlin/Native 调一次 resolveTabletLayout,再把结果写成 JSON 送回来。
断点只写一份,渲染端有两个:Compose 工作台用 Kotlin 直接画,ArkUI 页面用 ArkTS 重画一遍外壳。中间隔着 @CName、版本脚本、N-API 和一次 JSON.parse。工程上的麻烦大多在这几层,不在布局公式。
1. 为什么不让 ArkUI 自己写断点
ArkUI 侧完全有能力再写一份 600/840/1200 的判断。问题是两份规则没有共同的测试:Compose 侧改了 listWidth 的小数处理,ArkUI 侧不会跟着变;鸿蒙上看到的侧轨宽度和桌面上不一致,排查会先怀疑桥接,最后才发现是两份断点漂了。
现在的分工是 Kotlin 侧的 resolveTabletLayout 做唯一实现,ArkUI 只消费结果。代价是窗口每变一次尺寸就多一次跨语言调用和一次 JSON 解析。尺寸变化是低频事件,这个代价可以接受;两份契约漂移是长期问题。
旋转、折叠、分屏、拖窗在系统层走不同通道,对页面只有一种后果:可用宽高变了。布局函数不读 screen.orientation,也不读设备型号。
2. 1280×800 的侧轨,390×844 的底部导航
Compose Desktop 工作台
Compose Desktop 窗口初始 1280×800,横屏 large 档。仓库 仓库说明的首图是横屏预览图的离屏渲染;优快云 图床里的三张窗口图都是鸿蒙 PC 上的 ArkUI 宿主,放在下一节。
88dp 深绿侧轨立在左侧;列表栏按 listWidth 固定,1280 宽时算出来 435.2,夹到上限 400dp,单列排卡片。尺寸提示条是 1280 × 800 · 横屏 · large · 12 栏。
顶栏的「旋转窗口」按钮交换 windowState.size 的宽高,再夹进 GraphicsEnvironment.maximumWindowBounds:可用上限分别是 screen.width - 48 与 screen.height - 88,各自不低于 480;交换后的目标宽高再 coerceIn(360, 上限),窗口重新居中。旋转后当前导航、当前笔记和列表滚动位置都还在。
切换导航目标时,列表按 item.section === destination.id 过滤,双栏选中新目标的第一条;目标切换、条目选择和布局重算各走各的状态路径。
鸿蒙 PC 真机
ArkUI 宿主在鸿蒙 PC 上以 1280×800 的自由窗口启动:

页面读取窗口尺寸后立即解析布局,自动切到侧轨 + 分栏。宽屏下还有「重置窗口 / 手机竖屏 / 手机横屏 / 平板横屏」尺寸胶囊:点击把真实窗口调到该尺寸,屏幕放不下的档位标成「超出屏幕」,只读展示。拖动窗口边缘时按实际尺寸重算,「重置窗口」回到 1280×800。
胶囊调到 390×844,或者手动把窗口拖到 983×451 时,同一个 ArkUI 页面拿到的是两份真实窗口约束:


桌面 1280×800 和鸿蒙 PC 的 1280×800 是两个盒子。Compose Desktop 的 rememberWindowState 设的是窗口尺寸,内容区还要扣掉标题栏和边框,工作台拿到的会比 1280×800 小一圈;旋转按钮夹的是窗口,内容区另算。鸿蒙侧读的是 windowRect 的像素宽高,px2vp 之后就是页面用的 vp;两边跑同一份断点,但桌面更容易在 840 和 1200 边界附近看到“窗口够宽、内容区不够”的差异。
3. 环境与两个 Gradle 构建
库和示例在同一仓库的两个构建里。布局库 tablet-adaptive/ 声明七个 target:desktop JVM、Android、iOS 三个、OHOS 两个。消费端必须包含 HarmonyOS 发行线的组件镜像,否则 OHOS 变体与 Kotlin 元数据解析不到:
| 项目 | 本例使用值 |
|---|---|
| Kotlin / CMP | 2.2.21-1.0.0 / 1.9.2-1.0.0(HarmonyOS 发行线) |
| 组件镜像 | maven.eazytec-cloud.com(maven-public 与 harmonyos 组) |
| Gradle / JDK | 8.14.1(仓库带 wrapper)/ 21 |
| Android target | compileSdk 35,minSdk 24,JVM 17 |
| iOS target | iosArm64 / iosSimulatorArm64 / iosX64 |
| OHOS target | ohosArm64 / ohosX64(KLIB;打 HAP 需 DevEco + hvigor) |
| DevEco Studio | HarmonyOS SDK 26(API 26);签名材料不入库,signingConfigs 默认空 |
| 真机 | HUAWEI MateBook Pro S(MOR-W52),鸿蒙 PC,OpenHarmony 7.0.0.109,API 26;1280×800 自由窗口验证 |
| 平台 UI 依赖 | 仅 compose.runtime / foundation / ui——零 Material |

ohosX64 的 KLIB 能编过,但示例没有为它出 HAP;真要在 x64 模拟器上跑,nativeApp 得再加一个 target 和对应的 linker 配置。
消费端只编 KLIB 时不需要 DevEco,这跟 target 声明无关,是 Kotlin/Native 工具链的性质。
tablet-adaptive/ 是可发布的库本体,commonMain 只有五个源文件;example/shared 是共享示例加 Compose Desktop 工作台;example/nativeApp 面向 OHOS ARM64 做 Kotlin/Native 桥接;example/ohosApp 是 DevEco Stage 工程。
原生侧最容易配错的是链接参数:
// example/nativeApp/build.gradle.kts
plugins {
kotlin("multiplatform")
}
kotlin {
jvmToolchain(21)
ohosArm64 {
binaries.sharedLib {
baseName = "tablet_adaptive"
// Entry 0 keeps the Kotlin/Native runtime from expecting a main;
// the version script exports only the four bridge functions.
linkerOpts(
"--entry=0",
"--version-script=${project.file("src/ohosArm64Main/linker/shared-library.map")}",
)
// OpenHarmony runtime libraries needed by Kotlin/Native and N-API.
linkerOpts("-lace_napi.z", "-luv", "-lhilog_ndk.z")
}
}
sourceSets {
commonMain.dependencies {
implementation(project(":shared"))
}
}
}
/** Copies the linked .so into the ArkUI project. The C header is source. */
val prepareOhos by tasks.registering(Copy::class) {
dependsOn("linkDebugSharedOhosArm64")
from(layout.buildDirectory.dir("bin/ohosArm64/debugShared")) {
include("libtablet_adaptive.so")
into("libs/arm64-v8a")
}
into(rootProject.layout.projectDirectory.dir("ohosApp/entry"))
}
tasks.withType<org.jetbrains.kotlin.gradle.tasks.KotlinNativeLink>().configureEach {
inputs.file("src/ohosArm64Main/linker/shared-library.map")
}
--entry=0 是因为共享库没有 main;版本脚本只导出四个符号,其余设成 local;-lace_napi.z、-luv、-lhilog_ndk.z 是 N-API 和 OpenHarmony 运行时需要的库。prepareOhos 把 .so 复制进 ohosApp/entry/libs/arm64-v8a,版本脚本是任务输入,改脚本会触发重新链接。
发布走 maven-publish,POM 含 Apache-2.0、SCM 与 developer 信息;示例消费本地发布的 io.github.lqjmac:tablet-adaptive-cmp:1.0.0。
七个 target 共用一份 commonMain,代价是这层只能取各平台依赖的交集:kotlin.math、Compose 的 runtime / foundation / ui(以及它们带进来的 coroutines),不能碰 java.*、Android 的 Context、iOS 的 UIKit,也不能在 common 里直接调鸿蒙窗口 API。好处是断点、状态机和绘制逻辑只有一份;坏处是平台特有的行为都得留在各自的 source set 里,commonTest 目前只在 JVM 上跑。现在的 commonMain 没有 expect/actual,窗口尺寸要么由 BoxWithConstraints 量出来,要么由 ArkUI 宿主经 N-API 送进来,这条边界是刻意留的。消费端如果只用到布局函数,也躲不开 Compose 的 UI 依赖:POM 里用的是 api,runtime、foundation、ui 会一起带进来。
4. 共享布局契约
三档断点之外的全部规则——导航、单双栏、列表宽度、密度、isTablet——都是宽高的纯推导:
| 条件 | 结果 |
|---|---|
width < 600 / 840 / 1200 | compact / medium / expanded / large,栏数 4 / 8 / 12 / 12 |
| 导航 | ≥840,或 ≥600 且横屏 → rail;否则 bottom |
| 分栏 | ≥840,或 ≥720 且横屏 → split;否则 single |
| 列表宽度 | clamp(round(width × 0.34), 300, 400) |
| 密度 / 头部 | height < 500 → compact / 56dp;否则 comfortable / 64dp |
isTablet | min(width, height) ≥ 600,信息字段,不给分档封顶 |
函数只 import kotlin.math.round,没有 Compose 依赖:
// tablet-adaptive/src/commonMain/kotlin/io/github/lqjmac/tabletadaptive/TabletLayout.kt
fun resolveTabletLayout(
width: Float,
height: Float,
config: TabletLayoutConfig = TabletLayoutConfig.Default,
): TabletLayout {
val w = width.normalizedDimension()
val h = height.normalizedDimension()
val orientation = if (w > h) TabletOrientation.LANDSCAPE else TabletOrientation.PORTRAIT
val landscape = orientation == TabletOrientation.LANDSCAPE
val sizeClass = when {
w < config.compactMaxWidth -> TabletSizeClass.COMPACT
w < config.mediumMaxWidth -> TabletSizeClass.MEDIUM
w < config.expandedMaxWidth -> TabletSizeClass.EXPANDED
else -> TabletSizeClass.LARGE
}
// NOTE: `isTablet` is informational only. It must never cap `sizeClass`,
// navigation or pane mode: a 844 × 390 phone in landscape still resolves
// to expanded / rail / split, while `isTablet` stays false.
val columns = when (sizeClass) {
TabletSizeClass.COMPACT -> 4
TabletSizeClass.MEDIUM -> 8
TabletSizeClass.EXPANDED, TabletSizeClass.LARGE -> 12
}
val margin = when (sizeClass) {
TabletSizeClass.COMPACT -> 16f
TabletSizeClass.MEDIUM -> 24f
TabletSizeClass.EXPANDED -> 32f
TabletSizeClass.LARGE -> 40f
}
val gutter = when (sizeClass) {
TabletSizeClass.COMPACT -> 8f
TabletSizeClass.MEDIUM -> 16f
TabletSizeClass.EXPANDED -> 24f
TabletSizeClass.LARGE -> 32f
}
val cardColumns = when {
w >= config.cardFourColumnsMinWidth -> 4
w >= config.cardThreeColumnsMinWidth -> 3
w >= config.cardTwoColumnsMinWidth && landscape -> 3
w >= config.cardTwoColumnsMinWidth -> 2
else -> 1
}
val navigation = when {
w >= config.railMinWidth -> TabletNavigation.RAIL
w >= config.railLandscapeMinWidth && landscape -> TabletNavigation.RAIL
else -> TabletNavigation.BOTTOM
}
val paneMode = when {
w >= config.splitMinWidth -> TabletPaneMode.SPLIT
w >= config.splitLandscapeMinWidth && landscape -> TabletPaneMode.SPLIT
else -> TabletPaneMode.SINGLE
}
val listWidth = round(w * config.listWidthFraction)
.coerceIn(config.listWidthMin, config.listWidthMax)
val density = if (h < config.compactHeightThreshold) {
TabletDensity.COMPACT
} else {
TabletDensity.COMFORTABLE
}
val headerHeight = when (density) {
TabletDensity.COMFORTABLE -> config.comfortableHeaderHeight
TabletDensity.COMPACT -> config.compactHeaderHeight
}
return TabletLayout(
width = w,
height = h,
orientation = orientation,
sizeClass = sizeClass,
columns = columns,
cardColumns = cardColumns,
margin = margin,
gutter = gutter,
navigation = navigation,
paneMode = paneMode,
listWidth = listWidth,
railWidth = config.railWidth,
bottomBarHeight = config.bottomBarHeight,
headerHeight = headerHeight,
density = density,
isTablet = minOf(w, h) >= 600f,
)
}
private fun Float.normalizedDimension(): Float =
if (isFinite() && this > 0f) this else 0f
normalizedDimension() 把非有限值和小于等于 0 的值归零,NaN、±Infinity、-120 都得到 0;0×0 是一组合法的 compact/portrait 输入。
TabletLayoutConfig 把所有阈值暴露成参数。默认值就是规范;改参数等于生成一份新契约,测试要跟着换。
listWidth 先 round(w × 0.34) 再 coerceIn(300, 400):1024 宽得 348,1199 宽得 400(407.66 超上限),720 宽得 300(244.8 低于下限)。0.34f 本身不能精确表示,1024、1199 这类宽度乘出来会有二进制误差;round 之前不要先做额外的除法或乘方,契约里固定用 w * listWidthFraction 再 round,顺序不变,跨端才能对上同一组向量。density 只看高度,500 是分界;isTablet 只看短边,所以 844×390 是 expanded / rail / split、isTablet == false、density == compact、头部 56dp。
width == height 归竖屏,800×800 不会因为交换宽高变成横屏。
契约测试在 commonTest 跑:SPEC 2.2 的 12 个向量,加上 isTablet、高度 500 边界、正方形与 NaN / Infinity / 负数的归一化、listWidth 的 round 与 clamp、自定义 Config。:tablet-adaptive:desktopTest 的 9 项全绿就是最低验收。这 9 项都跑在 JVM 上;OHOS 上的同一函数由 ArkUI 页面经 N-API 调用,行为验证来自真机页面,commonTest 管不到。
5. BoxWithConstraints 和状态提升
量尺寸只有一个 Compose 基础组件:
// tablet-adaptive/src/commonMain/kotlin/io/github/lqjmac/tabletadaptive/TabletLayoutScope.kt
@Composable
fun TabletLayoutScope(
modifier: Modifier = Modifier,
config: TabletLayoutConfig = TabletLayoutConfig.Default,
content: @Composable BoxScope.(TabletLayout) -> Unit,
) {
BoxWithConstraints(modifier = modifier.fillMaxSize()) {
val layout = remember(maxWidth, maxHeight, config) {
resolveTabletLayout(
width = maxWidth.value,
height = maxHeight.value,
config = config,
)
}
content(layout)
}
}
BoxWithConstraints 把当前容器的 maxWidth / maxHeight 暴露成 Dp,.value 转成 dp 数值,正好是契约的单位。remember(maxWidth, maxHeight, config) 让布局只在尺寸或配置变化时重算。remember 的 key 是 Dp 和 TabletLayoutConfig,后者是 data class,equals 逐字段比较;宿主每次重组新建一个内容相同的 config,不会触发重算。
BoxWithConstraints 的 content 走的是另一套流程:它要等父级完成一次测量、拿到 Constraints 之后才 subcompose 里面的内容。maxWidth / maxHeight 只能在 content lambda 里读;在 TabletLayoutScope 外面、或者在一个还没进入 layout 阶段的 @Composable 里,这两个值不存在。也正因为 content 在测量阶段执行,在里面直接写 mutableStateOf 可能触发“测量→重组→再测量”的循环;工作台把状态写到 scope 外面,只把算好的 layout 传进来,绕开了这条路径。
fillMaxSize() 要求父级有界。放进纵向滚动的父级,maxHeight 是 Infinity,归一化后变成 0,密度掉到 compact;宽度通常还有界,所以表现是“头部突然变矮”。这个边界没有测试覆盖,使用前先确认容器给了高度。
工作台的状态全部放在 TabletLayoutScope 外面。AdaptiveTabletWorkspace 里是三个 mutableStateOf:selectedDestinationId、selectedItemId、showingDetail;两个滚动状态 rememberLazyGridState() 和 rememberScrollState() 也在 TabletLayoutScope 的 content lambda 之前创建。filteredItems 用 remember(items, selectedDestinationId) 缓存。三个状态和两个滚动对象都不住在会随布局切换而离开的 composition 分支里,单双栏切换、旋转、拖窗只改变 layout,不会把它们从 composition 里摘掉。
LaunchedEffect(layout.paneMode, selectedDestinationId, filteredItems) 在 paneMode、目标或过滤结果变化时复位 showingDetail,双栏下选中项不在结果里时补第一条。LaunchedEffect(selectedItemId) 只在新选一条笔记时把详情滚回顶部;单纯旋转不改变选中项,effect 不重启,阅读位置不动。
我最早把 rememberLazyGridState() 写在了 if (layout.navigation == RAIL) 分支里。窗口从 1280 拖到 800 再拖回去,侧轨出现时列表回到了顶部。remember 的生命周期跟着所在的 composition 分支走,分支离开就忘;提到 scope 外面,分支怎么换都不影响。
视觉上零 Material:导航、卡片、详情、空态用 Foundation 与绘制 API 自己画,默认暖纸底 #F2EFE8、深绿侧轨 #16352E。导航容器带 paneTitle = "主导航" 语义,卡片 Role.Button 自带焦点与 Enter/Space。
6. Kotlin/Native 到 ArkUI:四个符号与 JSON 契约
example/nativeApp 把共享代码编成 OHOS ARM64 共享库,导出的 C 符号都在这个文件里:
// example/nativeApp/src/ohosArm64Main/kotlin/io/github/lqjmac/tabletadaptive/example/NativeBridge.kt
@file:OptIn(kotlin.experimental.ExperimentalNativeApi::class, kotlinx.cinterop.ExperimentalForeignApi::class)
package io.github.lqjmac.tabletadaptive.example
import kotlinx.cinterop.ByteVar
import kotlinx.cinterop.CPointer
import kotlinx.cinterop.allocArray
import kotlinx.cinterop.nativeHeap
import kotlinx.cinterop.set
private fun textBuffer(text: String): CPointer<ByteVar> {
val bytes = text.encodeToByteArray()
val buffer = nativeHeap.allocArray<ByteVar>(bytes.size + 1)
bytes.forEachIndexed { index, byte -> buffer[index] = byte }
buffer[bytes.size] = 0
return buffer
}
private inline fun response(block: () -> String): CPointer<ByteVar> = try {
textBuffer(block())
} catch (error: Throwable) {
textBuffer("{\"error\":${(error.message ?: "Native error").jsonQuote()}}")
}
/** Resolves one container size in dp and returns the layout as JSON. */
@CName("TabletLayoutGet")
public fun layoutNative(width: Double, height: Double): CPointer<ByteVar> = response {
WorkspaceJson.layout(WorkspaceExamples.layout(width.toFloat(), height.toFloat()))
}
/** Returns the representative sample sizes and their resolved layouts. */
@CName("TabletCatalogGet")
public fun catalogNative(): CPointer<ByteVar> = response {
WorkspaceExamples.catalogJson()
}
/** Runs the shared contract checks so the ArkUI page can display them. */
@CName("TabletRunChecks")
public fun checksNative(): CPointer<ByteVar> = response {
WorkspaceExamples.checksJson()
}
/** Frees a string previously returned by any bridge function. */
@CName("TabletFree")
public fun freeNative(pointer: CPointer<ByteVar>?) {
if (pointer != null) nativeHeap.free(pointer.rawValue)
}
四个 @CName 对应四个符号:TabletLayoutGet(width, height) 返回布局 JSON,TabletCatalogGet() 返回样例尺寸的解析结果,TabletRunChecks() 返回契约自检,TabletFree(pointer) 释放前面三个函数分配的字符串。
内存所有权最容易漏。textBuffer() 用 nativeHeap.allocArray<ByteVar>(bytes.size + 1) 分配并补 0,返回裸指针;N-API 把字符串复制进 napi_value 之后必须调 TabletFree,否则每次窗口变化都会漏一小块 native 内存。
字符串的生命周期在桥两边各算各的。Kotlin 侧 textBuffer() 在 native heap 上分配,返回的指针没有 owner;N-API 的 GetLayout 把它交给 napi_create_string_utf8 复制成 JS 字符串,复制完立刻 TabletFree,所以 ArkTS 拿到的是普通 JS 字符串,指针留在了 native 侧,JSON.parse 之后原 buffer 已经可以回收。TabletFree 只能对那三个返回字符串的函数各调一次,重复释放会踩 native heap;传 null 时 freeNative 直接跳过,C++ 里“复制失败也要 free”的路径是安全的。TabletFree 释放的是原生 buffer,ArkTS 手里那份字符串是拷贝,JS 的 GC 管不到 native heap;这两套生命周期得由 N-API 这一层对齐。
response {} 兜住所有 Throwable,把异常消息包进带 error 字段的 JSON。桥不会因为一次布局异常把 ArkTS 侧带崩,但错误 JSON 里没有 paneMode、headerHeight 这些字段。
WorkspaceJson.layout 手写 19 个字段,整数不带 .0,HILOG 里读起来短一截;jsonQuote() 处理引号、反斜杠、换行和小于 0x20 的控制字符,少了这些转义,JSON.parse 会在 ArkTS 侧直接抛。
N-API 把两个 napi_value 读成 double 并检查有限、非负,调 TabletLayoutGet,用 napi_create_string_utf8 复制成 JS 字符串,再 TabletFree 原生指针。ArkTS 侧只剩 JSON.parse(nativeGetLayout(width, height)) as LayoutView;px2vp 换单位,win.off('windowSizeChange') 在 aboutToDisappear 里摘监听。
有两个不一致要说明。N-API 的 ReadDimension 拒绝负数和非有限值并抛类型错误,Kotlin 的 normalizedDimension() 却把它们归零——同一份引擎,ArkUI 侧比 Compose 侧严格。另一个是错误 JSON:NativeWorkspace.ets 直接 as LayoutView,不校验字段,错误对象会被当成布局值用;paneMode 是 undefined,页面走单栏分支,resolve() 已经把 errorText 清空,原因只留在 HILOG 里。当前只保证不崩。
纯函数的测试只覆盖 TabletLayout 的值,覆盖不到 N-API 的参数校验:getLayout(-1, 800) 在 C++ 层会被拒绝,在 Kotlin 层却会归一化成 0。这类差异不会让桌面测试变红,得在 ArkUI 页面上手动试一次才能看见。
版本脚本保证 .so 只导出四个符号,nm -D --defined-only 只剩四个 T 符号;Kotlin 运行时符号没有进导出表。libtablet_adaptive.so 由 linkDebugSharedOhosArm64 产出,prepareOhos 复制进宿主;HAP 里同时打包 libentry.so(N-API 入口)。
7. 编译与验证
先发布库到本地 Maven,示例工程依赖它:
export JAVA_HOME=/path/to/jdk-21
# 库:单测(最低验收)+ OHOS KLIB + 本地发布
./gradlew :tablet-adaptive:desktopTest --no-daemon
./gradlew :tablet-adaptive:compileKotlinOhosArm64 --no-daemon
./gradlew :tablet-adaptive:publishToMavenLocal --no-daemon
桌面工作台与离屏预览:
cd example
./gradlew :shared:run # 1280×800 窗口 + 旋转按钮
./gradlew :shared:desktopTest # 契约 + 离屏渲染两张预览(无需显示器)
鸿蒙真机:先编共享库并复制进宿主,再用 DevEco 的 hvigor 打 HAP:
cd example
./gradlew :nativeApp:linkDebugSharedOhosArm64 --no-daemon
./gradlew :nativeApp:prepareOhos --no-daemon
cd ohosApp
export NODE_HOME="<DevEco Node 目录>"
export DEVECO_SDK_HOME="<DevEco SDK 路径>"
hvigorw \
assembleApp --no-daemon --no-parallel
hdc install -r entry/build/default/outputs/default/entry-default-signed.hap
hdc shell aa start -a EntryAbility -b com.lqjmac.tablet_adaptive_example
签名材料不进仓库:ohosApp/build-profile.json5 的 signingConfigs 默认为空,首次构建前在 DevEco 的 Signing Configs 里生成本机签名。HDC 安装的是本机签名的 HAP,换一台机器就要重新生成签名;bundleName 和 profile 绑定,改包名等于换一套签名材料。
本机验证记录(Zulu JDK 21、Gradle 8.14.1、HarmonyOS SDK 26、鸿蒙 PC 真机):
| 命令 | 结果 |
|---|---|
:tablet-adaptive:desktopTest | 通过(9 个布局测试) |
:tablet-adaptive:compileKotlinOhosArm64 | 通过(OHOS arm64 KLIB) |
compileReleaseKotlinAndroid + compileKotlinIosArm64 | 通过 |
:tablet-adaptive:publishToMavenLocal | 通过(含 Android AAR 与 OHOS KLIB) |
:shared:desktopTest | 通过(7 个共享测试 + 两张离屏预览) |
:nativeApp:linkDebugSharedOhosArm64 / prepareOhos | 通过(libtablet_adaptive.so 复制进 entry) |
hvigorw assembleApp | 通过(本机签名 HAP) |
| HDC 安装 / 启动 | 通过(鸿蒙 PC 1280×800,large / 侧轨 / 分栏) |
7 个共享测试覆盖契约、样例和 JSON:1280×800 是 large / rail / split / 400dp、844×390 是 expanded 但 isTablet == false、6 个样例的 listWidth 都在 300–400、catalog JSON 有 6 个 "id"、layout JSON 的字段与转义。离屏预览用 renderComposeScene 输出 workspace-1280x800.png 和 workspace-800x1000.png,同时当布局回归基线。renderComposeScene 用的是真实 Composable,但字体和绘制后端是桌面 JVM 的;预览能当布局回归基线,不能当鸿蒙渲染基线。
桌面测试能覆盖断点、样例和 JSON,覆盖不了 ArkUI 的窗口回调顺序:拖窗时 windowSizeChange 可能一帧内来好几次,resolveLayout 每次都做一次 JSON 序列化和解析。页面现在没有做节流,onWindowSize 每次回调都会重新解析;如果回调频率上来,这里要补一帧的防抖。
未验证:应用市场分发、iOS App 链接与上架;示例只保证 Composition / 页面存活期间的状态,Ability 重建后的恢复没做。库本身只保证 KLIB / AAR / JAR 的编译与发布。
8. 几个具体问题
compileKotlinAndroid 在 AGP 下不存在,实际任务是 compileDebugKotlinAndroid / compileReleaseKotlinAndroid;写 CI 前先用 ./gradlew tasks 核对。
Kotlin/Native 与 AGP 都要求 JDK 21;用 17 跑会在不相关的位置先报错,JAVA_HOME 指对版本再开工。
编 OHOS KLIB 不需要 DevEco;打 HAP 需要 hvigor 与 SDK,真机安装还要签名与 HDC。缺哪段装哪段。
消费端没有配 maven.eazytec-cloud.com 时,依赖解析报的是找不到,跟版本冲突无关;把镜像加进 dependencyResolutionManagement 即可。
桌面旋转按钮最初直接交换宽高,竖屏窗口比屏幕高时底部被截。现在的做法是夹取到 maximumWindowBounds,宽高再各自限制在 360 到上限之间。
width == height 时交换宽高等于没转,布局仍然判竖屏。示例的旋转按钮没有为正方形窗口做 height - 1 的特殊处理,它只是一个原地操作;契约和测试只约定正方形归竖屏。
9. 现在能交付什么
仓库能交付三样东西:一份同时产出 KLIB、AAR、JAR 的库,一个带旋转按钮的 Compose Desktop 工作台,一个在鸿蒙 PC 上通过 N-API 消费同一份断点的 ArkUI 页面。
没做完的也清楚:Ability 重建后的状态恢复、ohosX64 的 HAP、应用市场分发、iOS 上架。库的 ohosX64 只编过 KLIB,示例只配了 arm64。
改断点时先跑 :tablet-adaptive:desktopTest,再看 :shared:desktopTest 的两张预览,最后去鸿蒙 PC 核对 ArkUI 的尺寸条;这是仓库验证记录里的顺序。
参考资料:Compose Multiplatform 布局、BoxWithConstraints、HarmonyOS 窗口管理、Kotlin/Native 互操作、CPF-KMP-CMP 文档。
7



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



