在APP中,分享是一个非常常见的操作。看到一篇有价值的文章,想推荐给朋友;发现一张好看的图片,想立即传给身边的人;浏览到一个商品,希望同事也能快速查看。传统分享通常需要点击分享按钮,再选择应用或者联系人。对于面对面交流的场景,这套操作流程还有进一步简化的空间。
HarmonyOS Share Kit提供的手机与手机碰一碰分享能力,让用户可以通过设备轻碰发起内容传递。对于开发者来说,接入这项能力并不意味着需要重新开发一套设备发现和连接流程,而是通过Share Kit注册碰一碰分享事件,在系统触发回调后准备分享数据,再交给系统完成后续交互。
这次以资讯类APP为例,为文章详情页增加碰一碰分享。用户打开一篇文章,与朋友手机顶部轻碰,就可以将当前文章分享出去。首先需要明确的是,应用必须知道当前页面正在展示什么内容。不能在碰一碰回调中始终发送固定链接,而应该根据当前页面状态动态构造分享数据。
HarmonyOS提供的核心接口来自Share Kit。下面是注册碰一碰事件并构造链接分享数据的基本代码:
import { uniformTypeDescriptor as utd } from '@kit.ArkData';
import { harmonyShare, systemShare } from '@kit.ShareKit';
aboutToAppear(): void {
harmonyShare.on('knockShare', this.onKnockShare);
}
private onKnockShare =
(target: harmonyShare.SharableTarget): void => {
const shareData: systemShare.SharedData =
new systemShare.SharedData({
utd: utd.UniformDataType.HYPERLINK,
content: 'https://example.com/article/1001',
title: 'HarmonyOS开发实践',
description: '一篇关于跨设备分享的技术文章'
});
target.share(shareData);
};
这里使用了knockShare事件监听系统触发的碰一碰分享。回调参数SharableTarget代表本次分享的目标对象,应用通过share()方法提交准备好的数据。示例中的链接、标题和描述都是演示内容,实际开发时应该替换成当前文章的数据。
如果分享的是文章链接,建议同时提供标题、描述和预览图。这样系统可以根据分享数据生成更合适的卡片,而不是只展示一段普通链接。预览图可以通过本地文件URI传入,开发者需要确保文件已经准备完成并且能够正常读取。
import { fileUri } from '@kit.CoreFileKit';
const shareData: systemShare.SharedData =
new systemShare.SharedData({
utd: utd.UniformDataType.HYPERLINK,
content: article.shareUrl,
title: article.title,
description: article.summary,
thumbnailUri: fileUri.getUriFromPath(
article.coverLocalPath
)
});
target.share(shareData);
需要注意,coverLocalPath必须是已经准备好的本地图片路径。如果封面图片还在云端下载,不建议在碰一碰回调中等待较长时间。可以先发送核心分享数据,待预览图下载完成后,再使用updateShareData()更新卡片内容。这样可以降低分享回调超时的风险。
碰一碰分享事件也不是注册之后就不再管理。用户离开文章详情页后,应用应该及时解除监听,避免其他页面仍然响应之前的分享逻辑。
aboutToDisappear(): void {
harmonyShare.off('knockShare', this.onKnockShare);
}
接收端同样需要考虑。对于链接分享,建议使用App Linking实现内容直达。应用已经安装时,可以进入对应文章详情页;没有安装时,则可以根据链接服务的配置进入网页或者应用市场。这样分享不仅完成了设备间的数据传递,还能将用户直接带到目标内容。
还有一个容易忽略的地方:如果当前界面没有可以分享的内容,就应该及时终止本次分享。HarmonyOS提供了clarifyNonShare()用于向用户说明当前页面不支持分享,避免用户一直等待。
target.clarifyNonShare({
message: '请进入文章详情页后再进行分享'
});
在实际项目中,我建议将碰一碰分享封装为独立的业务模块,文章页只负责提供标题、摘要、链接和封面等数据,分享模块负责构造SharedData并提交给Share Kit。这样以后增加商品、课程、活动等分享类型时,就不需要在每个页面重复编写系统交互逻辑。
碰一碰分享真正值得关注的地方,是它让APP中的内容能够以更自然的方式进入用户之间的交流。对于资讯、阅读、教育和社交类应用,可以先从内容详情页接入,再逐步扩展到更多高频业务入口。
暂无评论数据
发布
相关推荐
22
0
34
0
16
0
22
0
29
0hot moon
我还没有写个人简介......
帖子
提问
粉丝
让AI开发真正融入日常工程:HarmonyOS开发助手模型配置与IDE协同实践
2026-11-12 11:36:52 发布



京公网安备:11010502051901号