更新记录
1.0.0(2026-11-19)
首次发布:完成 Android / HarmonyOS 双端实现与真机验证。
平台兼容性
uni-app x(4.25)
| Chrome |
Safari |
Android |
iOS |
鸿蒙 |
微信小程序 |
| × |
× |
√ |
× |
√ |
× |
其他
| 多语言 |
暗黑模式 |
宽屏模式 |
蒸汽模式 |
| × |
× |
× |
√ |
uni-share-plus · 系统分享增强
一套 API 搞定 App 内分享:文本分享、图片分享、复制到剪贴板。纯系统 API,无三方 SDK,标准基座即可运行。
为什么需要它
- 内置分享能力分散、回调不统一,图片分享还要自己处理
FileProvider
- 本插件把「分享文本 / 分享图片 / 复制文本」收敛成同一套 Promise 风格回调,并统一错误码
- 图片分享自动落系统媒体库再中转,无需在工程里声明 FileProvider、无需存储权限(Android 10+)
平台支持
| 平台 |
文本分享 |
图片分享 |
复制 |
| Android 5.0+ |
✅ |
✅ |
✅ |
| 鸿蒙 |
✅ |
⚠️ 依赖系统版本 |
✅ |
| iOS |
规划中 |
规划中 |
规划中 |
快速开始
import { shareText, shareImage, copyText } from '@/uni_modules/uni-share-plus'
// 分享文本
shareText({ text: '这段内容来自 uni-share-plus', title: '分享到' })
// 分享图片(本地绝对路径)
shareImage({ path: '/storage/emulated/0/DCIM/a.jpg', text: '看这张图' })
// 复制到剪贴板
copyText({ text: '邀请码 ABC123' })
API
| 方法 |
说明 |
shareText(options) |
分享文本,可选 subject / title / targetPackage |
shareImage(options) |
分享本地图片,可选 text / title |
copyText(options) |
复制文本到系统剪贴板 |
diagnose(options) |
返回各能力可用性与系统版本,用于降级判断 |
回调统一为 success / fail / complete,失败时 err 含 errCode 与 errMsg。
错误码
| 错误码 |
含义 |
| 9070001 |
参数错误 |
| 9070002 |
文件不存在或不可读 |
| 9070003 |
分享失败 |
| 9070004 |
没有可用的分享应用 |
| 9070005 |
复制失败 |
| 9070006 |
当前平台不支持 |
| 9070007 |
内部错误 |
注意事项
- 图片分享只接受本机可读的绝对路径;网络图片请先下载到本地
- 指定
targetPackage 时若目标应用未安装,会自动回退到系统分享面板
- 分享面板由系统提供,样式不可定制,这是系统行为