본문으로 건너뛰기

Hello, world#

해당 가이드문서에서는 새로운 Vapor 프로젝트를 만들고, 빌드하고, 서버를 실행하는 단계별 절차를 안내합니다.

아직 Swift 또는 Vapor Toolbox를 설치하지 않았다면 하단에 운영체제에 맞게 설치하기 문서를 확인하세요.

Tip

Vapor Toolbox에서 사용하는 템플릿은 Swift 6.0 이상이 필요합니다.

새 프로젝트 생성하기#

첫 번째 단계는 컴퓨터에 새로운 Vapor 프로젝트를 만드는 것입니다. 터미널을 열고 Toolbox의 새 프로젝트 명령을 사용하세요. 이렇게 하면 현재 디렉토리에 새 폴더가 생성되며 프로젝트가 포함됩니다.

vapor new hello -n

Tip

-n 플래그를 사용하면 모든 질문에 자동으로 “no”로 대답하여 기본 템플릿을 얻을 수 있습니다.

Tip

Vapor Toolbox 없이도 템플릿 저장소를 클론하여 GitHub에서 최신 템플릿을 사용할 수 있습니다.

Tip

Vapor와 템플릿은 이제 기본적으로 async/await을 사용합니다. macOS 12로 업데이트할 수 없거나 EventLoopFuture를 계속 사용해야 하는 경우 --branch macos10-15 플래그를 사용하세요.

명령이 완료되면 새로 생성된 폴더로 이동하세요.

cd hello

빌드 & 실행#

Xcode#

먼저, Xcode에서 프로젝트를 엽니다.

open Package.swift

Swift Package Manager 종속성을 자동으로 다운로드하기 시작합니다. 이는 프로젝트를 처음 열 때는 시간이 걸릴 수 있습니다. 종속성 해결이 완료되면 Xcode에서 사용 가능한 스키마가 표시됩니다.

창 상단에서 재생 및 정지 버튼 오른쪽에 프로젝트 이름을 클릭하여 프로젝트의 스키마를 선택하고 적절한 실행 대상(아마도 “My Mac”)을 선택하세요. 재생 버튼을 클릭하여 프로젝트를 빌드하고 실행합니다.

Xcode 창 하단에 콘솔이 아래처럼 보일 것입니다.

[ INFO ] Server starting on http://127.0.0.1:8080

Linux#

Linux 및 다른 운영 체제(또는 macOS에서 Xcode를 사용하지 않을 경우)에서는 Vim이나 VSCode와 같은 즐겨찾는 편집기에서 프로젝트를 편집할 수 있습니다. 다른 IDE를 설정하는 방법에 대한 최신 정보는 Swift Server Guides를 참조하세요.

Tip

VSCode를 코드 에디터로 사용하고 있다면, 공식 Vapor 확장 프로그램인 Vapor for VS Code를 설치하는 것을 권장합니다.

프로젝트를 빌드하고 실행하려면 터미널에서 다음 명령을 실행합니다.

swift run

이 명령은 프로젝트를 빌드하고 실행합니다. 처음 실행할 때는 종속성을 가져오고 해결하는 데 시간이 걸립니다. 실행 중에는 콘솔에서 다음과 같은 출력을 볼 수 있어야 합니다.

[ INFO ] Server starting on http://127.0.0.1:8080

Localhost 접속해보기#

웹 브라우저를 열고, localhost:8080/hello 또는 http://127.0.0.1:8080을 접속해봅니다.

해당 웹페이지에서는 다음과 같이 표시되어야 합니다.

Hello, world!

첫 번째 Vapor앱을 만들고 빌드하고 실행한 것을 축하드립니다! 🎉

이 페이지 편집