更新记录

1.0.0（2026-03-19）

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

平台兼容性

uni-app(4.84)

uni-app x(4.84)

lizhao-share-plus

全平台系统分享增强插件（UTS 插件形态），支持文本、链接、单文件、多文件、远程文件下载后分享。

安装

将插件放入：uni_modules/lizhao-share-plus

快速使用

API

import {
  share,
  shareText,
  shareUrl,
  shareFile,
  shareWithSystem,
  canIShare,
  normalizeShareFiles
} from '@/uni_modules/lizhao-share-plus/index.js'

const cap = canIShare({ text: 'hello' })
console.log('canIShare', cap)

await shareText({
  text: '这是文本分享示例',
  title: '分享标题'
})

await shareUrl({
  url: 'https://uniapp.dcloud.net.cn/',
  text: 'uni-app 官网'
})

await shareFile({
  files: [
    'https://www.orimi.com/pdf-test.pdf',
    '/storage/emulated/0/Download/a.docx'
  ],
  autoDownloadRemote: true,
  fileNameStrategy: 'timestamp'
})

await share({
  text: '图文分享',
  url: 'https://example.com',
  files: ['/storage/emulated/0/Download/a.pdf'],
  targetPackage: 'com.tencent.mm'
})

// 兼容 lime-share 的 API 形态
await shareWithSystem({
  type: 'file',
  title: '分享到',
  summary: '这是兼容模式调用',
  path: '/storage/emulated/0/Download/a.pdf'
})

const normalized = await normalizeShareFiles({
  files: ['https://www.orimi.com/pdf-test.pdf'],
  autoDownloadRemote: true
})
console.log(normalized)

组件

<template>
  <lizhao-share-plus
    :options="shareOptions"
    :auto="false"
    button-text="点击系统分享"
    @ready="onReady"
    @success="onSuccess"
    @cancel="onCancel"
    @error="onError"
    @complete="onComplete"
  />
</template>

<script>
export default {
  data() {
    return {
      shareOptions: {
        text: '组件触发分享',
        url: 'https://uniapp.dcloud.net.cn/'
      }
    }
  }
}
</script>

API 列表

ShareOptions

ShareResult

错误码

组件 Props

组件 Events

平台兼容性

• uni-app：Vue2、Vue3、H5、Android、iOS、鸿蒙、微信小程序
• uni-app x：H5、Android、iOS、鸿蒙、微信小程序

说明

• H5 优先使用 navigator.share。当浏览器支持 Web Share File（navigator.canShare({ files })）时，可分享远程 URL/dataURL/blob 文件。
• H5 文件分享依赖目标文件可被浏览器 fetch（受 CORS 限制）；若跨域未放行会返回 REMOTE_DOWNLOAD_FAILED。
• 微信小程序主要承接文本/链接分享，文件直传会返回 UNSUPPORTED。
• App 端支持 Android/iOS 原生系统分享流程，包含目标包名与渠道排除增强能力。