Hallo Welt!#
In diesem Abschnitt erklären wir dir Schritt für Schritt, wie du ein neues Vapor-Projekt erstellst, baust und den Server ausführst.
Falls du Swift oder die Vapor Toolbox noch nicht installiert hast, wirf zuerst einen Blick in die Installationsabschnitte.
Tip
Die Vorlage der Vapor Toolbox benötigt Swift 6.0 oder neuer.
Neues Projekt#
Der erste Schritt besteht darin, ein neues Vapor-Projekt auf deinem Computer zu erstellen. Öffne dein Terminal und nutze den Toolbox-Befehl für ein neues Projekt. Dadurch wird im aktuellen Verzeichnis ein neuer Ordner mit dem Projekt erstellt.
vapor new hello -n
Tip
Das Flag -n erstellt dir eine einfache Vorlage, indem alle Fragen automatisch mit “Nein” beantwortet werden.
Tip
Du kannst die neueste Vorlage auch ohne die Vapor Toolbox von GitHub erhalten, indem du das Vorlagen-Repository klonst.
Tip
Vapor und die Vorlage verwenden inzwischen standardmäßig async/await.
Falls du nicht auf macOS 12 aktualisieren kannst und/oder weiterhin EventLoopFutures verwenden musst,
nutze das Flag --branch macos10-15.
Sobald der Befehl durchgelaufen ist, wechsele in den neu erstellten Ordner:
cd hello
Bauen & Ausführen#
Xcode#
Öffne zunächst das Projekt in Xcode:
open Package.swift
Xcode beginnt automatisch damit, die Abhängigkeiten des Swift Package Managers herunterzuladen. Das kann beim ersten Öffnen eines Projekts einige Zeit in Anspruch nehmen. Sobald die Abhängigkeiten aufgelöst sind, füllt Xcode die verfügbaren Schemes.
Klicke oben im Fenster, rechts neben den Play- und Stop-Buttons, auf deinen Projektnamen, um das Scheme des Projekts auszuwählen, und wähle ein passendes Run-Target aus — meist “My Mac”. Klicke auf den Play-Button, um dein Projekt zu bauen und auszuführen.
Du solltest nun unten im Xcode-Fenster die Konsole sehen.
[ INFO ] Server starting on http://127.0.0.1:8080
Linux#
Unter Linux und anderen Betriebssystemen (und auch unter macOS, falls du Xcode nicht verwenden möchtest) kannst du das Projekt in deinem bevorzugten Editor bearbeiten, wie z. B. Vim oder VSCode. Aktuelle Informationen zur Einrichtung anderer IDEs findest du in den Swift Server Guides.
Tip
Falls du VSCode als Code-Editor verwendest, empfehlen wir die Installation der offiziellen Vapor-Erweiterung: Vapor for VS Code.
Um dein Projekt zu bauen und auszuführen, führe im Terminal Folgendes aus:
swift run
Das baut und startet das Projekt. Beim ersten Ausführen kann das Abrufen und Auflösen der Abhängigkeiten etwas Zeit in Anspruch nehmen. Sobald es läuft, solltest du Folgendes in deiner Konsole sehen:
[ INFO ] Server starting on http://127.0.0.1:8080
Lokalen Server aufrufen#
Öffne deinen Webbrowser und besuche localhost:8080/hello oder http://127.0.0.1:8080.
Du solltest die folgende Seite sehen.
Hello, world!
Herzlichen Glückwunsch zum Erstellen, Bauen und Ausführen deiner ersten Vapor-App! 🎉