更新记录

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 需宿主允许明文网络

texturlimage 至少传一项。传入远程图片时,插件会先下载图片,再弹出系统分享面板;下载失败会触发 onFailonClose

回调

回调 说明
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 原生配置

隐私、权限声明

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

Android 和 iOS 均不申请额外系统权限

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

插件不采集、不上传数据;远程图片请求仅访问调用方传入的图片地址

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

暂无用户评论。