更新记录

1.0.1（2026-07-03）

• 新增 filterApp 参数，支持过滤分享应用列表
• filterApp 可传入 true 过滤当前应用，或传入字符串数组按包名过滤
• 注意：filterApp 仅 Android 13+（API 33+）生效，iOS 仅做参数兼容无实际过滤效果

1.0.0（2026-07-02）

• 初始版本
• 支持文本、链接、图片、视频、音频、文件分享
• 支持 Android 和 iOS 平台

平台兼容性

uni-app(5.07)

uni-app x(5.07)

其他

cc-share

原生系统级别分享插件，支持 Android 和 iOS 平台。

功能

• 分享文本
• 分享链接
• 分享图片（单张/多张）
• 分享视频（单个/多个）
• 分享音频（单个/多个）
• 分享文件（单个/多个）

平台兼容性

filterApp 参数仅在 Android 13+（API 33+）上生效，iOS 仅做参数兼容，无实际过滤效果。

使用方法

import { shareWithSystem } from "@/uni_modules/cc-share"

// 分享文本
shareWithSystem({
  summary: "Hello World",
  type: 'text',
  success(res) {
    console.log("分享成功", res.errMsg)
  },
  fail(err) {
    console.log("分享失败", err.errCode, err.errMsg)
  }
})

// 分享链接
shareWithSystem({
  href: "https://uniapp.dcloud.io",
  type: 'text',
  success(res) {
    console.log("分享成功")
  }
})

// 分享单张图片
shareWithSystem({
  imageUrl: "/static/test-image/logo.png",
  type: 'image'
})

// 分享多张图片
shareWithSystem({
  imagePaths: ["/static/img1.png", "/static/img2.png"],
  type: 'image'
})

// 分享视频
shareWithSystem({
  videoPaths: ["/static/video.mp4"],
  type: 'video'
})

// 分享音频
shareWithSystem({
  audioPaths: ["/static/audio.mp3"],
  type: 'audio'
})

// 分享文件
shareWithSystem({
  filePaths: ["/static/file.zip"],
  type: 'file'
})

// 同时分享链接、文本和图片
shareWithSystem({
  summary: "欢迎使用uni-app",
  href: "https://uniapp.dcloud.io",
  imagePaths: ["/static/image.png"],
  type: 'image'
})

// 过滤当前应用（仅 Android 13+ 生效）
shareWithSystem({
  summary: "分享文本",
  filterApp: true
})

// 过滤指定包名的应用（仅 Android 13+ 生效）
shareWithSystem({
  summary: "分享文本",
  filterApp: ["com.tencent.mm", "com.tencent.mobileqq"]
})

参数说明

错误码