更新记录

1.1.13（2026-09-06）

• 归并 uni-app x Android 示例修复：分享入口使用公开 Options 类型构造并保留三类回调，避免工厂对象被错误转换；版本号保持 1.1.13。
• 新增 HarmonyOS 本地多文件系统分享，现有 shareFile({ files }) 调用无需修改，单次最多分享 500 个本地文件。
• 任一文件不存在或不可读取时整体失败，不会拉起内容不完整的分享面板；远程文件和指定目标应用仍保持原有提示。
• 升级后需要重新构建并安装 HarmonyOS HAP；Android、iOS 的现有调用和能力不受影响。

1.1.12（2026-09-01）

• 新增 HarmonyOS 本地单文件系统分享，项目内静态资源、应用沙箱文件和有效文件 URI 均可沿用现有 shareFile 调用。
• 文件不存在时返回 9011003；HarmonyOS 多文件、远程文件和指定目标应用分享仍明确返回 9011001。
• 升级后无需修改现有文本、链接或单文件调用代码；需要重新构建并安装 HarmonyOS HAP。

1.1.11（2026-08-03）

• 新增 HarmonyOS 原生文本与链接系统分享：通过系统 ShareController 与统一数据类型传递标题、摘要和链接，并保持 success/fail/complete 回调一致。
• 补齐 HarmonyOS 能力探测、分享前预检和文件归一化；文件分享因仍需 URI 授权桥接而明确返回 9011001，不伪造成功。
• 修正示例自动导入入口，uni-app 与 uni-app x 分别指向各自真实存在的示例页，并在 uni-app x 示例中补齐 complete 回调验收日志。
• 新增 HarmonyOS 分享专项守卫，并同步更新平台支持边界；本版本需重新执行 Harmony 原生联编并安装最新 HAP。
• 将发布验收清单迁移到仓库级内部文档，避免内部资料进入插件市场包。

平台兼容性

uni-app(4.84)

uni-app x(4.84)

lizhao-share-plus

lizhao-share-plus 是一个纯 UTS 系统分享 API 插件，面向 uni-app 与 uni-app x。它把文本、链接、图片、视频、普通文件、远程文件下载后分享和 iOS 完成回调统一成一套参数结构，并提供分享前预检，方便业务在真正调起系统分享前先判断能不能分享、会分享什么、用户需要注意什么。

这份文档按由浅入深的顺序组织：先 3 分钟跑通，再接入文件和远程文件，最后看预检、场景预设、完整 API、错误码和平台边界。

接入方式选择

3 分钟快速接入

1. 导入插件

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

页面使用插件时只导入到插件根目录，不要导入 utssdk/index.uts。

2. 分享文本

// 最小文本分享：适合公告、邀请码、客服文案等纯文本场景。
LizhaoSharePlus.shareText({
  title: '系统分享演示',
  text: '这是 lizhao-share-plus 的文本分享示例',
  success(res) {
    console.log('分享面板已调起', res)
  },
  fail(err) {
    console.log('分享失败', err)
  }
})

3. 分享链接

// 链接分享会把 text 与 url 一起交给系统分享面板。
LizhaoSharePlus.shareUrl({
  title: '活动详情',
  text: '把这个活动分享给朋友',
  url: 'https://uniapp.dcloud.net.cn/',
  complete(res) {
    console.log('分享流程结束', res)
  }
})

常见增强示例

分享本地文件

// 文件路径必须是 App 端真实可访问路径；图片建议传 image/*，PDF 建议传 application/pdf。
LizhaoSharePlus.shareFile({
  preset: 'image',
  text: '这是图片分享示例',
  file: '/storage/emulated/0/Download/share-card.png',
  mimeType: 'image/png',
  success(res) {
    console.log('文件分享已调起', res.filesResolved)
  }
})

HarmonyOS 支持一次分享最多 500 个本地文件，可传项目内 /static/... 路径、应用沙箱绝对路径或有效的 file:// URI；任一文件不存在时整体返回 9011003，不会拉起内容不完整的分享面板。

分享多个文件

// 多文件分享会使用各平台系统原生的多记录分享能力。
LizhaoSharePlus.shareFile({
  preset: 'file',
  text: '这是多文件分享示例',
  files: [
    '/storage/emulated/0/Download/report-a.pdf',
    '/storage/emulated/0/Download/report-b.pdf'
  ],
  mimeType: 'application/pdf'
})

HarmonyOS 会为每个本地文件创建一条系统分享记录，最多支持 500 条；具体接收应用需要支持并读取多条记录，少数应用可能只处理第一条。

远程文件下载后分享

// Android/iOS 默认会把 http/https 文件先下载到本地缓存，再交给系统分享面板。
LizhaoSharePlus.shareFile({
  preset: 'remoteFile',
  text: '这是远程 PDF 分享示例',
  file: 'https://www.w3.org/WAI/ER/tests/xhtml/testfiles/resources/pdf/dummy.pdf',
  mimeType: 'application/pdf',
  fileNameStrategy: 'timestamp',
  success(res) {
    console.log('远程文件已下载并分享', res.filesResolved)
  },
  fail(err) {
    console.log('远程下载或分享失败', err)
  }
})

远程文件下载失败会返回 9011004。如果需要自定义落盘目录，传入 downloadDir；如果希望保留原文件名、按 URL hash 命名或按时间戳命名，使用 fileNameStrategy: 'keep' | 'hash' | 'timestamp'。

Android/iOS 会先把远程文件下载到本地缓存后再分享。HarmonyOS 当前要求调用前自行下载为本地文件，直接传远程 URL 会返回 9011001。Android 与 HarmonyOS 的 completed 表示已成功调起分享面板；iOS 的 completed 来自系统完成回调，用户取消时可能为 false。

分享前预检

prepareShare(options) 不会下载文件，也不会弹出系统分享面板。它适合用在正式分享前，给业务按钮置灰、给用户提示原因，或调试客户传入的参数。

// 预检远程文件分享：可以提前知道当前平台是否支持、是否需要下载、会归一出哪些文件。
const prepared = LizhaoSharePlus.prepareShare({
  preset: 'remoteFile',
  text: '这是远程 PDF 分享前预检示例',
  file: 'https://www.w3.org/WAI/ER/tests/xhtml/testfiles/resources/pdf/dummy.pdf',
  mimeType: 'application/pdf',
  fileNameStrategy: 'timestamp'
})

console.log(prepared.canShare)
console.log(prepared.needsDownload)
console.log(prepared.tips)

返回值：

场景预设

preset 用来表达业务意图。传 auto 或不传时，插件会按 files/file/url/text/mimeType 自动推断。

兼容旧参数

如果旧项目使用 type/title/summary/path 风格参数，可以先用 shareWithSystem 迁移：

// 兼容模式会转换到 shareText/shareUrl/shareFile 主链路。
LizhaoSharePlus.shareWithSystem({
  type: 'file',
  title: '报告文件',
  summary: '请查看这份 PDF 报告',
  path: '/storage/emulated/0/Download/report.pdf',
  mimeType: 'application/pdf',
  fileNameStrategy: 'keep'
})

API 列表

ShareOptions 参数

ShareResult 返回值

ShareResolvedFile 返回值

错误码

平台支持

自定义基座说明

当前插件不新增三方 SDK、Manifest、Info.plist、权限、libs、res 或 assets。但 Android/iOS/Harmony UTS 原生逻辑会编译进 App；如果更新了对应平台 index.uts，真机要使用最新能力时，需要重新运行对应平台原生联编并安装最新应用包。只更新 wgt/appResource 不能替换旧包里已编译的 UTS 原生部分。

完整示例

完整页面示例见：

uni_modules/lizhao-share-plus/example/uniapp/share.vue

作者系列 UTS 插件

以下为已在 DCloud 插件市场上架的作者系列 UTS 插件，可按业务场景组合使用。未列出的插件表示当前未确认公开市场页，后续上架后再补充。