# Скачивание и установка

Установите Oleafly на macOS, Windows или Linux и узнайте, что приложение может скачать при первом использовании.

Установка Oleafly — это скачивание и двойной щелчок. Без аккаунта, без входа в систему и без отдельного дистрибутива LaTeX: компилятор встроен в приложение.

## Скачивание приложения

Возьмите самый свежий установщик со [страницы релизов](https://github.com/Oleafly/Oleafly/releases/latest) или воспользуйтесь кнопкой скачивания на [oleafly.com](https://oleafly.com/) — она подбирает установщик под вашу платформу, когда может.

| Платформа | Скачать | Что делать |
|---|---|---|
| macOS (Apple Silicon) | `_aarch64.dmg` | M1 или новее. Откройте dmg и перетащите Oleafly в папку «Программы». |
| macOS (Intel) | `_x64.dmg` | Mac на Intel. Откройте dmg и перетащите Oleafly в папку «Программы». |
| Windows (x86_64) | `.msi` или `-setup.exe` | Запустите любой из установщиков и следуйте инструкциям. |
| Linux (x86_64) | `.AppImage`, `.deb` или `.rpm` | Используйте AppImage на большинстве дистрибутивов, пакет Debian на системах на базе Debian или RPM в Fedora. |
| Linux (ARM64) | `.AppImage`, `.deb` или `.rpm` | Собственные пакеты для Linux-систем ARM64. |

В Linux для Oleafly нужен glibc 2.35 или новее (примерно 2022 года или позже: Ubuntu 22.04+, Fedora 36+, Debian 12+).

Не знаете, какой у вас Mac? Откройте меню Apple и выберите **Об этом Mac**. Строка **Чип** означает Apple Silicon, а строка **Процессор** с названием Intel означает Mac на Intel.

Текущие поддерживаемые платформы: **macOS Apple Silicon**, **macOS Intel**, **Windows x64**, **Linux x64** и **Linux ARM64**. Для Windows на ARM собственного пакета пока нет.

## Первый запуск

### macOS

Откройте образ диска, перетащите Oleafly в папку «Программы» и запустите приложение. Используйте официальный установщик. Если macOS его блокирует, найдите сообщение о первом запуске в **Системные настройки → Конфиденциальность и безопасность**.

### Windows

Запустите MSI или установочный исполняемый файл и следуйте инструкциям установщика. Если Windows показывает предупреждение о репутации, прежде чем продолжить, убедитесь, что файл скачан из официального релиза. Установщик помещает рядом с приложением файл среды выполнения Microsoft Visual C++, который нужен Typst и языковому серверу LaTeX, поэтому отдельно устанавливать его не нужно.

### Linux

Используйте пакет Debian или RPM через менеджер пакетов или сделайте AppImage исполняемым и запустите его:

```bash
chmod +x Oleafly_*.AppImage
./Oleafly_*.AppImage
```

Для Oleafly нужен glibc 2.35 или новее. Выберите пакет под архитектуру вашего компьютера.

Пакеты `.deb` и `.rpm` хранят собственные Tectonic, Pandoc и Typst от Oleafly в `/usr/libexec/oleafly`, поэтому устанавливаются рядом с Pandoc вашего дистрибутива. При запуске AppImage добавляет себя в меню приложений, а это нужно рабочим столам на Wayland, например GNOME, чтобы показать его значок в доке. Меню остаётся нетронутым, если Oleafly уже добавили установленный пакет или другой инструмент, а удалённая вами запись остаётся удалённой.

У пакета Debian есть описание, поэтому Центр приложений Ubuntu показывает, что такое Oleafly, ещё до установки. Он также содержит данные AppStream, поэтому центры приложений показывают значок, лицензию, снимки экрана и версию после установки Oleafly. Приложение появляется в разделе «Офис» меню приложений. В Linux, как и в Windows, Oleafly рисует собственную строку заголовка. Его панель инструментов находится сверху, с кнопками сворачивания, разворачивания и закрытия. Перетащите панель инструментов, чтобы переместить окно, дважды щёлкните по ней для разворачивания и тяните за любой край или угол, чтобы изменить размер.

## Первая компиляция скачивает пакеты TeX

При первой компиляции документа на встроенном движке Tectonic он скачивает нужные этому документу пакеты и кэширует их. Первая компиляция на компьютере к тому же сразу скачивает набор часто используемых пакетов, поэтому следующие документы стартуют быстрее. Для этого нужно подключение к сети, и на медленной линии это может занять несколько минут. Лимит времени компиляции ждёт, пока пакеты ещё поступают, а если зеркало пакетов Oleafly не отвечает, компиляция переходит на исходный источник. Последующие компиляции того же документа быстрые и работают офлайн. Документ, которому нужен ещё не закэшированный пакет, вызывает ещё одну разовую загрузку. См. [Компиляция](/docs/compiling/), включая строгий офлайн-режим.

## По желанию: дистрибутив TeX

Tectonic покрывает большинство документов. Когда проекту нужен pdfLaTeX, upLaTeX или другой компилятор из полного дистрибутива TeX, Oleafly использует MacTeX, TeX Live, MiKTeX или TinyTeX, уже имеющийся на вашем компьютере. Если его нет, Oleafly может установить TinyTeX за вас из **Настройки → Движки → LaTeX** или прямо из ошибки компиляции. TinyTeX не требует прав администратора, загрузка занимает около 250 МБ, а свободного места на диске Oleafly просит около 2 ГБ.

- В Linux TinyTeX использует системный Perl. Если его нет, сначала установите: `sudo apt install perl`, `sudo dnf install perl` или `sudo pacman -S perl`.
- В Windows MiKTeX нужен Perl для запуска `latexmk`. Установите Strawberry Perl или TinyTeX, у которого свой Perl.
- В Debian, Ubuntu и Fedora TeX Live, установленный через `apt` или `dnf`, получает пакеты LaTeX тоже из `apt` или `dnf`. Oleafly говорит, что установить, но сам ничего не меняет.

См. [Движки и пакеты LaTeX](/docs/latex-engines/#latexmk-and-system-tex).

Ваши файлы остаются обычными папками на диске. Токены и ключи ИИ хранятся в зашифрованных локальных файлах, доступных только владельцу. К сетевым функциям относятся облачный ИИ, синхронизация с GitHub, скачивание пакетов, поиск цитат и проверка обновлений. См. [Философия](/docs/philosophy/).

## Обновление приложения

Oleafly проверяет подписанный канал релизов, показывает заметки о выпуске и устанавливает обновление на месте после вашего подтверждения. В Linux автоматическая замена работает для установок AppImage. Проверить наличие обновлений можно также из **Настройки → Справка и о программе**. См. [Обновления](/docs/updates/).

## Сборка из исходного кода

Следуйте [руководству по разработке настольного приложения](https://github.com/Oleafly/Oleafly/blob/main/docs/development.md) — в нём описаны требования, скачивание движков и локальная сборка.

## Дальнейшие шаги

- [Быстрый старт](/docs/getting-started/): от первого проекта до первого PDF за пару минут.
- [Шаблоны](/docs/templates/): встроенные заготовки и скачиваемые наборы.
- [Oleafly Learn](/learn/): бесплатный веб-курс по LaTeX и научному письму.
- [Инструмент командной строки](/docs/cli/): сборка, проверка и синхронизация проектов из терминала, подключение агентов для кода.
