Witaj, świecie#
Then poradnik przeprowadzi cię krok po kroku przez tworzenie nowego projektu z użyciem Vapor, budowania go oraz uruchomienie serwera.
Jeśli jeszcze nie masz zainstalowanego Swifta czy Vapor Toolbox, to sprawdź sekcje poniżej.
Nowy projekt#
Pierwszym krokiem jest utworzenie nowego projektu Vapor na komputerze. Otwórz terminal i użyj polecenia nowego projektu w Toolbox. Spowoduje to utworzenie nowego folderu w bieżącym katalogu zawierającego projekt.
vapor new hello -n
Tip
Flaga -n tworzy projekt z użyciem minimalistycznego szablonu, po przez odpowiadanie na wszystkie pytania nie.
Tip
Można również pobrać najnowszy szablon z GitHub bez Vapor Toolbox, klonując repozytorium z szablonami.
Tip
Vapor i szablon używają teraz domyślnie async/await.
Jeśli nie możesz zaktualizować systemu do macOS 12 i/lub chcesz nadal używać EventLoopFuture,
użyj flagi --branch macos10-15.
Po tym jak działanie komendy zakończy się, wejdź do nowo stworzonego folderu przy użyciu:
cd hello
Zbuduj i uruchom#
Xcode#
Najpierw, otwórz projekt w XCode.
open Package.swift
Automatycznie rozpocznie pobieranie zależności Menedżera pakietów Swift. Może to zająć trochę czasu przy pierwszym otwarciu projektu. Po zakończeniu rozpoznawania zależności Xcode wypełni dostępne schematy.
W górnej części okna, po prawej stronie przycisków Play i Stop, kliknij nazwę projektu, aby wybrać schemat projektu i wybierz odpowiedni cel uruchamiania - najprawdopodobniej “My Mac”. Kliknij przycisk odtwarzania, aby utworzyć i uruchomić projekt.
W oknie terminala Xcode powinna pojawić się konsola.
[ INFO ] Server starting on http://127.0.0.1:8080
Linux#
W systemie Linux i innych systemach operacyjnych (a nawet w systemie macOS, jeśli nie chcesz używać Xcode) możesz edytować projekt w swoim ulubionym edytorze, takim jak Vim lub VSCode. Aktualne informacje na temat konfiguracji innych IDE można znaleźć w Swift Server Guides.
Aby zbudować i uruchomić projekt, w Terminalu uruchom:
swift run
Spowoduje to zbudowanie i uruchomienie projektu. Przy pierwszym uruchomieniu pobieranie i rozwiązywanie zależności zajmie trochę czasu. Po uruchomieniu powinieneś zobaczyć następujące informacje w konsoli:
[ INFO ] Server starting on http://127.0.0.1:8080
Odwiedź localhost#
Otwórz swoją przeglądarkę, a następnie adres: localhost:8080/hello lub http://127.0.0.1:8080
Powinieneś widzieć następująca stronę.
Hello, world!
Gratulujemy stworzenia, zbudowania i uruchomienia twojej pierwszej aplikacji z użyciem Vapora! 🎉🎉