logo
积分中心
从分享入口到内容接收:HarmonyOS Share Kit跨端分享完整链路实践 原创
头像 宋木子101 2026-11-12 11:52:01    发布
0 浏览 0 收藏

在为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交互模块、接收处理模块和业务路由模块。这样,当以后增加图片、视频、超链接等数据类型时,就可以复用已有的接收框架。

真正稳定的分享体验,不是发送端显示了成功提示,而是从内容选择、数据构造、设备交互、数据接收一直到业务页面打开,整个流程都能正确完成。

©本站发布的所有内容,包括但不限于文字、图片、音频、视频、图表、标志、标识、广告、商标、商号、域名、软件、程序等,除特别标明外,均来源于网络或用户投稿,版权归原作者或原出处所有。我们致力于保护原作者版权,若涉及版权问题,请及时联系我们进行处理。
分类
HarmonyOS

暂无评论数据

加载中...

发布

地址:北京市朝阳区北三环东路三元桥曙光西里甲1号第三置业A座1508室 电话:13391790444或(010)62178877
版权所有:电脑商情信息服务集团 北京赢邦策略咨询有限责任公司
声明:本媒体部分图片、文章来源于网络,版权归原作者所有,我司致力于保护作者版权,如有侵权,请与我司联系删除

京ICP备:2022009079号-2

京公网安备:11010502051901号

ICP证:京B2-20230255