宋木子101
2026-11-12 11:52:01 发布在为APP接入分享能力时,开发者经常会遇到一个问题:发送端已经能够正常提交数据,但接收端却没有按照预期打开内容。原因往往不是单一接口调用错误,而是分享链路中缺少了数据类型声明、接收能力注册、资源保存和业务路由等环节。
HarmonyOS Share Kit提供了分享发送与接收的能力。开发者需要从整个链路出发,分别设计发送端和接收端,而不是只在一个页面中调用分享接口。
这次以一个文件管理APP为例,设计一份PDF资料从手机发送到另一台设备的流程。
发送端首先需要准备文件URI。假设PDF已经保存在应用沙箱中,可以使用Core File Kit将本地路径转换为URI。
import { fileUri } from '@kit.CoreFileKit';
private getPdfUri(path: string): string {
return fileUri.getUriFromPath(path);
}接下来构造分享数据。数据类型需要与真实文件格式一致,不能将PDF错误声明为图片或者普通文本。
import { uniformTypeDescriptor as utd } from '@kit.ArkData';
import { systemShare } from '@kit.ShareKit';
private buildPdfData(path: string): systemShare.SharedData {
return new systemShare.SharedData({
utd: utd.UniformDataType.PDF,
uri: this.getPdfUri(path)
});
}在碰一碰分享事件回调中,提交数据:
private onKnockShare =
(target: harmonyShare.SharableTarget): void => {
if (!this.currentPdfPath) {
target.clarifyNonShare({
message: '当前没有可分享的PDF文件'
});
return;
}
target.share(
this.buildPdfData(this.currentPdfPath)
);
};发送端完成数据准备之后,接收端需要提前声明支持的文件类型。以PDF为例,可以在接收能力注册时配置对应UTD和最大接收数量。
const registry: harmonyShare.RecvCapabilityRegistry = {
windowId: this.getWindowId(),
capabilities: [{
utd: utd.UniformDataType.PDF,
maxSupportedCount: 1
}]
};
harmonyShare.on(
'dataReceive',
registry,
this.onReceivePdf
);接收数据时,通过receive()将内容保存到指定目录,并根据返回结果更新界面状态。
private onReceivePdf =
(target: harmonyShare.ReceivableTarget): void => {
const context = this.getUIContext()
.getHostContext() as common.UIAbilityContext;
const destination = fileUri.getUriFromPath(
context.filesDir
);
target.receive(destination, {
onDataReceived: (data: systemShare.SharedData) => {
this.processReceivedPdf(data);
},
onResult: (result: harmonyShare.ShareResultCode) => {
this.updateReceiveState(result);
}
});
};这里的processReceivedPdf()和updateReceiveState()需要由应用自己实现,分别承担文件处理和状态更新职责。
整个链路中,还有几个细节值得重点检查。
第一,发送端提供的URI必须在分享时有效。对于临时文件,应用不能在系统完成读取之前就删除它。第二,接收端声明的数据类型需要与实际支持的内容保持一致。如果应用只支持PDF,就不应该声明自己可以接收所有文件类型。第三,分享失败时需要有合理的异常处理,例如资源不存在、文件无法读取、接收空间不足等情况。
此外,分享过程中还需要考虑用户取消操作。应用不能把用户取消理解为程序崩溃,也不应该在取消之后继续执行后续业务逻辑。
建议将分享链路拆成几个独立模块:数据准备模块、Share Kit交互模块、接收处理模块和业务路由模块。这样,当以后增加图片、视频、超链接等数据类型时,就可以复用已有的接收框架。
真正稳定的分享体验,不是发送端显示了成功提示,而是从内容选择、数据构造、设备交互、数据接收一直到业务页面打开,整个流程都能正确完成。
暂无评论数据
发布
相关推荐
KevinChaos
57
0
KevinChaos
124
0
KevinChaos
403
0
鸿蒙小助手
618
0
鸿蒙小助手
610
0
宋木子101
我还没有写个人简介......
帖子
提问
粉丝
HarmonyOS 7 实战:接入 Core Vision Kit,实现 APP 图片通用文字识别
2026-11-12 11:54:31 发布让分享成为APP的自然交互:HarmonyOS碰一碰与隔空传送全场景融合实践
2026-11-12 11:53:03 发布


京公网安备:11010502051901号