更新记录

1.0.2（2026-09-15）

• iOS 打开系统分享面板后立刻返回 launched（与 Android 一致）。不再等到用户关掉面板，避免面板没弹出时 JS 一直挂起、点击无反应

1.0.1（2026-09-15）

• iOS 与 Android 一样把 _doc / _www 转成绝对路径，再打开系统分享面板（业务侧缓存图不再弹 Please try again）
• iOS 分享面板避开正在关闭的 loading 弹层，避免被 HUD 挡住或一起关掉
• 分享拷贝最多保留 20 张（先删超过 24 小时的，再按修改时间淘汰最旧的）

1.0.0（2026-09-15）

首个版本。

• Android 使用 FileProvider content URI 调用系统分享，高版本系统面板可预览缩略图
• iOS 使用 UIActivityViewController
• JPEG / PNG 原样分享；WebP / HEIC 等先转 JPEG 再发出，避免预览空白
• 可选直达 Facebook / Instagram（Android）；未安装默认回退系统面板

平台兼容性

uni-app(4.27)

fz-social-share

1.0.2

把本地图片交给系统分享面板。Android 走 ACTION_SEND + FileProvider，iOS 走 UIActivityViewController。不接微信 / Facebook / Instagram SDK。

JPEG / PNG 原样发出；WebP / HEIC / GIF 先转 JPEG。单张不超过 30 MB、5000 万像素。

拷到 uni_modules 即可。UTS 必须打自定义基座或正式包。改原生代码后重新打基座。必须在用户点击里调用，不能在 onLoad 自动拉起。

环境

插件本身不申请权限。宿主若用 uni.chooseImage，在 manifest.json 开 Gallery，iOS 配 NSPhotoLibraryUsageDescription。

用法

import { shareImage } from '@/uni_modules/fz-social-share'

async function onShare(filePath) {
    try {
        const res = await shareImage({
            imagePath: filePath,
            target: 'system',
            fallbackToSystem: true
        })
        // res.status === 'launched' 只表示面板已打开，不代表已发布
        console.log(res)
    } catch (e) {
        uni.showToast({ title: e.errMsg || '分享失败', icon: 'none' })
    }
}

imagePath 必须是本地路径（绝对路径、file://、content://、_doc / _www）。网络图先下载。示例页：pages/share/share。

API

shareImage(options: ShareImageOptions): Promise<ShareImageResult>

成功返回：

失败 reject，errSubject === 'fz-social-share'。

错误码