更新记录
1.0.3(2026-08-20)
新增优化ios的吊起时间 建议不要分享图片,否在在ios上面会比较慢,因为要先下载图片,可以预加载
平台兼容性
uni-app(4.71)
| Vue2 | Vue3 | Chrome | Safari | app-vue | app-nvue | Android | iOS | 鸿蒙 |
|---|---|---|---|---|---|---|---|---|
| √ | √ | × | × | √ | √ | √ | √ | × |
| 微信小程序 | 支付宝小程序 | 抖音小程序 | 百度小程序 | 快手小程序 | 京东小程序 | 鸿蒙元服务 | QQ小程序 | 飞书小程序 | 小红书小程序 | 快应用-华为 | 快应用-联盟 |
|---|---|---|---|---|---|---|---|---|---|---|---|
| × | × | × | × | × | × | × | × | × | × | × | × |
其他
| 多语言 | 暗黑模式 | 宽屏模式 |
|---|---|---|
| × | × | √ |
asrmall-system-share
调起 Android/iOS 系统原生分享面板,支持商品文案、详情页链接和商品图片。
使用
import { shareSystem } from '@/uni_modules/asrmall-system-share'
shareSystem({
title: '分享商品',
subject: 'ASRMALL 商品推荐',
text: '这件商品值得看看',
url: 'https://h5.asrmall.com/pages/shop/shopdetail/123',
image: 'https://example.com/product.jpg',
onOpen(result) {
console.log('系统分享面板已弹出', result.platform)
},
onSuccess(result) {
console.log('已选择分享目标', result.activityType)
},
onClose(result) {
console.log('分享面板已结束', result.reason, result.completed)
},
onFail(error) {
console.error('分享失败', error.code, error.message)
}
})
参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| title | string | 否 | Android 系统分享面板标题,默认“分享” |
| subject | string | 否 | 邮件等支持主题的应用使用 |
| text | string | 条件必填 | 分享文案 |
| url | string | 条件必填 | 商品详情页完整链接 |
| image | string | 条件必填 | https、file:// 或本地绝对路径;Android 还支持 content://;http 需宿主允许明文网络 |
text、url、image 至少传一项。传入远程图片时,插件会先下载图片,再弹出系统分享面板;下载失败会触发 onFail 和 onClose。
回调
| 回调 | 说明 |
|---|---|
| onOpen | 系统分享面板已成功弹出 |
| onSuccess | 用户已选择分享目标 |
| onClose | 分享流程结束,reason 为 success、cancel 或 fail |
| onFail | 参数、图片下载或系统面板启动失败 |
Android 系统只能确认用户选择了分享目标,无法确认 WhatsApp、邮件等第三方应用最终是否成功发送,因此 Android 的 onSuccess 表示“已选择分享目标”,activityType 当前可能为空字符串。iOS 的结果来自 UIActivityViewController 完成回调。
Android 5.1(API 22)及以上支持目标选择回调。
本地图片
建议先通过 uni.getImageInfo 获取 path,再把该绝对路径传给 image。Android 会把图片复制到私有缓存并通过临时 URI 分享;iOS 会安全下采样后交给系统分享面板。两端都不需要相册或存储权限,单张图片最大 25MB。
错误码
| code | 说明 |
|---|---|
| EMPTY_CONTENT | text、url、image 均为空 |
| IMAGE_PREPARE_FAILED | 图片不存在、无法读取、下载失败或超过 25MB |
| CUSTOM_BASE_OUTDATED | 当前 Android 自定义基座未包含插件 Provider,需要重新制作并安装基座 |
| NO_ACTIVITY | Android 当前没有可用 Activity |
| HOST_DESTROYED | Android 分享期间宿主 Activity 被销毁 |
| OPEN_FAILED | Android 系统分享面板启动失败 |
| NO_VIEW_CONTROLLER | iOS 当前没有可用 UIViewController |
| PRESENT_FAILED | iOS 系统分享面板未成功展示 |
| SHARE_FAILED | iOS 分享目标返回错误 |
| SHARE_IN_PROGRESS | 已有分享流程正在处理 |
| INVALID_OPTIONS | iOS 原生层无法解析参数 |
平台要求
- Android 5.1(API 22)及以上
- iOS 15.0 及以上
- 需要自定义基座或云打包,标准基座不包含本地新增的 UTS 原生插件
- 新增或修改插件的 AndroidManifest.xml、res 或依赖后,必须重新制作并安装自定义基座,普通热更新不会更新 APK 原生配置

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