更新记录
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 逐项回归。
注意事项
- Android/iOS 已接入系统分享面板;Harmony 当前明确返回
9011001(不支持)。
- Web/微信小程序/支付宝小程序当前返回
9011001,不会静默成功。
- 页面中请统一使用
import * as LizhaoSharePlus from '@/uni_modules/lizhao-share-plus' 调用。