更新记录

1.0.0（2026-07-17）

Android 和 iOS 双平台原生分享

平台兼容性

uni-app(3.8.6)

dl-share

uni-app 系统分享 UTS 插件，支持 Android 和 iOS 双平台，可分享文字、图片、音视频、Word、Excel、PDF 等文件。

功能

• 调用系统原生分享面板
• 支持 文字、图片、音视频、文件多种分享类型
• Android 自动推断文件 MIME 类型，兼容 Android 7.0+ FileProvider
• iOS 适配 iPad popover，自动处理主线程
• 支持 success / fail / complete 回调

支持的平台

文件结构

uni_modules/dl-share/
├── package.json
├── utssdk/
│   ├── interface.uts          # 公共类型定义
│   ├── app-android/
│   │   └── index.uts          # Android 实现
│   └── app-ios/
│       ├── index.uts          # iOS UTS 入口
│       └── DlShare.swift      # iOS 原生 Swift 实现

API

shareWithSystem(options)

调用系统分享面板。

参数

回调参数

{
  errMsg: string  // 成功："shareWithSystem:ok"，失败：出错信息
  errCode: number // 0 = 成功，其他 = 错误码
}

错误码

使用示例

import { shareWithSystem } from '@/uni_modules/dl-share'

// 分享文字
shareWithSystem({
  type: 'text',
  summary: '这是一段分享文字',
})

// 分享图片
shareWithSystem({
  type: 'image',
  title: '分享图片',
  path: plus.io.convertLocalFileSystemURL('_doc/photo.png'),
  success: (res) => console.log('分享成功', res),
  fail: (err) => console.log('分享失败', err),
})

// 分享视频
shareWithSystem({
  type: 'video',
  path: plus.io.convertLocalFileSystemURL('_doc/video.mp4'),
})

// 分享音频
shareWithSystem({
  type: 'audio',
  path: plus.io.convertLocalFileSystemURL('_doc/audio.mp3'),
})

// 分享文件
shareWithSystem({
  type: 'file',
  title: '分享弹窗标题',
  path: plus.io.convertLocalFileSystemURL('_doc/xxx.pdf'),
})

注意事项

1. 文件路径 — 必须使用本地绝对路径，推荐通过 plus.io.convertLocalFileSystemURL() 转换相对路径
2. title 仅 Android 有效 — iOS 系统分享面板不自定义标题
3. Android FileProvider — Platform 会自动尝试 {包名}.dc.fileprovider / {包名}.fileprovider 等常见 authority
4. iPad — 已自动处理 popover 适配，无需额外配置