설치 및 기본 사용법
Univer PDF는 Univer Office SDK의 일부이며 미리 설치를 제공하지 않습니다. PDF 응용 프로그램은 플러그인 모드에서 조립됩니다.
Univer는 두 가지 통합 모드를 지원합니다: 미리 설정 모드 및 플러그인 모드. 미리 설정 모드는 배선의 양을 줄이기 위해 플러그인의 사전 설정된 번들을 제공합니다. 깊은 주문화 또는 연장가 필요한 경우 플러그인 모드를 사용하여 각 플러그인이 선택되고 개별적으로 구성됩니다.
플러그인 모드로 설정하기
패키지 관리자 사용
구조 공구는 ES 단위를 지원하고 package.json에 있는 exports 분야를 지원해야 합니다.
설치
Univer는 React와 RxJS를 가진 그것의 자료 시내를 건설하고, 또한 Vue 또는 Angular 신청에서 끼워넣을 수 있습니다. react, react-dom 및 rxjs 동료 Dependencies1가 설치된다는 것을 증명하십시오. 털실 명령은 아래에 그(것)들을 명시적으로 추가합니다.
모든 @univerjs/* 및 @univerjs-pro/* 패키지의 버전을 동일하게 유지하세요.
pnpm add @univerjs/core @univerjs/design @univerjs/ui @univerjs-pro/license @univerjs-pro/pdfs @univerjs-pro/pdfs-uinpm install @univerjs/core @univerjs/design @univerjs/ui @univerjs-pro/license @univerjs-pro/pdfs @univerjs-pro/pdfs-uiyarn add @univerjs/core @univerjs/design @univerjs/ui @univerjs-pro/license @univerjs-pro/pdfs @univerjs-pro/pdfs-ui react react-dom rxjsbun add @univerjs/core @univerjs/design @univerjs/ui @univerjs-pro/license @univerjs-pro/pdfs @univerjs-pro/pdfs-ui모든 @univerjs/* 및 @univerjs-pro/* 패키지를 동일한 버전으로 유지하세요.
사용법
Univer 초기화하기 전에 명시된 높이로 컨테이너를 만듭니다.
<div id="app" style="height: 600px"></div>FUniver.newAPI(univer)를 호출하기 전에 아래의 사용 된 정면 항목을 가져옵니다. @univerjs/design CSS를 먼저 가져 와서 @univerjs/ui의 CSS 및 제품 CSS가 지속됩니다.
PDF UI 스타일 전에 공유 UI 스타일을 가져 와서 응용 프로그램을 활성화 할 수있는 Locale 팩을 병합 :
TypeScriptimport { UniverLicensePlugin } from '@univerjs-pro/license'import { UniverPdfsPlugin } from '@univerjs-pro/pdfs'import { UniverPdfsUIPlugin } from '@univerjs-pro/pdfs-ui'import PdfsUIEnUS from '@univerjs-pro/pdfs-ui/locale/en-US'import { LocaleType, mergeLocales, Univer } from '@univerjs/core'import { FUniver } from '@univerjs/core/facade'import DesignEnUS from '@univerjs/design/locale/en-US'import { UniverUIPlugin } from '@univerjs/ui'import UIEnUS from '@univerjs/ui/locale/en-US'import '@univerjs/design/lib/index.css'import '@univerjs/ui/lib/index.css'import '@univerjs-pro/pdfs-ui/lib/index.css'PDF Facade2 항목 가져 오기. 이 부작용 가져 오기는
FUniver에 PDF 방법과 ENums를 추가합니다.TypeScriptimport '@univerjs-pro/pdfs/facade'런타임을 만들고 명시적인 플러그인 스택을 등록한 다음 PDF를 만드세요.
TypeScriptconst univer = new Univer({ locale: LocaleType.EN_US, locales: { [LocaleType.EN_US]: mergeLocales( DesignEnUS, UIEnUS, PdfsUIEnUS, ), },})univer.registerPlugin(UniverUIPlugin, { container: 'app' })univer.registerPlugin(UniverLicensePlugin, { license: process.env.CLIENT_LICENSE_TEXT,})univer.registerPlugin(UniverPdfsPlugin)univer.registerPlugin(UniverPdfsUIPlugin)const univerAPI = FUniver.newAPI(univer)univerAPI.createPdf({ name: 'Untitled PDF' })
플러그인 설정
UniverUIPlugin
containerstring | HTMLElement편집기를 마운트할 DOM 요소 또는 요소 ID입니다.
UniverLicensePlugin
licensestring클라이언트 라이선스 파일의 내용입니다.
univer.registerPlugin 및 univer.registerPlugins 메서드
Univer 인스턴스가 생성되면 univer.registerPlugin를 호출하여 플러그인을 등록하십시오.
호출은 univer.registerPlugin(Plugin, options) 양식을 가지고 있습니다. Plugin는 등록하는 플러그인이며 options 옵션 구성 객체입니다. 각 플러그인은 자체 옵션을 정의합니다.
한 번에 여러 플러그인을 등록하려면 univer.registerPlugins에 배열을 통과하십시오. 이것은 플러그인 관리를 한 곳에서 유지합니다.
univer.registerPlugins([ [UniverUIPlugin, { container: 'app' }], [UniverLicensePlugin, { license: process.env.CLIENT_LICENSE_TEXT, }], UniverPdfsPlugin, UniverPdfsUIPlugin,])모바일 지원
현재 @univerjs-pro/pdfs-ui 패키지는 전용 모바일 UI 플러그인을 수출하지 않습니다. 그것은 MobileUIPlugin 가져 오기 또는 mobile: true 옵션을 제공하지 않습니다, 그래서 하나를 사용하려고하지 않습니다. 좁은 컨테이너는 터치 지원이 완료되지 않습니다; 대상 장치에 기존 UI를 평가합니다.
선택적 썸네일 워커
페이지 thumbnails는 추가 구성없이 주요 스레드에 렌더링합니다. 더 큰 문서를 위해 thumbnailWorkerURL를 통해 전용 모듈 작업자에게 전달하십시오.
pdf-thumbnail.worker.ts와 같은 워커 진입점을 만드세요.
import { UniverPdfsUIWorkerPlugin } from '@univerjs-pro/pdfs-ui/worker'import { Univer } from '@univerjs/core'const univer = new Univer()univer.registerPlugin(UniverPdfsUIWorkerPlugin)PDF UI 플러그인을 등록할 때 worker URL을 전달하십시오:
UniverPdfsUIPlugin
thumbnailWorkerURLstring | URL | Worker브라우저 Worker에서 페이지 썸네일을 생성합니다.
univer.registerPlugin(UniverPdfsUIPlugin, { thumbnailWorkerURL: new Worker(new URL('./pdf-thumbnail.worker.ts', import.meta.url), { type: 'module' }),})이 옵션은 문자열 URL 또는 기존 Worker도 허용합니다. 워커나 OffscreenCanvas를 사용할 수 없으면 썸네일 렌더링은 메인 스레드로 대체됩니다.
협업 기반 편집
@univerjs-pro/pdfs-editor는 로컬 전용 스택의 일부가 아니며 독립적으로 기능을 할 수 없습니다. @univerjs-pro/collaboration, @univerjs-pro/collaboration-client 및 @univerjs-pro/collaboration-client-ui 스택을 설치하고 등록하십시오. 회사연혁에 설명 된대로 PDF 편집기 수명주기 플러그인.
Node.js 사용법
Node.js 서비스는 브라우저 UI 패키지 없이 UniverPdfsPlugin를 등록할 수 있습니다. 서비스가 로드하거나 동기화 할 때만 협력 스택을 추가하십시오.
기타 릴리스
안정적인 릴리스 외에도 Univer는 아직 공식적으로 출시되지 않은 기능을 제공하는 알파 및 베타 채널을 유지합니다. 또한 더 많은 기능을 의미 :이 버전은 버그, 불완전한 기능, 또는 불안정한 기능을 포함 할 수 있으므로 생산에서 불가능합니다.
Alpha / Beta 릴리스
Univer 팀은 새로운 기능 또는 중요한 변화를 완료할 때 알파 또는 베타 채널로 변경을 미리 릴리스 할 수 있습니다. 패키지의 알파 또는 베타 버전을 설치하십시오.
pnpm add @univerjs-pro/pdfs@alpha # Alpha version
pnpm add @univerjs-pro/pdfs@beta # Beta versionnpm install @univerjs-pro/pdfs@alpha # Alpha version
npm install @univerjs-pro/pdfs@beta # Beta versionyarn add @univerjs-pro/pdfs@alpha # Alpha version
yarn add @univerjs-pro/pdfs@beta # Beta versionbun add @univerjs-pro/pdfs@alpha # Alpha version
bun add @univerjs-pro/pdfs@beta # Beta version문제가 발생하거나 알파 또는 베타 버전을 사용하는 동안 피드백을 가지고 있다면 GitHub 문제를 통해 Univer 팀에보고하십시오. 이 초기 릴리스의 피드백은 환영합니다.
다음 단계
Footnotes
이 가이드는 어떠셨나요?