更新记录

1.1.10（2026-06-16）

• 修复 iOS 云打包 SwiftCompile：字符串下标统一通过 Swift bridge 转为 Int，避免 indexOf() 生成 Swift Int 后与 UTS number/NSNumber 参数不匹配。
• 修复远程文件分享命名策略：移除 iOS 端对 String.hashCode() 的依赖，改用稳定 hash 生成缓存文件名。
• 修复 iOS 缓存目录与远程下载：通过 SharePlusIosFileBridge.swift 包装目录创建、远程下载和文件写入等 Swift throws API，避免 UTS 直接调用生成异常 Swift。
• 修复 iOS 分享完成和异常回调：completionWithItemsHandler 使用系统四参闭包，Error? 统一通过 bridge 提取错误文本，避免生成 Error?.toString()。
• 增强 iOS 云打包回归守卫，锁定 Int/NSNumber、Error? 文本和远程下载 bridge 修复；本版本需重新提交 iOS 云打包验证。

1.1.8（2026-06-15）

• 修复 Android/iOS shareFile 便捷入口未完整透传远程文件参数的问题：现在会保留 autoDownloadRemote、downloadDir 与 fileNameStrategy，避免远程文件分享只在根 share 入口稳定可用。
• 修复 Android/iOS shareWithSystem 兼容入口未透传 fileNameStrategy 的问题，图片、视频和普通文件分享都会沿用调用方指定的远程文件命名策略。
• 优化发布守卫：新增便捷入口参数透传检查，防止远程文件下载、iOS 完成回调和兼容入口能力后续回退。
• 补充本轮发布验证记录：Android appResource 编译导出通过；iOS 已完成 UTS 编译与 Swift 生成物抽查，HBuilderX CLI 在 appResource 导出后处理阶段仍可能报 Cannot read properties of undefined (reading 'plus')。

1.1.6（2026-05-08）

• 修复 iOS 云打包误解析 Android 平台文件时生成 import java.io 的编译失败问题：Android 入口增加 APP-ANDROID 条件编译保护。
• 补齐 app-android/config.json 与 app-ios/config.json，保持平台目录结构完整。
• 升级插件版本，避免云打包复用旧版本缓存。

平台兼容性

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)
  }
})

分享多个文件

// 多文件分享会使用系统 ACTION_SEND_MULTIPLE / UIActivityViewController 文件数组能力。
LizhaoSharePlus.shareFile({
  preset: 'file',
  text: '这是多文件分享示例',
  files: [
    '/storage/emulated/0/Download/report-a.pdf',
    '/storage/emulated/0/Download/report-b.pdf'
  ],
  mimeType: 'application/pdf'
})

远程文件下载后分享

// App 端默认会把 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 的 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 UTS 原生逻辑会编译进 App 基座；如果更新了 utssdk/app-android/index.uts 或 utssdk/app-ios/index.uts，真机要使用最新能力时，需要重新运行对应平台原生联编或重新打对应平台自定义基座。只更新 wgt/appResource 不能替换旧基座里已编译的 UTS 原生部分。

完整示例

完整页面示例见：

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

发布前建议同时查看：

uni_modules/lizhao-share-plus/verification-checklist.md