更新记录

0.1.1（2026-06-09）

• 修复 Android filePath 返回普通路径时 <image> 不能稳定预览的问题，现在返回 file:// 本地图片地址。
• 补充 Android、iOS、HarmonyOS 最低兼容版本说明。
• 补齐插件平台兼容性配置，声明支持 Android、iOS、HarmonyOS 和 Vue 3。

平台兼容性

uni-app(4.11)

uni-app x(4.21)

wrc-pdftoimg

PDF 转图片 UTS 插件，API 兼容旧 wrc-pdftoimage 原生插件的回调结果结构。

import { changePdfToImage } from '@/uni_modules/wrc-pdftoimg';

changePdfToImage('/storage/emulated/0/Download/demo.pdf', {
    quality: 100,
    format: 'jpeg',
    resultType: 'filePath'
}, (res) => {
    if (res.status === '200') {
        const images = res.data;
    }
});

参数

• fileUrl: 本地 PDF 文件路径。支持普通路径和 file:// 路径。
• options.quality: 图片质量，范围 0-100，默认 100。
• options.format: 输出格式，支持 jpeg、jpg、png、webp，默认 jpeg。
• options.resultType: 返回类型，base64 或 filePath，默认 base64。大文件建议使用 filePath，避免一次性返回大量 Base64 字符串。

返回

• status: 200 表示成功，500 表示失败。
• message: 状态信息。
• data: 每页图片数组。resultType 为 base64 时返回 Base64 字符串，不包含 data:image/...;base64, 前缀；为 filePath 时返回本地图片路径或 file:// 本地图片地址，可直接用于 <image> 预览。

兼容性

• Android: 最低 Android 5.0。已在 Android 自定义基座测试 PDF 转图片，filePath 返回 file:// 本地图片地址。
• iOS: 最低 iOS 12.0。插件使用系统 PDFKit 渲染 PDF 页面。
• HarmonyOS: 最低 HarmonyOS NEXT API 12。插件提供鸿蒙入口，需要在鸿蒙自定义基座中运行验证具体机型文件权限。
• Vue: 支持 Vue 3，不支持 Vue 2。