Capacitor PDF Viewer
@capgo/capacitor-pdf浏览器 文件 & 存储 开源

PDF 查看器 Capacitor插件

在iOS、Android和Web上嵌入本机PDF查看,支持路径、URL、base64、内联模式和密码

安装

bun add @capgo/capacitor-pdf-viewer bunx cap sync
npm、pnpm或yarn
  • npm install @capgo/capacitor-pdf-viewer
  • pnpm add @capgo/capacitor-pdf-viewer
  • yarn add @capgo/capacitor-pdf-viewer

指南

如何在 Capacitor 中使用 PDF Viewer

使用 @capgo/capacitor-pdf-viewer

在 iOS(PDFKit)、Android(Pdfium)和 Web 上使用 PDF 查看器(路径、URL、base64 和内联模式)

安装

bun add @capgo/capacitor-pdf-viewer
bunx cap sync

此插件暴露了什么

  • open - 从文件、路径、URL或base64源打开PDF。
  • close - 关闭当前查看器并移除任何覆盖层。
  • goToPage - 跳转到1基数的页码。
  • setZoom - 设置缩放比例乘数。
  • getPluginVersion - 获取本机或Web实现版本标记。
  • addListener - 监听加载、页码改变、错误、关闭和链接点击事件。

- 示例用法

open

import { PdfViewer } from '@capgo/capacitor-pdf-viewer';

await PdfViewer.addListener('pageChange', ({ page, pageCount }) => {
  console.log(`Page ${page} of ${pageCount}`);
});

const { pageCount } = await PdfViewer.open({
  source: 'https://example.com/manual.pdf',
  mode: 'fullscreen',
  scrollMode: 'continuous',
  page: 1,
});

console.log(`Opened ${pageCount} pages`);

close

import { PdfViewer } from '@capgo/capacitor-pdf-viewer';

await PdfViewer.close();

- 全部参考

常见问题

如何在__CAPGO_KEEP_0__应用中安装PDF Viewer插件?

如何在Capacitor应用中安装PDF Viewer插件?

Run "bun add @capgo/capacitor-pdf-viewer" (or "npm install @capgo/capacitor-pdf-viewer"), then run "bunx cap sync" so the iOS and Android projects pick up the native code. Import it from "@capgo/capacitor-pdf-viewer" in your app code.

是否@capgo/capacitor-pdf-viewer与React、Vue和Angular兼容?

Yes. PDF Viewer is a Capacitor package, so it works with any web framework that runs inside Capacitor, including Ionic, React, Vue, Angular, Svelte and plain JavaScript.

哪个 Capacitor 版本支持 @capgo/capacitor-pdf-viewer?

Capgo 插件遵循 Capacitor 的主要版本:使用匹配您的 Capacitor 主要版本的插件版本(例如插件 v8 与 Capacitor 8)。在 GitHub README 中的兼容性表格中列出了维护的版本。

是否支持 @capgo/capacitor-pdf-viewer?

是。源代码 code 公开在 GitHub 上(https://github.com/Cap-go/capacitor-pdf-viewer/)并且包是从 npm 免费安装的。bug报告和pull请求都欢迎。

是否可以在App Store没有审查的情况下更新使用PDF Viewer的 code?

安装或升级插件会改变本机 code,所以需要一个新的商店构建。之后,JavaScript、HTML和CSS改变,调用插件的改变可以立即在 Capgo live updates 中发布。

无需等待应用程序审查即可将PDF Viewer的更改推送到商店

一旦插件在您的商店构建中,Capgo实时更新将推送您的JavaScript、HTML和CSS更改到用户中几分钟内。

从Capgo开始