更新记录

1.1.4(2026-04-02)

  • 修复 uts-proxy 导出缺失问题:在各平台入口补齐统一 API 导出(canIShare / normalizeShareFiles / share / shareText / shareUrl / shareFile / shareWithSystem)。
  • 修复 UTS 编译兼容问题:错误对象 cause 类型统一为 UTSError | null
  • 修复 iOS 扫码端语法兼容问题(VNImageRequestHandler 初始化参数语法)。

1.0.0(2026-03-19)

  • 首次发布 lizhao-share-plus
  • 提供 API + 组件双形态系统分享能力。
  • 支持文本、链接、单文件、多文件与远程文件下载后分享。
  • 提供统一错误码与全平台适配策略(App/H5/微信小程序)。

平台兼容性

uni-app(4.84)

Vue2 Vue3 Chrome Safari app-vue app-nvue Android iOS 鸿蒙
- - -
微信小程序 支付宝小程序 抖音小程序 百度小程序 快手小程序 京东小程序 鸿蒙元服务 QQ小程序 飞书小程序 小红书小程序 快应用-华为 快应用-联盟
- - - - - - - - - - - -

uni-app x(4.84)

Chrome Safari Android iOS 鸿蒙 微信小程序
- - - -

lizhao-share-plus

lizhao-share-plus 是纯 UTS 形态的系统分享 API 插件,统一了参数结构、错误码与平台分发入口,支持在 uni-app 与 uni-app x 中通过同一导入路径调用。

支持平台

平台 是否支持 说明
uni-app Vue2/Vue3 可调用
uni-app x App 侧可调用
Android 使用原生 Intent 打开系统分享面板,completed=true
iOS 使用原生 UIActivityViewController 打开系统分享面板,completed=true
Harmony 当前返回 9011001(明确不支持)
Web 返回 9011001
微信小程序 返回 9011001
支付宝小程序 返回 9011001

安装说明

import * as LizhaoSharePlus from '@/uni_modules/lizhao-share-plus'

API 列表

  • canIShare(options)
  • normalizeShareFiles(options)
  • share(options)
  • shareText(options)
  • shareUrl(options)
  • shareFile(options)
  • shareWithSystem(options)

参数说明

ShareOptions

参数 类型 必填 说明 默认值 可选参数
options ShareOptions 分享参数对象 text / title / subject / url / file / files / mimeType / autoDownloadRemote / downloadDir / fileNameStrategy / targetPackage / chooserTitle / excludedActivityTypes / success / fail / complete
options.text string 分享文本
options.title string 分享标题
options.subject string 邮件主题等扩展字段
options.url string 分享链接,仅支持 http/https
options.file string 单文件路径
options.files string[] 多文件路径
options.mimeType string 文件 MIME 类型 */*
options.autoDownloadRemote boolean 是否自动下载远程文件 true true / false
options.downloadDir string 下载目录
options.fileNameStrategy string 远程文件命名策略 keep keep / hash / timestamp
options.targetPackage string Android 目标包名
options.chooserTitle string Android 分享面板标题
options.excludedActivityTypes string[] iOS 排除渠道
options.success function 成功回调
options.fail function 失败回调
options.complete function 完成回调

ShareWithSystemOptions

参数 类型 必填 说明 默认值 可选参数
options ShareWithSystemOptions 兼容调用参数对象 type / title / summary / text / url / path / mimeType / fileNameStrategy / targetPackage / chooserTitle / excludedActivityTypes / success / fail / complete
options.type string 兼容模式类型 file text / image / video / file
options.path string 文件路径

返回值说明

字段 类型 说明
platform string 实际处理平台标识
completed boolean 是否已完成实际系统分享
activityType string iOS 渠道类型
targetPackage string Android 目标包名
filesResolved Array 文件归一化结果

错误码说明

错误码 含义 说明
9011001 platform unsupported 当前平台不支持
9011002 invalid options 参数不合法
9011003 file not found 文件不存在
9011004 remote download failed 远程下载失败
9011005 app not found 目标应用不存在
9011006 user cancel 用户取消
9011007 permission denied 权限不足
9011008 system error 系统错误
9011009 not implemented 预留实现尚未接入

权限说明

  • Android:按目标分享链路要求配置(文件分享需文件可访问)
  • iOS:按目标分享链路要求配置(如涉及相册/文件访问需配置系统权限)
  • Harmony:当前不支持,无需额外权限

自定义基座说明

当前版本未引入三方原生 SDK。 如后续接入原生分享 SDK(新增依赖、权限、Manifest/Info.plist 变更),需要重新制作自定义基座。

使用示例

uni-app 调用示例

import * as LizhaoSharePlus from '@/uni_modules/lizhao-share-plus'

LizhaoSharePlus.shareText({
  title: '分享标题',
  text: '这是文本分享示例',
  success(res) {
    console.log('shareText success', res)
  },
  fail(err) {
    console.error('shareText fail', err)
  },
  complete(payload) {
    console.log('shareText complete', payload)
  }
})

uni-app x 调用示例

import * as LizhaoSharePlus from '@/uni_modules/lizhao-share-plus'

LizhaoSharePlus.shareWithSystem({
  type: 'file',
  title: '分享到',
  summary: '兼容模式文件分享',
  path: '/storage/emulated/0/Download/demo.pdf',
  success(res) {
    console.log('shareWithSystem success', res)
  },
  fail(err) {
    console.error('shareWithSystem fail', err)
  }
})

验收清单

发布前请按 verification-checklist.md 逐项回归。

注意事项

  1. Android/iOS 已接入系统分享面板;Harmony 当前明确返回 9011001(不支持)。
  2. Web/微信小程序/支付宝小程序当前返回 9011001,不会静默成功。
  3. 页面中请统一使用 import * as LizhaoSharePlus from '@/uni_modules/lizhao-share-plus' 调用。

隐私、权限声明

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

按目标平台分享能力要求

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

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

暂无用户评论。