# 下載與安裝

在 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 是哪一種？開啟蘋果選單，選擇 **關於這台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 的 App Center 在你安裝之前就會顯示 Oleafly 是什麼。它也帶有 AppStream 資料，所以 Oleafly 安裝後，軟體中心會顯示圖示、授權、螢幕截圖和版本。應用程式會出現在應用程式選單的 Office 類別下。在 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 會檢查已簽署的發行摘要來源（feed）、顯示版本資訊，並在你確認後就地安裝。在 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/)：從終端機建置、檢查與同步專案，並連接程式設計代理程式。
