mirror of https://github.com/vapor/docs.git
82 lines
3.0 KiB
Markdown
82 lines
3.0 KiB
Markdown
# 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.
|
|
|
|
- [Instalacja → macOS](../install/macos.md)
|
|
- [Instalacja → Linux](../install/linux.md)
|
|
|
|
## 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.
|
|
|
|
```sh
|
|
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](https://github.com/vapor/template-bare).
|
|
|
|
!!! 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:
|
|
|
|
```sh
|
|
cd hello
|
|
```
|
|
|
|
## Zbuduj i uruchom
|
|
|
|
### Xcode
|
|
|
|
Najpierw, otwórz projekt w XCode.
|
|
|
|
```sh
|
|
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.
|
|
|
|
```sh
|
|
[ 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](https://github.com/swift-server/guides/blob/main/docs/setup-and-ide-alternatives.md).
|
|
|
|
Aby zbudować i uruchomić projekt, w Terminalu uruchom:
|
|
|
|
```sh
|
|
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:
|
|
|
|
```sh
|
|
[ INFO ] Server starting on http://127.0.0.1:8080
|
|
```
|
|
|
|
## Odwiedź localhost
|
|
|
|
Otwórz swoją przeglądarkę, a następnie adres: <a href="http://localhost:8080/hello" target="_blank">localhost:8080/hello</a> lub <a href="http://127.0.0.1:8080" target="_blank">http://127.0.0.1:8080</a>
|
|
|
|
Powinieneś widzieć następująca stronę.
|
|
|
|
```html
|
|
Hello, world!
|
|
```
|
|
|
|
Gratulujemy stworzenia, zbudowania i uruchomienia twojej pierwszej aplikacji z użyciem Vapora! 🎉🎉
|