更新记录

0.1.2（2026-03-29）

• iOS：修复本地绝对路径 PDF（如 tempFilePath）无法加载的问题，自动转换为 file:// URL
• Android：新增本地文件可读性校验（不存在/非文件/不可读），错误信息更明确
• Android/iOS：重构原生组件渲染调用，统一为 renderCurrentPdf，减少重复逻辑
• Android/iOS：url 变更和初始化加载时增加 trim 空值判断，避免无效渲染
• Android/iOS：原生实例改为组件级实例，避免多组件场景下共享状态互相干扰

0.1.0（2026-03-29）

0.1.1

• Android：基于系统 PdfRenderer 实现原生 PDF 渲染，无需第三方依赖
• Android：支持分页模式（paged），内置上一页/下一页按钮与页码显示
• Android：支持滚动模式（scroll），连续渲染所有页面；超过 30 页自动降级为分页模式以保护内存
• Android：quality 参数控制渲染精度（1-4），zoom 参数控制缩放倍率（1-4）
• Android：内置 Bitmap 像素上限（800万）自动降级保护，防止大尺寸页面 OOM
• iOS：基于系统 PDFKit 实现原生 PDF 渲染，支持手势缩放与滚动
• 新增 dx-view-pdf 组件，支持 url、quality、zoom、mode props 及 load、error 事件

0.1.0

• 初始化 uniapp-x 插件开发骨架
• 增加 utssdk/index.uts / index.d.ts 导出入口与类型声明
• 增加模块根入口 index.uts / index.d.ts（uniapp-x 直接引入）
• 增加 Android/iOS openPdf 最小可运行实现
• 增加 utssdk/interface.uts 接口定义
• 增加 openPdf 的 success/fail/complete 回调与错误码
• 增加测试 PDF：https://mirrors.tuna.tsinghua.edu.cn/CTAN/info/lshort/chinese/lshort-zh-cn.pdf
• 增加环境自检脚本 scripts/check-env.sh

平台兼容性

uni-app(5.0)

uni-app x(5.0)

其他

view-pdf（uni-app x）

view-pdf 是一个 uni-app x App 端原生 PDF 组件，用于在页面内展示 PDF。

功能特性

• 支持 paged 分页查看
• 支持 scroll 全文滚动查看
• 支持 quality 清晰度调节
• 支持 zoom 缩放倍率调节

安装

将插件目录放入项目：

• uni_modules/view-pdf

基础示例

<template>
  <view class="page">
    <view-pdf class="viewer" :url="pdfPath" :quality="3" :zoom="1.4" mode="scroll" />
  </view>
</template>

<script setup lang="uts">
import { ref } from 'vue'

const pdfPath = ref('')

uni.downloadFile({
  url: 'https://mirrors.tuna.tsinghua.edu.cn/CTAN/info/lshort/chinese/lshort-zh-cn.pdf',
  success: (res) => {
    if (res.statusCode == 200 && res.tempFilePath.length > 0) {
      pdfPath.value = res.tempFilePath
    }
  }
})
</script>

<style>
.page {
  flex: 1;
}

.viewer {
  flex: 1;
}
</style>

属性

• url: string PDF 路径（建议传本地路径）
• quality: number 清晰度倍率，默认 2，范围 1~4
• zoom: number 缩放倍率，默认 1，范围 1~4
• mode: string 查看模式：paged / scroll

事件

• load：加载成功
• error：加载失败

说明

• 网络 PDF 建议先下载为本地临时文件后再传入。
• 若出现空白，优先检查组件容器是否有有效高度。