更新记录

1.0.0(2026-11-17)

  • 首次发布,包含 Android / iOS / HarmonyOS 系统分享,支持文本与本地文件分享。

平台兼容性

uni-app(5.34)

Vue2 Vue3 Chrome Safari app-vue app-nvue Android iOS 鸿蒙
- √ × × √ - √ 12 HarmonyOS NEXT
微信小程序 支付宝小程序 抖音小程序 百度小程序 快手小程序 京东小程序 鸿蒙元服务 QQ小程序 飞书小程序 小红书小程序 快应用-华为 快应用-联盟
× × × × × × × × × × × ×

x-system-share

调起系统分享面板的 UTS 插件,支持 Android / iOS / HarmonyOS 三端的文本与本地文件分享(图片 / Excel / PDF 等)。

只做两件事:shareText 与 shareFile。不内置下载,远程文件请调用方先 uni.downloadFile 拿到本地路径再分享。

授权与安装

授权 价格 交付
普通授权版 9.90 元 核心实现加密
源码授权版 99.00 元 提供插件源码,可按市场授权约定修改

两种授权包含相同的 Android / iOS / HarmonyOS 实现,不按平台删减功能;区别是实现源码是否可见、可修改。通过插件市场购买时,授权绑定项目 AppID 和包名,源码授权不代表不限项目使用。

从插件市场导入,或将插件目录放到项目的 uni_modules/x-system-share。首发面向 HBuilderX 5.34 及以上正式版、uni-app Vue3;iOS 原生配置最低 iOS 12,宿主运行环境要求更高时以宿主为准。HarmonyOS 指 HarmonyOS NEXT 原生应用。Vue2、nvue、uni-app x 不作支持承诺。

Android / iOS 导入后需制作包含本插件的自定义调试基座。市场加密插件及试用版使用云端传统打包,不支持安心打包和离线打包;试用版不用于正式发行。鸿蒙编译运行需完成宿主项目的 DevEco Studio 环境和签名配置。加密交付方式遵循 DCloud 插件市场规则。

平台支持

平台 底层能力 接入说明
Android Intent.ACTION_SEND + Intent.createChooser 使用内置 FileProvider 提供临时文件访问权限,无需自行配置 Provider
iOS UIActivityViewController 在主线程展示分享面板,已配置 iPad Popover
HarmonyOS @kit.ShareKit 的 systemShare 按扩展名设置 UTD 数据类型,供系统匹配接收应用

H5 / 小程序不支持,调用处需用条件编译隔离:#ifdef APP-PLUS || APP-HARMONY。

使用情况

系统分享至各接收应用的结果如下,接收能力也受接收应用及其版本影响:

平台 接收应用 文本 图片 文件
iOS 微信 不支持 正常 正常
iOS 企业微信 正常 正常 正常
HarmonyOS 微信 正常 正常 正常
HarmonyOS 企业微信 正常 正常 正常
Android 微信 正常 正常 正常
Android 企业微信 正常 正常 正常

iOS 纯文本分享到微信的解决方案

如需在 iOS 将纯文本分享到微信,需要接入并配置微信 SDK。系统分享渠道在 iOS 分享到微信时要求携带链接,不能仅靠包装纯文本解决,参考 DCloud 分享说明。

iOS 文件分享到微信提示异常

微信未打开时,分享文件可能提示“发生异常,无法分享”。先打开微信,再返回 APP 重新分享。

遇到相同现象时,先打开微信再重新分享;也可使用系统“文件”App 分享同一文件,对比是否为接收应用的问题。


API

shareText(options)

字段 类型 必填 说明
text string 是 要分享的文本
title string 否 面板标题。Android 是 chooser 标题,鸿蒙是 SharedData.title,iOS 无此概念,默认「分享」
success () => void 否 面板已唤起
fail (err: ShareFail) => void 否 见错误码

shareFile(options)

字段 类型 必填 说明
path string 是 本地文件路径,支持 _doc/ 相对路径、绝对路径、file://
fileName string 否 不填则取 path 末段。Android 只用它推断 MIME,iOS 不生效,鸿蒙作为面板标题
title string 否 同上
success () => void 否 面板已唤起
fail (err: ShareFail) => void 否 见错误码

错误码

errCode errMsg 触发场景
9020001 分享内容为空 text 或 path 传了空串
9020002 文件不存在或不可读 路径指向的文件不存在
9020003 唤起系统分享失败 系统 API 抛异常

success 的语义

success 只代表系统分享面板已成功唤起,不代表用户已完成分享。用户关闭面板或取消操作,也可能已经触发 success。


使用示例

// #ifdef APP-PLUS || APP-HARMONY
import { shareText, shareFile } from '@/uni_modules/x-system-share'
// #endif

// 分享文本
shareText({
  text: '这是一段要分享的文本',
  success: () => console.log('面板已唤起'),
  fail: (err) => console.error(err.errCode, err.errMsg)
})

// 分享远程 Excel:先下后享
uni.downloadFile({
  url: 'https://example.com/报表.xlsx',
  success: (res) => {
    shareFile({
      path: res.tempFilePath,
      fileName: '报表.xlsx',
      fail: (err) => console.error(err.errCode, err.errMsg)
    })
  }
})

隐私与反馈

插件不采集任何数据,不自行上传文件,不向服务器发送分享内容,不包含广告。Android 通过 FileProvider 仅向接收应用授予所分享文件的临时读取权限;分享内容由用户选择的接收应用处理。

请通过插件市场评论或 uni-im 反馈,提供 HBuilderX 版本、系统版本、接收应用版本、错误信息和复现步骤,不要提供账号凭证或包含敏感内容的文件。

隐私、权限声明

1. 本插件需要申请的系统权限列表:

不申请额外系统权限。Android 通过 FileProvider 向用户选择的接收应用授予所分享文件的临时读取权限。

2. 本插件采集的数据、发送的服务器地址、以及数据用途说明:

插件不采集任何数据,不自行上传文件或向服务器发送内容。分享内容由用户选择的接收应用处理。

3. 本插件是否包含广告,如包含需详细说明广告表达方式、展示频率:

无