更新记录

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 时若目标应用未安装,会自动回退到系统分享面板
  • 分享面板由系统提供,样式不可定制,这是系统行为

隐私、权限声明

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

图片分享会写入系统媒体库(Android 10+ 无需存储权限);最低支持 Android 5.0 (API 21)

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

插件不采集、不上传任何内容,分享与复制均在本机完成

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

无

暂无用户评论。