KMP/CMP 鸿蒙社区 · 鸿蒙跨端实战总仓库 · 纸边摘录源码与 README
前言
平板分屏读资料时,我希望能把有用的半句话直接留在旁边。浏览器里选中文字,右侧或左侧已经有一个可以写备注的应用,这时再点「复制」、切换焦点、选中编辑框、粘贴,虽然也能做完,但很容易打断阅读。尤其是屏幕上同时开着两份材料的时候,剪贴板里上次复制的到底是标题还是正文,往往要到粘贴以后才知道。
这次做的「纸边摘录」只处理一件事:接收另一个应用拖来的纯文本,把它变成一张能加备注的卡片。网页选区由浏览器维护,摘录应用不读浏览器页面,也没有把「拖过来」做成剪贴板的快捷入口。在读者看到卡片之前,文字需要依次通过鸿蒙的拖放事件、UDMF 数据、ArkTS 与 Kotlin 的原生桥,最后由 Compose 刷新列表。这个过程值得拆开看,因为拖动时有预览、手指在目标上松开和卡片确实落地,是三个不同的时刻。
分屏演示
左边打开纸边摘录,右边打开华为浏览器。浏览器中的《一条街的雨声》是工程自带的样页,只有两段正文和一张插图。长按第一段,再拖动两端的选区手柄;选好后,从高亮文字的中间长按并拖进「放到这里」。手指在虚线框内松开,页面显示「已加入摘录」,下方列表多一张卡片。正文留在卡片上,「自己的备注」是另一个字段,可以补一笔而不改动摘下来的文字。
选中文字,拖入摘录框


这个界面没有让整个 Compose 页面成为投放目标。左侧上方的虚线框负责接收,下面是已有摘录和备注。两栏分工明确以后,才能验证松手的位置是否真的起作用:手指即使经过接收区,最后落在卡片区也不应触发导入。设计上借鉴了 Readwise Reader 的摘录视图:正文和个人备注分开放,读者容易分清自己摘了什么、又补了什么。纸边摘录只保留这个层次,窄窗里也不增加侧栏。
在华为浏览器 6.1.3.361 上复测时,卡片正文为「路上的声音比光先回来。」。第一次在虚线框内松手,卡片数从 0 条变成 1 条。再拖同一选区到框外,仍为 1 条。重新拖回框内,收到「这段文字已摘录」提示,仍为 1 条。改拖样页插图时能看到图片预览,松手后也仍为 1 条。卡片备注可以单独编辑。



拖入区
先在宿主里放一块 ArkUI 组件,位置在 Compose 内容之前。用 统一拖拽事件 把这块区域声明成纯文本接收方。选择单独的 ArkUI 容器主要是因为跨应用拖放由宿主窗口接收。CMP 里面另写一个处理卡片拖动的指针监听器,解决的是自己的视图内如何响应坐标变化;它收不到来自系统拖放会话的数据对象,也不能替代宿主在窗口层做的类型协商。区分这两类拖动后,就不会把问题排到共享页面的手势层去。
样例在进入区域时加深边框,离开时还原。这个变化给出「当前在这里松手」的提示,不更新列表。只有落下事件才读取数据。最容易犯的错是把进入回调当成导入回调:人把选区带到左侧看一眼,又拖回去,这时卡片已经出现了。把视觉提示和写入放到不同的回调里,也能让连续经过多个接收区的情形更容易处理。
拖入组件声明纯文本类型之后,系统能先判断对方有没有提供合适的数据。这里的「纯文本」指拖放记录的类型,与文件后缀、网页上看起来像不像一段字都没有关系。一段网页文字可能附带链接、富文本或其它表现形式;只有明确提供了可读的纯文本,才是这个示例要接收的内容。另一边,名为 notes.txt 的文件作为文件拖过来,也不因此变成一条纯文本记录。应用不应该把一个文件路径当成摘录。

开发时不要只改接收区的颜色来判断支持情况。颜色能帮助看清手指进入了哪块区域;真正需要核对的是 onDrop 有没有触发、数据里有没有可读记录、桥接最终返回什么。一个常见错觉是移动中看到系统拖拽预览,就以为目标一定可以读取。预览由拖出端和系统管理,目标真正能拿到哪些记录,要到放下之后才知道。
取出正文
浏览器和摘录应用是两个不同的进程。浏览器不会把 DOM 节点递给摘录板,它会把可交接的内容交给系统。接收端拿到的是 DragEvent,再通过 getData() 得到 UnifiedData。后者可能含有多条记录;同一条记录也可能有不止一种表示。示例会遍历记录,在其中找带正文的纯文本表示,再交给桥接层。一趟手势只处理第一条可用的文字,避免一次拖动产生多个界面上难以解释的卡片。
查记录时优先读 getEntry(PLAIN_TEXT),读取结构里的 textContent。对直接交来的 PlainText 对象,宿主也提供了读取 textContent 的分支。前者适合从带多个表示的记录中取出需要的一种,后者覆盖记录本身就是纯文本的情形。依赖类型而不是解析浏览器专用字段,换另一款支持系统拖放的应用时,接收区的代码也不用跟着识别网页结构。华为的 跨应用统一拖拽示例 也把类型声明、取数据和读取记录分成这几步。
接收端只看 textContent,不把记录的摘要当成正文,也不会在缺少纯文本时把 HTML 或链接地址硬转换成摘录。比如网页上「下载报告」四个字带有链接,读者到底想要按钮文字还是链接,需要产品单独定义。这个例子保留的是拖放源明确提供的文字表示,不主动访问目标网站,也不把浏览器地址栏里的 URL 猜成来源。若将来加「保留出处」的需求,要同时处理对方没给链接、有多个链接以及标题和链接对应不上等情况,可以在数据模型里为来源单独留一列。
为什么不先把整份 UnifiedData 发给 Kotlin?跨端公共代码真正关心的只是待摘录文字。把事件对象塞进去,就得解释对象属于哪个平台、在回调退出后是否还可用、不同目标平台怎么实现同一个对象。宿主负责读完系统交给它的记录,给 Kotlin 的只是一段已取出的字符串。这样也保住了一个很有用的边界:在电脑端写一个导入测试时,可以直接喂一段带换行的文字,不必准备鸿蒙拖放事件。
UTF-8 桥接
ArkTS 调用的是 submitExcerpt,C++ 先向 N-API 查询 UTF-8 需要多少字节,再分配缓冲区读取字符串。读取完成后,同时把地址和实际字节数传给 Kotlin/Native;末尾给 N-API 预留的空字节不算正文。这里不能用 ArkTS 的 string.length 做数组长度,因为那个值按 UTF-16 代码单元计数,和需要的 UTF-8 字节数不是一回事。特别是同一段里有中文、英文和表情时,两种计数差异很直观;用错以后可能截断多字节序列,甚至只看见开头的几字。
桥接还有两个好区分的问题。第一,类型不对、参数没读出来或解码不成功,属于桥接错误;第二,文本虽然合法,但太长或重复,属于业务拒绝。两类错误分开以后,页面就可以告诉用户下一步是「重新拖一次」还是「把选区缩短」。空白拖入时也不创建空卡片。日志只写结果编号,避免网页正文被调试日志再记录一份。

原生缓冲区的使用范围只在一次同步调用中。C++ 局部变量离开函数后会释放,所以 Kotlin 在入口把这段字节复制成受管理的数组,再解码成自己的字符串。不把指针留在全局变量里,后续 Compose 重绘只需要读状态。若后面改成异步校验,也要先复制,再调度任务,不能把借来的地址丢给另一条线程用。当前例子只处理少量文字,不需要在一次拖入中引入一个后台队列。
字节数与业务长度分别有限制。桥接在分配前限制输入字节数,摘录库再按 Kotlin 字符串长度限制单张卡片。不把后者描述成「用户可见字符数」:一个组合字符或表情可能占不止一个代码单元。如果未来把限制写在产品界面上,最好事先定义按可见字符、代码点还是 UTF-16 单元计量。对于这个小型示例,限制的用途只是防止整页误导入和异常大的拖放记录撑大界面。
卡片和备注
独立的 excerpt-core 模块只有摘录模型和导入规则。它不知道拖放区在哪,也不依赖 ArkUI、Compose 或 N-API。界面会调用它判断空白、长度和重复,并拿到带稳定编号的卡片列表。导入时清理的是首尾空白并统一换行,正文中间的换行仍保留。换句话说,选区从不同来源得到 CRLF 或 LF 时,两者可以按同一段文字判断;正文里的两段不会为了去重被拼成一行。对依赖空白的代码片段,这套清理规则未必合适,可以在调用方提供专门的导入规则。
共享界面用 ExcerptSession 把库的卡片快照接到 Compose 状态。导入成功才换掉列表快照;重复、过长或读取失败,页面只更新接收区的提示,已有卡片和正在编辑的备注不动。列表给每张卡片一个稳定的键,输入变化用这张卡片的 id 回写。比如第一张卡片的备注已经写了一半,再放入一条新摘录,原来的卡片从第一行移到第二行,备注仍属于同一个 id。若用列表位置去做这个关联,插在最前面时就有机会把正在写的备注串到新卡片上。
试做摘录板容易顺手加上数据库、标签、导出和同步,但这些不是拖放成功的前提。这个工程保留会话内的卡片,不宣称能在进程重启后恢复。实际产品要加本地持久化,可以在库确认添加后写入数据库,再决定失败时如何回滚;另一种做法是给卡片加一个保存状态,落位后先让读者看到内容,写盘失败后再给重试入口。无论选哪种,都应该把「看见卡片」和「永久保存」作为两项独立验证。
分屏宽度
全屏启动时,接收框和正文列表都居中,内容不随平板屏幕无限拉宽。进入分屏后,两个窗口重新分到各自的宽度。接收框仍在摘录应用顶部,用窗口的相对宽度计算,而不是按整块物理屏幕给一个固定横坐标。测试脚本为了重复落点可以使用坐标,产品代码不能把那组数字当作布局尺寸。否则同一块平板交换左右位置,或者把中间分隔线拉偏一点,框看起来还在,命中区域却可能和眼睛看到的不一致。
这里还有一处容易被忽略的宽度:新卡片正文和备注不一定等长。把卡片正文塞进单行标签,可以让列表在宽屏下显得整齐,窄屏却容易把末尾几个字截掉。示例让正文自然换行,备注放到下方,编辑区跟随当前卡片宽度。第一条数据也用较短的中文句子,以便录屏里能逐字核对。若换成几段较长的资料,列表滚动由 Compose 管理,宿主的接收区继续留在顶部,用户不必滚回到某一张卡片才能再导入。
对平板适配来说,分屏本身不是应用绘制的两列。系统分别给浏览器和摘录应用提供窗口,应用内部只对自己的窗口测量。用单应用里的左右模拟区域很容易漏掉窗口边界、独立焦点和拖放类型协商。真机验证时要能看到两个独立应用,也要检查选择、拖出、放下和回到编辑区这些动作是否连续。图里可辨认的浏览器地址栏和系统分隔线就是两个窗口的边界。
结果回传
页面现在区分了导入成功、无可读文本、重复、过长和桥接错误。成功时,Kotlin 先提交卡片状态,再由宿主告知系统放下成功。这个先后顺序很重要。如果宿主先报告成功,再尝试读取和校验,浏览器侧的拖拽会结束得像一次成功操作,摘录板却没有新增内容。反过来,如果库已经加了一条,宿主还标成失败,用户可能重复拖一次来确认,带来不必要的操作。
重复拖入的提示还保留了前一次创建的卡片。这里采用的规则是「内容相同只建一次」,并不适合所有产品。例如两篇文章恰好引用了同一句话,读者可能希望分别保留出处。可以把去重键改为正文和来源组合,或者直接允许重复,由用户自己合并。本文的示例只接收纯文本,没有可验证的来源字段,因此选了最容易复测的规则。归档工具想保留来源时,应该在读懂目标拖出方交付的记录之后再增加字段。
日志里的数字是本例桥接与业务层之间约定的结果码。看日志时先核对本轮触发时间,再匹配结果码。对不符合类型的拖放,系统可能在交给应用之前结束协商,应用因此没有生成一条拒绝日志。对重复的纯文本,应用确实收到回调,才能在界面和日志分别留下重复提示。两种情况下卡片数都不变,但问题发生的位置不同,这也是本例同时检查页面与日志的原因。
三个排查点
第一,看松手坐标。拖拽从浏览器开始,跨过中线进入另一个应用的窗口。若只是在摘录列表或左右分隔线上松手,虚线框就没有收到放下事件。这时不应把「日志没出现」直接判断成桥接损坏。打开同一张样页先做一次区内落位,然后只改变最后松手的位置,检查卡片数和最近的导入结果,能把窗口层的问题和数据层的问题拆开。
第二,看浏览器真正选中了什么。长按通常先选出一个词,之后用两端手柄扩选。再去拖时,要从高亮文字的中间起手;如果点在手柄上,手势仍属于修改选区。遇到只摘下来几个字,先比对高亮范围和卡片正文。这个现象与中文在 C++ 层被截断看起来很像,但两者可以区分:选区本来就短时卡片会完整匹配那几个字;如果解码失败,桥接会返回错误,并不会提交一张只有前半段的卡片。
第三,看类型和返回值。浏览器中的插图可能弹出图片操作,也可能发起非文字拖放,这取决于浏览器和页面给出的数据类型。只要样例没有拿到合规的正文,卡片数就应该保持原样。不建议为图方便把接收区改成可收任意类型、再对未知对象调用 toString()。那样就可能把一个对象描述、路径或序列化文本误当成正文。调试更适合用安全的日志记录处理阶段和结果编号,不在日志里转储正文或浏览器选区。
如果更换浏览器、第三方阅读器或者文件管理应用后,拖出端根本没有提供纯文本,接收端就没有办法通过扩大落点解决。可以先从已验证的浏览器样页导入一次,确认自己的应用可用,再用新应用走同一条路径。反过来,若两边都失败,则看宿主是否挂载了允许拖入的组件、该组件在当前窗口有没有被其它层覆盖,以及安装的 HAP 是否与手上的源码相同。这样比一开始就在所有回调里加大段日志更省时间。

复现环境
真机为华为 MatePad Edge(QXS-W00),HarmonyOS 7.0.0.111(SP16C00E111R6P5),系统 API 26。工程的兼容、目标和编译版本均为 API 26。开发机安装的 DevEco Studio 为 6.1.1.300;本文的 HAP 由独立的 API 26 命令行工具构建。两者在这里有不同的作用,IDE 安装版本不能替代构建实际选用的 SDK 版本。跨端依赖使用 Kotlin/Native OHOS 2.2.21-1.2.0、Compose Multiplatform OHOS 1.9.2-1.2.0,鸿蒙宿主包为 @cpf-kmp-cmp/compose 1.9.2-1.2.0;渲染采用 Skia,对应 Skiko 0.9.22.2-1.2.0。
模拟器采用 DevEco Emulator 26.0.0.402 的 Mate X7 配置(PHEMU-FD01,x86_64),HarmonyOS 7.0.0,镜像软件版本 7.0.0.107(SP8DEVC00E999R4P11),API 26。模拟器用于核对构建、安装和应用启动。跨应用拖入、重复投放和图片对照均在 MatePad Edge 上实测。



构建时先在工程根目录运行 Gradle 的共享产物同步任务。该任务生成 ARM64 和 x86_64 两份 Kotlin 动态库及对应头文件,再复制到鸿蒙宿主。进入宿主目录安装 OHPM 依赖并构建 HAP。模拟器和真机使用各自可安装的产物,真机需用与设备和包名匹配的调试签名。工程无需额外申请剪贴板、存储或网络权限;样页在华为浏览器打开,摘录应用自身不访问网络。
读者可以先用一段公开网页文字试拖,或者用工程自带的样页按相同内容复现。为了不把网络抖动混进验证,样页也可以在开发机本地通过 HTTP 启动,再用 HDC 反向转发给测试设备。复现时一次只改一个条件:先导入短句;然后仍用这段文字,改变松手位置;最后保持落点,换成插图。要判断是不是同一条摘录,核对页面显示的原句和卡片数,而不是仅看虚线框有没有闪一下。
同一套代码还可以用另一种方式做回归。让第一张卡片先带一条备注,再从浏览器选第二段。如果屏幕位置改变,按卡片编号核对原备注归属。这个步骤验证的是共享列表更新与编辑状态的对应关系,而不是替代拖拽验证。另一方面,如果只是要确认宿主能处理纯文本,一个带中文、换行和引号的短样例已经足够,比在测试设备上导入真实浏览记录更容易重现,也不会把个人资料带到日志或截图里。
总结
这次拖拽有两条明确的责任线:ArkUI 识别拖放和数据类型,Kotlin 决定这段文字能不能进入摘录列表,Compose 负责把结果显示出来。对同类的跨端应用,最容易复用的是这条窄接口。窗口和拖拽事件留在鸿蒙宿主,传过去的数据只保留业务需要的字段,既方便独立测试,也容易在设备上用一两次对照查出问题落在哪一段。
如果要把它接到读书笔记、工单或信息归档里,建议先确认三个产品决定:接收哪些类型、一次落位生成几条内容、失败要不要保留既有状态。随后各找一例在真机上试出来。分屏里一条短句能完整进入正确的列表、拖错地方没有副作用,比在界面上放几个「支持拖拽」的说明更能证明交互已经接好。
完整代码
摘录库
package dev.excerpt.core
data class Excerpt(val id: Int, val quote: String, val note: String = "")
enum class ImportOutcome(val code: Int) {
Added(1), Blank(0), Duplicate(2), TooLarge(3)
}
/** 无平台依赖:只接收文字,保留正文里的换行;重复只按规范化后的原文判定。 */
class ExcerptBook(private val maxCharacters: Int = 2000) {
private var nextId = 1
var cards: List<Excerpt> = emptyList()
private set
fun add(raw: String): ImportOutcome {
val quote = raw.replace("\r\n", "\n").replace('\r', '\n').trim()
if (quote.isEmpty()) return ImportOutcome.Blank
if (quote.length > maxCharacters) return ImportOutcome.TooLarge
if (cards.any { it.quote == quote }) return ImportOutcome.Duplicate
cards = listOf(Excerpt(nextId++, quote)) + cards
return ImportOutcome.Added
}
fun setNote(id: Int, note: String) {
cards = cards.map { if (it.id == id) it.copy(note = note) else it }
}
}
摘录列表和备注
package dev.excerpt.app
import androidx.compose.foundation.background
import androidx.compose.foundation.border
import androidx.compose.foundation.layout.*
import androidx.compose.foundation.lazy.LazyColumn
import androidx.compose.foundation.lazy.items
import androidx.compose.foundation.shape.RoundedCornerShape
import androidx.compose.material3.MaterialTheme
import androidx.compose.material3.OutlinedTextField
import androidx.compose.material3.OutlinedTextFieldDefaults
import androidx.compose.material3.Text
import androidx.compose.runtime.*
import androidx.compose.ui.Alignment
import androidx.compose.ui.Modifier
import androidx.compose.ui.graphics.Color
import androidx.compose.ui.text.font.FontFamily
import androidx.compose.ui.text.font.FontWeight
import androidx.compose.ui.unit.dp
import androidx.compose.ui.unit.sp
import dev.excerpt.core.ExcerptBook
import dev.excerpt.core.ImportOutcome
private val paper = Color(0xFFF4F7F6)
private val ink = Color(0xFF172B29)
private val muted = Color(0xFF526864)
private val rule = Color(0xFFD4E1DD)
private val teal = Color(0xFF136D5C)
private val highlight = Color(0xFFFFF0B8)
class ExcerptSession {
private val book = ExcerptBook()
var cards by mutableStateOf(book.cards)
private set
fun importText(text: String): Int {
val result = book.add(text)
if (result == ImportOutcome.Added) cards = book.cards
return result.code
}
fun updateNote(id: Int, note: String) {
book.setNote(id, note)
cards = book.cards
}
}
@Composable
fun ExcerptScreen(session: ExcerptSession) {
MaterialTheme {
BoxWithConstraints(Modifier.fillMaxSize().background(paper), contentAlignment = Alignment.TopCenter) {
val wide = maxWidth >= 540.dp
Column(Modifier.widthIn(max = 820.dp).fillMaxWidth().fillMaxHeight()
.padding(horizontal = if (wide) 36.dp else 18.dp)) {
Row(Modifier.fillMaxWidth().padding(top = 16.dp, bottom = 10.dp),
horizontalArrangement = Arrangement.SpaceBetween, verticalAlignment = Alignment.CenterVertically) {
Text("摘录笔记", color = ink, fontSize = 24.sp, fontWeight = FontWeight.Bold)
Text("${session.cards.size} 条", color = teal, fontSize = 13.sp,
modifier = Modifier.background(Color(0xFFE3F1EC), RoundedCornerShape(14.dp))
.padding(horizontal = 10.dp, vertical = 5.dp))
}
Spacer(Modifier.fillMaxWidth().height(1.dp).background(rule))
if (session.cards.isEmpty()) {
Row(
Modifier.fillMaxWidth().padding(top = 14.dp)
.background(Color.White, RoundedCornerShape(12.dp)).padding(18.dp),
horizontalArrangement = Arrangement.spacedBy(13.dp), verticalAlignment = Alignment.CenterVertically
) {
Text("“", color = teal, fontSize = 30.sp, fontFamily = FontFamily.Serif,
modifier = Modifier.background(highlight, RoundedCornerShape(8.dp)).padding(horizontal = 10.dp))
Column(Modifier.weight(1f), verticalArrangement = Arrangement.spacedBy(3.dp)) {
Text("还没有摘录", color = ink, fontSize = 16.sp, fontWeight = FontWeight.Bold)
Text("从浏览器选中文字,拖进上面的区域。", color = muted, fontSize = 13.sp)
}
}
} else {
LazyColumn(Modifier.fillMaxWidth(), contentPadding = PaddingValues(vertical = 14.dp),
verticalArrangement = Arrangement.spacedBy(12.dp)) {
items(session.cards, key = { it.id }) { item ->
val shape = RoundedCornerShape(14.dp)
Column(Modifier.fillMaxWidth().background(Color.White, shape)
.border(1.dp, rule, shape).padding(horizontal = 15.dp, vertical = 14.dp),
verticalArrangement = Arrangement.spacedBy(12.dp)) {
Text("摘录 " + item.id.toString().padStart(2, '0'), color = teal, fontSize = 12.sp,
fontWeight = FontWeight.SemiBold)
Row(Modifier.fillMaxWidth().background(highlight, RoundedCornerShape(8.dp)).padding(11.dp),
horizontalArrangement = Arrangement.spacedBy(8.dp)) {
Text("“", color = teal, fontSize = 20.sp, fontFamily = FontFamily.Serif)
Text(item.quote, Modifier.weight(1f), color = ink, fontSize = 17.sp,
lineHeight = 25.sp, fontFamily = FontFamily.Serif)
}
OutlinedTextField(value = item.note, onValueChange = { session.updateNote(item.id, it) },
modifier = Modifier.fillMaxWidth(), label = { Text("自己的备注") },
maxLines = 3,
colors = OutlinedTextFieldDefaults.colors(focusedBorderColor = teal,
unfocusedBorderColor = rule, focusedLabelColor = teal,
unfocusedLabelColor = muted, focusedTextColor = ink, unfocusedTextColor = ink))
}
}
}
}
}
}
}
}
Kotlin 原生入口
package dev.excerpt.app
import androidx.compose.ui.window.ComposeArkUIViewController
import kotlinx.cinterop.ByteVar
import kotlinx.cinterop.CPointer
import kotlinx.cinterop.ExperimentalForeignApi
import kotlinx.cinterop.readBytes
import kotlinx.coroutines.initMainHandler
import kotlin.experimental.ExperimentalNativeApi
import platform.ArkTS.ArkTS_Napi_NativeModule.napi_env
import platform.ArkTS.ArkTS_Napi_NativeModule.napi_value
private val session = ExcerptSession()
@OptIn(ExperimentalNativeApi::class, ExperimentalForeignApi::class)
@CName("MainArkUIViewController")
fun MainArkUIViewController(env: napi_env): napi_value {
initMainHandler(env)
return ComposeArkUIViewController(env) { ExcerptScreen(session) }
}
@OptIn(ExperimentalNativeApi::class, ExperimentalForeignApi::class)
@CName("SubmitExcerptUtf8")
fun SubmitExcerptUtf8(bytes: CPointer<ByteVar>?, size: Int): Int {
if (size !in 0..12000 || bytes == null) return 3
return try {
session.importText(bytes.readBytes(size).decodeToString(throwOnInvalidSequence = true))
} catch (_: IllegalArgumentException) {
-1
}
}
鸿蒙接收区
import { unifiedDataChannel, uniformDataStruct, uniformTypeDescriptor } from '@kit.ArkData';
import { hilog } from '@kit.PerformanceAnalysisKit';
import { ArkUIViewController, Compose } from '@cpf-kmp-cmp/compose';
import nativeApi from 'libentry.so';
const PLAIN = uniformTypeDescriptor.UniformDataType.PLAIN_TEXT;
@Entry
@Component
struct Index {
private controller?: ArkUIViewController;
@State private hovering: boolean = false;
@State private feedback: string = '在分屏中选中文字,拖到这里';
aboutToAppear(): void {
this.controller = nativeApi.createController();
}
private receive(event: DragEvent): void {
this.hovering = false;
let outcome: number = 0;
try {
const data: unifiedDataChannel.UnifiedData = event.getData();
for (const record of data.getRecords()) {
const entry = record.getEntry(PLAIN) as uniformDataStruct.PlainText | undefined;
if (entry && typeof entry.textContent === 'string' && entry.textContent.trim().length > 0) {
outcome = nativeApi.submitExcerpt(entry.textContent);
break;
}
if (record instanceof unifiedDataChannel.PlainText && record.textContent.trim().length > 0) {
outcome = nativeApi.submitExcerpt(record.textContent);
break;
}
}
} catch {
outcome = -1;
}
event.setResult(outcome === 1 ? DragResult.DRAG_SUCCESSFUL : DragResult.DRAG_FAILED);
// 仅记录结果,正文不进入系统日志。
hilog.info(0x0138, 'SplitExcerpt', 'drop outcome=%{public}d', outcome);
switch (outcome) {
case 1: this.feedback = '已加入摘录'; break;
case 2: this.feedback = '这段文字已摘录'; break;
case 3: this.feedback = '这段文字太长,请缩短选择'; break;
case 0: this.feedback = '这里只接收非空的纯文本'; break;
default: this.feedback = '未能读取拖入内容,请重试'; break;
}
}
build() {
Column() {
Row({ space: 10 }) {
Text('摘').fontSize(15).fontWeight(FontWeight.Bold).fontColor('#163C36')
.width(32).height(32).borderRadius(7).textAlign(TextAlign.Center).backgroundColor('#D0F0DC')
Text('纸边摘录').fontSize(19).fontWeight(FontWeight.Bold).fontColor('#FFFFFF')
}.width('100%').padding({ left: 18, right: 18, top: 9, bottom: 9 }).backgroundColor('#163C36')
Row({ space: 12 }) {
Text('+').fontSize(20).fontWeight(FontWeight.Medium).fontColor('#156957')
.width(34).height(34).textAlign(TextAlign.Center).borderRadius(7).backgroundColor('#D5EEE3')
Column({ space: 3 }) {
Text('放到这里').fontSize(15).fontWeight(FontWeight.Bold).fontColor('#173B33')
Text(this.feedback).fontSize(12).fontColor('#48675E').maxLines(2)
}.layoutWeight(1).alignItems(HorizontalAlign.Start)
}
.id('excerpt-drop-zone')
.width('91%').constraintSize({ maxWidth: 750, minHeight: 70 })
.padding({ left: 12, right: 12, top: 9, bottom: 9 })
.margin({ top: 12 })
.border({ width: this.hovering ? 2 : 1, color: '#287B68', style: BorderStyle.Dashed, radius: 10 })
.backgroundColor(this.hovering ? '#C8EFDB' : '#E7F5EE')
.allowDrop([PLAIN])
.onDragEnter(() => { this.hovering = true; })
.onDragLeave(() => { this.hovering = false; })
.onDrop((event: DragEvent) => { this.receive(event); })
if (this.controller) {
Compose({ controller: this.controller, libraryName: 'entry' })
.width('100%').layoutWeight(1);
}
}.width('100%').height('100%').backgroundColor('#F4F7F6');
}
}
N-API 桥接
#include "libkn_api.h"
#include "napi/native_api.h"
#include <vector>
namespace {
napi_value Result(napi_env env, int code)
{
napi_value value = nullptr;
napi_create_int32(env, code, &value);
return value;
}
napi_value CreateController(napi_env env, napi_callback_info)
{
return reinterpret_cast<napi_value>(MainArkUIViewController(env));
}
napi_value Submit(napi_env env, napi_callback_info info)
{
size_t count = 1;
napi_value args[1] = {};
size_t bytes = 0;
if (napi_get_cb_info(env, info, &count, args, nullptr, nullptr) != napi_ok ||
count != 1 || napi_get_value_string_utf8(env, args[0], nullptr, 0, &bytes) != napi_ok) {
return Result(env, -1);
}
if (bytes > 12000) return Result(env, 3);
// 向 Kotlin 传实际字节数,避免把多字节字符当成等长的字符数组。
std::vector<char> data(bytes + 1);
size_t written = 0;
if (napi_get_value_string_utf8(env, args[0], data.data(), data.size(), &written) != napi_ok ||
written != bytes) {
return Result(env, -1);
}
return Result(env, SubmitExcerptUtf8(data.data(), static_cast<int>(written)));
}
napi_value Init(napi_env env, napi_value exports)
{
androidx_compose_ui_arkui_init(env, exports);
napi_property_descriptor members[] = {
{"createController", nullptr, CreateController, nullptr, nullptr, nullptr, napi_default, nullptr},
{"submitExcerpt", nullptr, Submit, nullptr, nullptr, nullptr, napi_default, nullptr},
};
napi_define_properties(env, exports, 2, members);
return exports;
}
}
static napi_module module = {1, 0, nullptr, Init, "entry", nullptr, {0}};
extern "C" __attribute__((constructor)) void RegisterEntryModule()
{
napi_module_register(&module);
}
桥接声明
import type { ArkUIViewController } from '@cpf-kmp-cmp/compose/src/main/cpp/types/libcompose_arkui_utils';
export const createController: () => ArkUIViewController;
export const submitExcerpt: (text: string) => number;
Ability 入口
import { UIAbility } from '@kit.AbilityKit';
import { window } from '@kit.ArkUI';
export default class EntryAbility extends UIAbility {
onWindowStageCreate(stage: window.WindowStage): void {
stage.loadContent('pages/Index');
}
}
KMP 模块配置
plugins {
alias(libs.plugins.kotlinMultiplatform)
}
kotlin {
ohosArm64()
ohosX64()
}
双 ABI 编译
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(projects.excerptCore)
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/")
}
}
}
应用 SDK 配置
{
"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



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



