更新记录
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 版本、系统版本、接收应用版本、错误信息和复现步骤,不要提供账号凭证或包含敏感内容的文件。

收藏人数:
购买源码授权版(
试用
赞赏(0)
下载 1
赞赏 0
下载 12770518
赞赏 1959
赞赏
京公网安备:11010802035340号