# Быстрый старт

- Human documentation: [https://docs.univer.ai/ru-RU/guides/pdfs/getting-started/quickstart](https://docs.univer.ai/ru-RU/guides/pdfs/getting-started/quickstart)

- Agent Markdown: [https://docs.univer.ai/ru-RU/guides/pdfs/getting-started/quickstart.md](https://docs.univer.ai/ru-RU/guides/pdfs/getting-started/quickstart.md)

- Requested language: `ru-RU`

- Content language: `ru-RU`

- Documentation version: `1.2.0`

- Source: [pdfs/getting-started/quickstart.ru-RU.mdx](https://github.com/dream-num/documentation/blob/dev/content/guides/pdfs/getting-started/quickstart.ru-RU.mdx)

---

Перед установкой Univer PDFs познакомьтесь с четырьмя понятиями, на которых строится любая интеграция PDF:

* Плагин
* Снимок и модель данных
* Команда
* Facade API

## Основные понятия

### Плагины

Univer PDFs собирается из плагинов. `UniverPdfsPlugin` регистрирует модель юнита `UNIVER_PDF` и сохраняемые команды PDF. `UniverPdfsUIPlugin` добавляет браузерный просмотрщик и, по умолчанию, элементы редактирования. Подключайте пакеты для печати, обмена или совместной работы только при необходимости.

Эти плагины работают на общих сервисах ядра, рендеринга, дизайна и интерфейса Univer. Это технические зависимости PDF-приложения; опыт работы с другими продуктами Univer не требуется.

### Снимок и модель данных

Каждый PDF-юнит сохраняется как [снимок `IPdfUnitData`](https://docs.univer.ai/ru-RU/guides/pdfs/model/pdf-data.md). Его `document` — импортированная или пустая исходная основа, а принятые изменения записываются в `editState`, не перезаписывая эту основу напрямую.

Полный текущий снимок возвращает `pdf.save()`. `pdf.getDocument()` возвращает исходную основу, поэтому для сохранения пользовательских изменений используйте `save()`.

### Команда

Изменения во время работы выполняются командами. Благодаря этому проверка, обновление представления, история редактирования и намерение экспорта проходят через единый поток изменений. Методы Facade для PDF подготавливают параметры и выполняют эти команды.

> [!WARNING: Внимание]
> Не изменяйте снимок или исходный документ запущенного PDF-юнита напрямую. Используйте методы PDF Facade или зарегистрированные команды.

### Facade API

Импортируйте `@univerjs-pro/pdfs/facade` после основного Facade-входа, чтобы добавить API PDF в `FUniver`. Этот вход предоставляет `createPdf()`, `getActivePdf()`, `getPdf()` и другие методы.

Полная настройка и примеры приведены в разделе [Использование PDF Facade API](https://docs.univer.ai/ru-RU/guides/pdfs/getting-started/facade.md).

Далее перейдите к разделу [Установка и основы использования](https://docs.univer.ai/ru-RU/guides/pdfs/getting-started/installation.md).