Passer au contenu

Installation sur Linux#

Pour utiliser Vapor, vous aurez besoin de Swift 5.9 ou plus. Vous pouvez l’installer avec l’outil CLI Swiftly fourni par le Groupe de Travail Swift pour le Server (recommandé), ou utiliser les toolchains disponibles sur Swift.org.

Distributions et Versions supportées#

Vapor supporte les mêmes versions de distribution Linux supportées par Swift 5.9 ou supérieur. Veuillez vous référer à la page de support officielle pour trouver les informations à jour concernant les systèmes d’exploitation officiellement supportés.

Les distributions Linux non officiellement supportées peuvent aussi faire tourner Swift en compilant le code source, mais Vapor ne peut garantir une quelconque stabilité. Plus d’informations sur comment compiler Swift sur le dépot Swift.

Installer Swift#

Installation automatisée via l’outil CLI Swiftly (recommandé)#

Rendez-vous sur le site de Swiflty pour les instructions d’installation de Swiftly ainsi que de Swift sur Linux. Après quoi, installer Swift avec la commande suivante :

Usage de base#

$ swiftly install latest

Fetching the latest stable Swift release...
Installing Swift 5.9.1
Downloaded 488.5 MiB of 488.5 MiB
Extracting toolchain...
Swift 5.9.1 installed successfully!

$ swift --version

Swift version 5.9.1 (swift-5.9.1-RELEASE)
Target: x86_64-unknown-linux-gnu

Installation manuelle avec la toolchain#

Se rendre sur le guide de Swift.org Using Downloads pour avoir les instructions d’installation de Swift sur Linux.

Fedora#

Les utilisateurs de Fedora peuvent simplement installer Swift avec cette commande :

sudo dnf install swift-lang

Si vous utilisez Fedora 35, vous devrez ajouter EPEL 8 pour obtenir Swift 5.9 ou une version plus récente.

Docker#

Vous pouvez également utiliser les images Docker officielles de Swift qui embarquent le compilateur pré-installé. Voir plus d’informations sur le Docker Hub Swift.

Installer la Toolbox#

Maintenant que Swift est installé, installons la Toolbox Vapor. Cet outil en lignes de commandes n’est pas nécessaire pour utiliser Vapor, mais il aide à créer de nouveaux projets.

Homebrew#

La Toolbox est distribuée via Homebrew. Si vous n’avez pas encore Homebrew, rendez-vous sur brew.sh pour suivre les instructions d’installation.

brew install vapor

Vérifiez que l’installation a bien été réalisée en affichant l’aide.

vapor --help

Vous devriez voir la liste des commandes disponibles.

Makefile#

Si vous le souhaitez, vous pouvez également compiler la Toolbox à partir des sources. Voir les livraisons de la Toolbox sur GitHub pour trouver la dernière version.

git clone https://github.com/vapor/toolbox.git
cd toolbox
git checkout <desired version>
make install

Vérifiez que l’installation a bien été réalisée en affichant l’aide.

vapor --help

Vous devriez voir la liste des commandes disponibles.

Ensuite#

Maintenant que Swift et la Toolbox Vapor sont installés, créez votre première application dans le chapitre Débuter → Hello, world.

Modifier cette page