# ダウンロードとインストール

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 を Applications にドラッグします。 |
| macOS (Intel) | `_x64.dmg` | Intel Mac 向け。dmg を開き、Oleafly を Applications にドラッグします。 |
| 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 では glibc 2.35 以降が必要です（2022 年以降の世代: Ubuntu 22.04 以降、Fedora 36 以降、Debian 12 以降）。

お使いの Mac の種類が分からない場合は、Apple メニューから**このMacについて**を開いてください。**チップ**の行があれば Apple Silicon、**プロセッサ**の行に Intel と表示されていれば Intel Mac です。

現在の配布対象は **macOS Apple Silicon** / **macOS Intel** / **Windows x64** / **Linux x64** / **Linux ARM64** の 5 つです。ARM 版 Windows 向けのネイティブパッケージはまだありません。

## 初回起動

### macOS

ディスクイメージを開き、Oleafly を Applications にドラッグして起動します。公式のインストーラーを使ってください。macOS にブロックされた場合は **システム設定 → プライバシーとセキュリティ** に表示される初回起動のメッセージを確認します。

### Windows

MSI またはセットアップ用の実行ファイルを実行し、インストーラーの案内に従います。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 デスクトップでは、これがないとドックにアイコンが表示されません。インストール済みのパッケージや別のツールがすでに 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 で `latexmk` を実行するには Perl が必要です。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 同期、パッケージのダウンロード、引用の検索、アップデートの確認があります。詳しくは [Oleafly を作る理由](/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/): ターミナルからプロジェクトをビルド、チェック、同期し、コーディングエージェントを接続します。
