PDF 阅读与导出

接入方式

PDF 阅读器是 PDFium 驱动的 kui_ext_pdf 元素扩展，核心文档导出与 PDF 阅读器是不同入口。阅读器需要明确的显示方式和尺寸；文件加载、页数、缩放、文字提取与查找需在目标包中逐项验证。

约束和排错

阅读器的 page 属性从 1 开始，Lua gotoPage(n) 从 0 开始。把页面导航从业务层传入时明确转换，避免第一/最后一页越界。部署 PDFium 依赖时使用对应包版本，不混用其他架构 DLL。

嵌入 PDF 元素

部署 kui_ext_pdf 和 PDFium 后，加载元素扩展，再创建 kui-pdf。src 指向应用提供的文件，宽高由布局给出。下面是页面结构示例，文档文件需要由应用自行部署。

<kui-pdf src="documents/manual.pdf"
  style="width:100%;height:640px"></kui-pdf>

翻页、缩放与文本

注册方法包括 getPageCount、getPageSize、gotoPage、nextPage、prevPage、getZoom、setZoom、getPageText 与 findText。页号的索引约定、返回值及加载错误需按对应方法确认。PDF 阅读不代表 PDF 表单、编辑、签名和所有字体场景均已支持。

• PDF 方法目录 →

验证阅读和导出两条路径

按下面的顺序验证一个最小场景，再接入完整应用。

1. 先打开一份已知 PDF，检查页数、缩放、滚动和关闭。
2. 损坏、加密或体积很大的文件应有明确失败反馈。
3. 导出单独检查页面尺寸、字体、分页和输出路径，不把屏幕截图视为 PDF 导出。
4. 复制交付目录后再打开和导出，确认 PDF 依赖没有借用开发环境。