# 下载与安装

在 macOS、Windows 或 Linux 上安装 Oleafly，并了解应用在首次使用时可能下载哪些内容。

安装 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` | Intel 版 Mac。打开 dmg，把 Oleafly 拖到“应用程序”。 |
| Windows（x86_64） | `.msi` 或 `-setup.exe` | 运行任一安装程序，并按提示操作。 |
| Linux（x86_64） | `.AppImage`、`.deb` 或 `.rpm` | 大多数发行版使用 AppImage，基于 Debian 的系统使用 Debian 软件包，Fedora 上使用 RPM。 |
| Linux（ARM64） | `.AppImage`、`.deb` 或 `.rpm` | 适用于 ARM64 Linux 系统的原生软件包。 |

在 Linux 上，Oleafly 需要 glibc 2.35 或更新版本（2022 年及以后的发行版：Ubuntu 22.04+、Fedora 36+、Debian 12+）。

不确定自己的 Mac 是哪一种？打开苹果菜单，选择 **关于本机**。如果看到 **芯片** 一行，就是 Apple Silicon；如果 **处理器** 一行写着 Intel，就是 Intel 版 Mac。

目前发布的目标是 **macOS Apple Silicon**、**macOS Intel**、**Windows x64**、**Linux x64** 和 **Linux ARM64**。Windows on ARM 暂时还没有原生安装包。

## 首次启动

### macOS

打开磁盘映像，把 Oleafly 拖到“应用程序”，然后启动它。请使用官方安装包。如果 macOS 阻止了它，请在 **系统设置 → 隐私与安全性** 中查看首次启动的提示。

### Windows

运行 MSI 或 setup 可执行文件，并按安装程序操作。如果 Windows 显示信誉警告，请先确认下载来自官方发布，再继续。安装程序会把 Typst 和 LaTeX 语言服务器所需的 Microsoft Visual C++ 运行库文件放在应用旁边，所以你不必另外安装它。

### Linux

用包管理器安装 Debian 或 RPM 软件包，或者给 AppImage 添加可执行权限并打开它：

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

Oleafly 需要 glibc 2.35 或更新版本。请选择与你电脑架构相符的软件包。

`.deb` 和 `.rpm` 软件包把 Oleafly 自带的 Tectonic、Pandoc 和 Typst 放在 `/usr/libexec/oleafly` 中，所以它们可以与你的发行版自带的 Pandoc 并存安装。启动 AppImage 时，它会把自己添加到你的应用菜单中，GNOME 这类 Wayland 桌面需要先有这个菜单项，才会在 Dock 中显示它的图标。如果已安装的软件包或其他工具已经添加了 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。如果没有，它可以从 **设置 → 引擎 → LaTeX** 为你安装 TinyTeX，也可以直接从编译错误中安装。TinyTeX 不需要管理员权限，下载大小约 250 MB，Oleafly 要求约 2 GB 的可用磁盘空间。

- 在 Linux 上，TinyTeX 使用系统的 Perl。如果缺少，请先安装：`sudo apt install perl`、`sudo dnf install perl` 或 `sudo pacman -S perl`。
- 在 Windows 上，MiKTeX 需要 Perl 才能运行 `latexmk`。请安装 Strawberry Perl，或安装自带 Perl 的 TinyTeX。
- 在 Debian、Ubuntu 和 Fedora 上，用 `apt` 或 `dnf` 安装的 TeX Live，其 LaTeX 宏包也来自 `apt` 或 `dnf`。Oleafly 会告诉你该安装什么，但不会改动它。

请参阅 [LaTeX 引擎与宏包](/docs/latex-engines/#latexmk-and-system-tex)。

你的文件仍是磁盘上的普通文件夹。令牌和 AI 密钥保存在加密的、仅限所有者访问的本地文件中。在线功能包括托管的 AI、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/)：在终端中构建、检查和同步项目，并连接编程代理。
