更新记录

2.10（2026-09-30）

进一步提升兼容性

2.05（2025-04-21）

修复ipad分享

2.04（2023-02-09）

回退版本，修复ios无法打包的问题

平台兼容性

原生插件通用使用流程：

1. 购买插件，选择该插件绑定的项目。
2. 在HBuilderX里找到项目，在manifest的app原生插件配置中勾选模块，如需要填写参数则参考插件作者的文档添加。
3. 根据插件作者的提供的文档开发代码，在代码中引用插件，调用插件功能。
4. 打包自定义基座，选择插件，得到自定义基座，然后运行时选择自定义基座，进行log输出测试。
5. 开发完毕后正式云打包

付费原生插件目前不支持离线打包。
Android 离线打包原生插件另见文档 https://nativesupport.dcloud.net.cn/NativePlugin/offline_package/android
iOS 离线打包原生插件另见文档 https://nativesupport.dcloud.net.cn/NativePlugin/offline_package/ios

注意事项：使用HBuilderX2.7.14以下版本，如果同一插件且同一appid下购买并绑定了多个包名，提交云打包界面提示包名绑定不一致时，需要在HBuilderX项目中manifest.json->“App原生插件配置”->”云端插件“列表中删除该插件重新选择

PP-Share 2.10 · 系统分享

支持 Android / iOS 系统分享：图片、视频、PDF、Word、Excel 等本地文件，可多文件混合分享，也可作为邮件附件发送。实际可接收的类型以目标应用为准。

接入

将本目录的 PP-Share 放入项目的 nativeplugins/，在 manifest.json 中选择该本地插件，并使用包含插件的自定义基座或 App 安装包。示例项目见 ../share-demo。

分享文件

在 App 页面事件中调用；先将文件下载或复制到 _doc/，替换下面的文件路径。_www/ 内置资源请先复制到 _doc/，完整写法见 Demo。

const ppShare = uni.requireNativePlugin('PP-Share')
const paths = ['_doc/demo.png', '_doc/demo.pdf']
  .map(path => plus.io.convertLocalFileSystemURL(path))

ppShare.share({
  path: paths,                 // 本地路径数组；单文件也传数组
  ipadX: 0.5,                  // iPad 弹窗横向位置，0～1
  ipadY: 0.2,                  // iPad 弹窗纵向位置，0～1
  systemActivities: true      // iOS 显示完整系统分享选项
}, result => {
  console.log('分享回调', result)
})

systemActivities 默认关闭以保持旧版行为，Android 忽略此参数。网络地址需先下载，不能直接放入 path。

邮件附件

沿用上例的 ppShare 和 paths：

ppShare.sharetoMail({
  path: paths,
  title: '邮件标题',
  body: '邮件正文',
  tos: 'receiver@example.com'  // 可选，替换成实际收件人或删除
}, result => {
  console.log('邮件回调', result)
})

iOS 需先配置系统邮件账户；Android 需有可接收附件的邮件应用。调用只打开选择器或邮件编辑页，由用户确认发送。

2.10 更新

• Android 优化文件读取授权、后台复制和缓存隔离，修复邮件选择器重复弹出及异常文件处理。
• iOS 优化弹窗定位、重复调用保护、邮件反馈，新增完整系统分享选项。
• 沿用 PP-Share 插件 ID 和旧接口；Demo 精简为五种分享入口及可复制日志。

回调保留历史约定：Android 系统分享的 code: 201 也可能表示成功拉起，请结合 msg 判断；Android 邮件正常拉起不回调。回调不等于对方已收到文件，请在接收端确认。

Android 真机截图见 pic。插件定制：QQ 37894663。