본문 바로가기
@capgo/capacitor-pdf-viewer 파일 및 스토리지 오픈 소스

PDF 뷰어 Capacitor 플러그인

경로, URL, base64, 인라인 모드, 비밀번호를 지원하며 iOS, Android, 웹에 네이티브 PDF 뷰어를 임베드하세요

설치

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), 웹에서 경로, URL, base64, 인라인 모드로 네이티브 PDF 보기

설치

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

플러그인이 제공하는 기능

  • open - 파일, 경로, URL 또는 base64 소스에서 PDF를 엽니다.
  • close - 활성 뷰어를 닫고 오버레이를 제거합니다.
  • goToPage - 1부터 시작하는 페이지 번호로 이동합니다.
  • setZoom - 줌 배율을 설정합니다.
  • getPluginVersion - 네이티브 또는 웹 구현 버전 마커를 가져옵니다.
  • addListener - load, pageChange, error, close, linkTap 이벤트를 수신합니다.

사용 예시

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();

전체 레퍼런스

자주 묻는 질문

PDF Viewer 플러그인 FAQ

Capacitor 앱에 PDF Viewer 플러그인을 설치하는 방법은 무엇인가요?

"bun add @capgo/capacitor-pdf-viewer" (또는 "npm install @capgo/capacitor-pdf-viewer")를 실행한 후, iOS 및 Android 프로젝트가 네이티브 code를 인식하도록 "bunx cap sync"를 실행하세요. 앱 code에서 "@capgo/capacitor-pdf-viewer"로 가져오세요.

@capgo/capacitor-pdf-viewer은 React, Vue, Angular와 호환되나요?

네. PDF Viewer는 Capacitor 패키지이므로, Ionic, React, Vue, Angular, Svelte 및 순수 JavaScript를 포함하여 Capacitor 내에서 실행되는 모든 웹 프레임워크와 함께 작동합니다.

@capgo/capacitor-pdf-viewer은 어떤 Capacitor 버전을 지원하나요?

Capgo 플러그인은 Capacitor의 메이저 버전을 따릅니다. 사용 중인 Capacitor 메이저 버전과 일치하는 플러그인 메이저 버전을 사용하세요 (예: Capacitor 8에는 플러그인 v8). 유지 관리되는 버전은 GitHub README의 호환성 표에서 확인할 수 있습니다.

@capgo/capacitor-pdf-viewer은 무료이고 오픈 소스인가요?

네. 소스 code는 https://github.com/Cap-go/capacitor-pdf-viewer/의 GitHub에서 공개되어 있으며, npm에서 무료로 설치할 수 있습니다. 버그 보고와 풀 리퀘스트를 환영합니다.

앱 스토어 리뷰 없이 PDF Viewer를 사용하는 code를 업데이트할 수 있나요?

플러그인을 설치하거나 업그레이드하면 네이티브 code가 변경되므로 새로운 스토어 빌드가 필요합니다. 그 이후에는 플러그인을 호출하는 JavaScript, HTML, CSS 변경 사항을 Capgo live updates로 즉시 배포할 수 있습니다.

앱 심사 대기 없이 PDF Viewer 변경 사항을 배포하세요

스토어 빌드에 플러그인이 포함되면, Capgo live updates로 JavaScript, HTML, CSS 변경 사항을 몇 분 만에 사용자에게 푸시할 수 있습니다.

Capgo로 시작하기