# Télécharger et installer

Installez Oleafly sur macOS, Windows ou Linux, puis découvrez ce que l'application peut télécharger à la première utilisation.

Installer Oleafly se résume à un téléchargement et un double-clic. Pas de compte, pas de connexion et pas de distribution LaTeX séparée : le compilateur est intégré à l'application.

## Télécharger l'application

Récupérez le dernier installateur depuis la [page des versions](https://github.com/Oleafly/Oleafly/releases/latest), ou utilisez le bouton de téléchargement sur [oleafly.com](https://oleafly.com/), qui détermine l'installateur correspondant à votre plateforme quand c'est possible.

| Plateforme | Téléchargement | Que faire |
|---|---|---|
| macOS (Apple Silicon) | `_aarch64.dmg` | M1 ou plus récent. Ouvrez le dmg, glissez Oleafly dans Applications. |
| macOS (Intel) | `_x64.dmg` | Mac Intel. Ouvrez le dmg, glissez Oleafly dans Applications. |
| Windows (x86_64) | `.msi` ou `-setup.exe` | Exécutez l'un ou l'autre installateur et suivez les instructions. |
| Linux (x86_64) | `.AppImage`, `.deb` ou `.rpm` | Utilisez l'AppImage sur la plupart des distributions, le paquet Debian sur les systèmes basés sur Debian, ou le RPM sous Fedora. |
| Linux (ARM64) | `.AppImage`, `.deb` ou `.rpm` | Paquets natifs pour les systèmes Linux ARM64. |

Sous Linux, Oleafly nécessite glibc 2.35 ou plus récent (de 2022 ou ultérieur : Ubuntu 22.04+, Fedora 36+, Debian 12+).

Vous ne savez pas quel Mac vous avez ? Ouvrez le menu Pomme et choisissez **À propos de ce Mac**. Une ligne **Puce** indique Apple Silicon ; une ligne **Processeur** qui mentionne Intel indique un Mac Intel.

Les cibles actuellement distribuées sont **macOS Apple Silicon**, **macOS Intel**, **Windows x64**, **Linux x64** et **Linux ARM64**. Windows sur ARM n'a pas encore de paquet natif.

## Premier lancement

### macOS

Ouvrez l'image disque, glissez Oleafly dans Applications, puis lancez-le. Utilisez l'installateur officiel. Si macOS le bloque, consultez **Réglages Système → Confidentialité et sécurité** pour le message de premier lancement.

### Windows

Exécutez le MSI ou l'exécutable d'installation et suivez l'installateur. Si Windows affiche un avertissement de réputation, vérifiez que le téléchargement provient de la version officielle avant de continuer. L'installateur place le fichier d'exécution Microsoft Visual C++, nécessaire à Typst et au serveur de langage LaTeX, à côté de l'application : vous n'avez donc pas à l'installer séparément.

### Linux

Utilisez le paquet Debian ou RPM avec votre gestionnaire de paquets, ou rendez l'AppImage exécutable et ouvrez-la :

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

Oleafly nécessite glibc 2.35 ou plus récent. Choisissez le paquet correspondant à l'architecture de votre ordinateur.

Les paquets `.deb` et `.rpm` gardent les Tectonic, Pandoc et Typst propres à Oleafly dans `/usr/libexec/oleafly`, de sorte qu'ils s'installent à côté du Pandoc de votre distribution. Quand vous lancez l'AppImage, elle s'ajoute elle-même au menu de vos applications, ce dont les bureaux Wayland comme GNOME ont besoin avant d'afficher son icône dans le dock. Elle laisse le menu tranquille quand un paquet installé ou un autre outil a déjà ajouté Oleafly, et si vous supprimez l'entrée, elle reste supprimée.

Le paquet Debian comporte une description, ainsi l'App Center d'Ubuntu montre ce qu'est Oleafly avant que vous l'installiez. Il transporte aussi des données AppStream, de sorte que les logithèques affichent l'icône, la licence, les captures d'écran et la version une fois Oleafly installé. L'application apparaît sous Office dans votre menu d'applications. Sous Linux, comme sous Windows, Oleafly dessine sa propre barre de titre. Sa barre d'outils se trouve en haut avec les boutons de réduction, d'agrandissement et de fermeture. Faites glisser la barre d'outils pour déplacer la fenêtre, double-cliquez dessus pour l'agrandir et faites glisser un bord ou un coin pour la redimensionner.

## La première compilation télécharge des paquets TeX

La première fois que vous compilez un document avec le moteur Tectonic intégré, Oleafly télécharge les paquets dont ce document a besoin et les met en cache. La première compilation sur un ordinateur récupère aussi d'un seul coup un lot de paquets d'usage courant, si bien que les documents suivants démarrent plus vite. Cela nécessite une connexion réseau et peut prendre quelques minutes sur une connexion lente. La limite de temps de compilation attend tant que des paquets arrivent encore, et si le miroir de paquets d'Oleafly échoue, la compilation se rabat sur la source amont. Les compilations suivantes du même document sont rapides et fonctionnent hors ligne. Un document qui nécessite un paquet que vous n'avez pas encore en cache déclenche un nouveau téléchargement unique. Voir [Compiler](/docs/compiling/), y compris le mode hors ligne strict.

## Facultatif : une distribution TeX

Tectonic couvre la plupart des documents. Quand un projet a besoin de pdfLaTeX, upLaTeX ou d'un autre compilateur d'une distribution TeX complète, Oleafly utilise le MacTeX, TeX Live, MiKTeX ou TinyTeX déjà présent sur votre ordinateur. S'il n'y en a pas, il peut installer TinyTeX pour vous depuis **Paramètres → Moteurs → LaTeX**, ou directement depuis l'erreur de compilation. TinyTeX ne demande aucun droit d'administrateur, le téléchargement fait environ 250 Mo, et Oleafly demande environ 2 Go d'espace disque libre.

- Sous Linux, TinyTeX utilise le Perl du système. Installez-le d'abord s'il manque : `sudo apt install perl`, `sudo dnf install perl` ou `sudo pacman -S perl`.
- Sous Windows, MiKTeX a besoin de Perl pour exécuter `latexmk`. Installez Strawberry Perl, ou installez TinyTeX, qui apporte le sien.
- Sur Debian, Ubuntu et Fedora, un TeX Live que vous avez installé avec `apt` ou `dnf` reçoit aussi ses paquets LaTeX d'`apt` ou de `dnf`. Oleafly vous dit quoi installer mais n'y change rien.

Voir [Moteurs et paquets LaTeX](/docs/latex-engines/#latexmk-and-system-tex).

Vos fichiers restent dans de simples dossiers sur le disque. Les jetons et les clés IA résident dans des fichiers locaux chiffrés, accessibles uniquement à votre utilisateur. Les fonctions en ligne incluent l'IA hébergée, la synchronisation GitHub, le téléchargement de paquets, la recherche de citations et la vérification des mises à jour. Voir [Philosophie](/docs/philosophy/).

## Rester à jour

Oleafly consulte un flux de versions signé, affiche les notes de version et s'installe sur place quand vous confirmez. Sous Linux, le remplacement automatique fonctionne pour les installations AppImage. Vous pouvez aussi vérifier depuis **Paramètres → Aide et à propos**. Voir [Mises à jour](/docs/updates/).

## Compiler à partir des sources

Suivez le [guide de développement desktop](https://github.com/Oleafly/Oleafly/blob/main/docs/development.md) pour les prérequis, les téléchargements de moteurs et les builds locaux.

## Prochaines étapes

- [Premiers pas](/docs/getting-started/) : du premier projet au premier PDF en quelques minutes.
- [Modèles](/docs/templates/) : modèles intégrés et packs téléchargeables.
- [Oleafly Learn](/learn/) : cursus gratuit de LaTeX et de rédaction scientifique sur le web.
- [Outil en ligne de commande](/docs/cli/) : compiler, vérifier et synchroniser des projets depuis un terminal, et connecter des agents de code.
