HarmonyOS 鸿蒙Next 调用系统分享功能

系统分享

介绍

手机使用系统分享API，分享图片或文字，这里重点展示分享图片的效果。

系统分享源码链接

使用说明

1. 点击“查看并下载图片”按钮，从网络上下载图片。
2. 点击“系统分享”按钮，选择图片，在底部选择shareget可拉起接受方应用，分享图片。

实现效果

实现思路

分享图片

使用request.downloadFile接口，根据开发者自己设定的图片网址下载图片。构造分享数据，首先配置一条有效数据信息，获取待分享图片的沙箱路径，使用fileUri.getUriFromPath接口将沙箱路径转为文件URI，最后启动分享面板分享图片。核心代码如下，源码参考

Index.ets

TestSystemShare() {
    // 构造ShareData，需配置一条有效数据信息
    let data: systemShare.SharedData = new systemShare.SharedData({
      utd: utd.UniformDataType.PLAIN_TEXT,
      content: 'Hello HarmonyOS'
    });
    // 获取文件的沙箱路径
    let pathInSandbox = this.context.filesDir + '/test.jpg';
    // 将沙箱路径转换为uri
    let uri = fileUri.getUriFromPath(pathInSandbox);
    // 添加多条记录
    data.addRecord({
      utd: utd.UniformDataType.PNG,
      uri: uri
    });
    // 构建ShareController
    let controller: systemShare.ShareController = new systemShare.ShareController(data);
    // 注册分享面板关闭监听
    controller.on('dismiss', () => {
      hilog.info(0x0001,"JSAPP",'TestShare Share panel closed');
      // 分享结束，可处理其他业务。
    });
    // 进行分享面板显示
    controller.show(this.context, {
      previewMode: systemShare.SharePreviewMode.DETAIL,
      selectionMode: systemShare.SelectionMode.SINGLE
    });
  }

工程结构&模块类型

└──entry                                          // 入口模块
   └──src/main/ets
      ├──entryability
      │  └──EntryAbility.ets                      // 入口
      └──pages
          └──Index.ets                            // 首页，下载和分享逻辑

相关权限

使用网络权限：ohos.permission.INTERNET, 主要是为了下载网络图片，本地资源分享不需要网络权限。

约束与限制

1. 本示例仅支持标准系统上运行，支持设备：华为手机。
2. HarmonyOS系统：HarmonyOS NEXT Developer Beta1及以上。
3. DevEco Studio版本：DevEco Studio NEXT Developer Beta1及以上。
4. HarmonyOS SDK版本：HarmonyOS NEXT Developer Beta1 SDK及以上。
5. 要正常使用，还需要被分享方配合，参考应用内处理分享内容。

参考资料

手机应用发起系统分享