mirror of https://github.com/vapor/docs.git
Start Korean translation (#841)
Added Korean as a new language. Translated Welcome ~ Getting Started document first.
This commit is contained in:
sookim
GitHub
parent
9cde126e7c
commit
eae2c9b388
|
|
@ -12,5 +12,6 @@ Languages:
|
|||
- [ ] Italian
|
||||
- [ ] Spanish
|
||||
- [ ] Polish
|
||||
- [ ] Korean
|
||||
|
||||
Assigned to @vapor/translators - please submit a PR with the relevant updates and check the box once merged. Please ensure you tag your PR with the `translation-update` so it doesn't create a new issue!
|
||||
|
|
|
|||
|
|
@ -0,0 +1,83 @@
|
|||
# 폴더 구조
|
||||
|
||||
이제 첫 번째 Vapor 앱을 만들고 빌드하고 실행했으니, Vapor의 폴더 구조에 익숙해지는 시간을 가져보겠습니다. 이 구조는 SPM의 폴더 구조를 기반으로 하기 때문에, 이전에 [SPM](spm.ko.md)을 사용한 적이 있다면 익숙할 것입니다.
|
||||
|
||||
```
|
||||
.
|
||||
├── Public
|
||||
├── Sources
|
||||
│ ├── App
|
||||
│ │ ├── Controllers
|
||||
│ │ ├── Migrations
|
||||
│ │ ├── Models
|
||||
│ │ ├── configure.swift
|
||||
│ │ ├── entrypoint.swift
|
||||
│ │ └── routes.swift
|
||||
│
|
||||
├── Tests
|
||||
│ └── AppTests
|
||||
└── Package.swift
|
||||
```
|
||||
|
||||
아래의 섹션에서는 폴더 구조의 각 부분을 자세히 설명합니다.
|
||||
|
||||
## Public
|
||||
|
||||
이 폴더에는 `FileMiddleware`가 활성화된 경우 앱에서 제공되는 공개 파일이 포함됩니다. 일반적으로 이미지, 스타일 시트 및 브라우저 스크립트가 여기에 포함됩니다. 예를 들어, `localhost:8080/favicon.ico`로의 요청은 `Public/favicon.ico` 파일의 존재 여부를 확인하고 해당 파일을 반환합니다.
|
||||
해당 [https://vapor.codes/favicon.ico](https://vapor.codes/favicon.ico)에 접속하면 Vapor로고 이미지를 확인할 수 있습니다.
|
||||
|
||||
Vapor가 공개 파일을 제공하기 위해선 `configure.swift` 파일에서 `FileMiddleware`를 활성화해야 합니다.
|
||||
|
||||
|
||||
```swift
|
||||
// Serves files from `Public/` directory
|
||||
let fileMiddleware = FileMiddleware(
|
||||
publicDirectory: app.directory.publicDirectory
|
||||
)
|
||||
app.middleware.use(fileMiddleware)
|
||||
```
|
||||
|
||||
## Sources
|
||||
|
||||
이 폴더에는 프로젝트의 모든 Swift 소스 파일이 포함됩니다.
|
||||
최상위 폴더인 `App`은 [SwiftPM](spm.ko.md) 매니페스트에서 선언된 패키지 모듈을 반영합니다.
|
||||
|
||||
### App
|
||||
|
||||
이 폴더는 애플리케이션 로직이 모두 들어가는 곳입니다.
|
||||
|
||||
#### Controllers
|
||||
|
||||
컨트롤러는 애플리케이션 로직을 그룹화하는 좋은 방법입니다. 대부분의 컨트롤러에는 요청을 받아들이고 어떤 형태의 응답을 반환하는 많은 함수가 있습니다.
|
||||
|
||||
#### Migrations
|
||||
|
||||
마이그레이션 폴더는 Fluent를 사용하는 경우 데이터베이스 마이그레이션을 위한 곳입니다.
|
||||
|
||||
#### Models
|
||||
|
||||
모델 폴더는 `Content` 구조체나 Fluent `Model`을 저장하기 좋은 장소입니다.
|
||||
|
||||
#### configure.swift
|
||||
|
||||
이 파일에는 `configure(_:)` 함수가 포함되어 있습니다. 이 메서드는 `entrypoint.swift`에 의해 호출되어 새로 생성된 `Application`을 구성합니다. 여기에서 라우트, 데이터베이스, 프로바이더 등과 같은 서비스를 등록해야 합니다.
|
||||
|
||||
#### entrypoint.swift
|
||||
|
||||
이 파일에는 Vapor 애플리케이션을 설정, 구성 및 실행하는 `@main` 진입점이 포함되어 있습니다.
|
||||
|
||||
#### routes.swift
|
||||
|
||||
이 파일에는 `routes(_:)` 함수가 포함되어 있습니다. 이 메서드는 `configure(_:)`의 마지막 부분에서 `Application`에 라우트를 등록하는 데 사용됩니다.
|
||||
|
||||
## Tests
|
||||
|
||||
`Sources` 폴더의 각 비실행(non-executable) 모듈은 `Tests`에 해당하는 폴더를 가질 수 있습니다. 이 폴더에는 패키지를 테스트하기 위해 `XCTest` 모듈을 기반으로 작성된 코드가 포함됩니다. 테스트는 명령줄에서 `swift test`를 사용하거나 Xcode에서 ⌘+U를 눌러 실행할 수 있습니다.
|
||||
|
||||
### AppTests
|
||||
|
||||
이 폴더에는 `App` 모듈의 코드를 위한 단위 테스트가 포함되어 있습니다.
|
||||
|
||||
## Package.swift
|
||||
|
||||
마지막으로 [SPM](spm.ko.md)의 패키지 매니페스트가 있습니다.
|
||||
|
|
@ -0,0 +1,80 @@
|
|||
# Hello, world
|
||||
|
||||
해당 가이드문서에서는 새로운 Vapor 프로젝트를 만들고, 빌드하고, 서버를 실행하는 단계별 절차를 안내합니다.
|
||||
|
||||
아직 Swift 또는 Vapor Toolbox를 설치하지 않았다면 하단에 운영체제에 맞게 설치하기 문서를 확인하세요.
|
||||
|
||||
- [Install → macOS](../install/macos.ko.md)
|
||||
- [Install → Linux](../install/linux.ko.md)
|
||||
|
||||
## 새 프로젝트 생성하기
|
||||
|
||||
첫 번째 단계는 컴퓨터에 새로운 Vapor 프로젝트를 만드는 것입니다. 터미널을 열고 Toolbox의 새 프로젝트 명령을 사용하세요. 이렇게 하면 현재 디렉토리에 새 폴더가 생성되며 프로젝트가 포함됩니다.
|
||||
|
||||
```sh
|
||||
vapor new hello -n
|
||||
```
|
||||
|
||||
!!! 팁
|
||||
`-n` 플래그를 사용하면 모든 질문에 자동으로 "no"로 대답하여 기본 템플릿을 얻을 수 있습니다.
|
||||
|
||||
!!! 팁
|
||||
Vapor Toolbox 없이도 [템플릿 저장소](https://github.com/vapor/template-bare)를 클론하여 GitHub에서 최신 템플릿을 사용할 수 있습니다.
|
||||
|
||||
!!! 팁
|
||||
Vapor와 템플릿은 이제 기본적으로 `async`/`await`을 사용합니다. macOS 12로 업데이트할 수 없거나 EventLoopFuture를 계속 사용해야 하는 경우 `--branch macos10-15` 플래그를 사용하세요.
|
||||
|
||||
명령이 완료되면 새로 생성된 폴더로 이동하세요.
|
||||
|
||||
|
||||
```sh
|
||||
cd hello
|
||||
```
|
||||
|
||||
## 빌드 & 실행
|
||||
|
||||
### Xcode
|
||||
|
||||
먼저, Xcode에서 프로젝트를 엽니다.
|
||||
|
||||
```sh
|
||||
open Package.swift
|
||||
```
|
||||
|
||||
Swift Package Manager 종속성을 자동으로 다운로드하기 시작합니다. 이는 프로젝트를 처음 열 때는 시간이 걸릴 수 있습니다. 종속성 해결이 완료되면 Xcode에서 사용 가능한 스키마가 표시됩니다.
|
||||
|
||||
창 상단에서 재생 및 정지 버튼 오른쪽에 프로젝트 이름을 클릭하여 프로젝트의 스키마를 선택하고 적절한 실행 대상(아마도 "My Mac")을 선택하세요. 재생 버튼을 클릭하여 프로젝트를 빌드하고 실행합니다.
|
||||
|
||||
Xcode 창 하단에 콘솔이 아래처럼 보일 것입니다.
|
||||
|
||||
```sh
|
||||
[ INFO ] Server starting on http://127.0.0.1:8080
|
||||
```
|
||||
|
||||
### Linux
|
||||
|
||||
Linux 및 다른 운영 체제(또는 macOS에서 Xcode를 사용하지 않을 경우)에서는 Vim이나 VSCode와 같은 즐겨찾는 편집기에서 프로젝트를 편집할 수 있습니다. 다른 IDE를 설정하는 방법에 대한 최신 정보는 [Swift Server Guides](https://github.com/swift-server/guides/blob/main/docs/setup-and-ide-alternatives.md)를 참조하세요.
|
||||
|
||||
프로젝트를 빌드하고 실행하려면 터미널에서 다음 명령을 실행합니다.
|
||||
|
||||
```sh
|
||||
swift run
|
||||
```
|
||||
|
||||
이 명령은 프로젝트를 빌드하고 실행합니다. 처음 실행할 때는 종속성을 가져오고 해결하는 데 시간이 걸립니다. 실행 중에는 콘솔에서 다음과 같은 출력을 볼 수 있어야 합니다.
|
||||
|
||||
```sh
|
||||
[ INFO ] Server starting on http://127.0.0.1:8080
|
||||
```
|
||||
|
||||
## Localhost 접속해보기
|
||||
|
||||
웹 브라우저를 열고, <a href="http://localhost:8080/hello" target="_blank">localhost:8080/hello</a> 또는 <a href="http://127.0.0.1:8080" target="_blank">http://127.0.0.1:8080</a>을 접속해봅니다.
|
||||
|
||||
해당 웹페이지에서는 다음과 같이 표시되어야 합니다.
|
||||
|
||||
```html
|
||||
Hello, world!
|
||||
```
|
||||
|
||||
첫 번째 Vapor앱을 만들고 빌드하고 실행한 것을 축하드립니다! 🎉
|
||||
|
|
@ -0,0 +1,95 @@
|
|||
# Swift Package Manager
|
||||
|
||||
[Swift Package Manager](https://swift.org/package-manager/) (SPM)은 프로젝트의 소스 코드 및 종속성을 빌드하는 데 사용됩니다. Vapor는 SPM을 강력하게 활용하므로 SPM의 기본 원리를 이해하는 것이 좋습니다.
|
||||
|
||||
SPM은 Cocoapods, Ruby Gems 및 NPM과 유사합니다. `swift build` 및 `swift test`와 같은 명령어로 command line(커맨드라인)에서 SPM을 사용할 수 있으며, 호환되는 IDE에서도 사용할 수 있습니다. 그러나 다른 일부 패키지 관리자와는 달리 SPM은 중앙 패키지 인덱스가 없습니다. 대신 SPM은 Git 저장소의 URL을 활용하며, [Git tags](https://git-scm.com/book/en/v2/Git-Basics-Tagging)를 사용하여 버전 의존성을 관리합니다.
|
||||
|
||||
## Package Manifest
|
||||
|
||||
SPM이 프로젝트에서 먼저 찾는 곳은 Package Manifest입니다. 이는 프로젝트의 루트 디렉토리에 있어야 하며 `Package.swift`로 이름이 지정되어야 합니다.
|
||||
|
||||
다음은 Package Manifest의 예입니다.
|
||||
|
||||
```swift
|
||||
// swift-tools-version:5.8
|
||||
import PackageDescription
|
||||
|
||||
let package = Package(
|
||||
name: "MyApp",
|
||||
platforms: [
|
||||
.macOS(.v12)
|
||||
],
|
||||
dependencies: [
|
||||
.package(url: "https://github.com/vapor/vapor.git", from: "4.76.0"),
|
||||
],
|
||||
targets: [
|
||||
.executableTarget(
|
||||
name: "App",
|
||||
dependencies: [
|
||||
.product(name: "Vapor", package: "vapor")
|
||||
]
|
||||
),
|
||||
.testTarget(name: "AppTests", dependencies: [
|
||||
.target(name: "App"),
|
||||
.product(name: "XCTVapor", package: "vapor"),
|
||||
])
|
||||
]
|
||||
)
|
||||
```
|
||||
|
||||
각 부분에 대한 Package Manifest의 설명은 다음 섹션에서 설명됩니다.
|
||||
|
||||
### Tools Version
|
||||
|
||||
패키지 매니페스트의 맨 첫 줄은 필요한 Swift tool 버전을 나타냅니다. 이는 패키지가 지원하는 Swift의 최소 버전을 지정합니다. 패키지 설명 API도 Swift 버전에 따라 변경될 수 있으므로, 이 줄은 Swift가 매니페스트를 올바르게 구문 분석할 수 있도록 합니다.
|
||||
|
||||
### Package Name
|
||||
|
||||
`Package`의 첫 번째 인자는 패키지의 이름입니다. 패키지가 공개된 경우, 이름으로 Git 저장소 URL의 마지막 세그먼트를 사용해야 합니다.
|
||||
|
||||
### Platforms
|
||||
|
||||
`platforms` 배열은 이 패키지가 지원하는 플랫폼을 지정합니다. .macOS(.v12)를 지정함으로써 이 패키지는 macOS 12 이상을 필요로 합니다. Xcode가 이 프로젝트를 로드할 때, 사용 가능한 모든 API를 사용할 수 있도록 macOS 12의 최소 배포 버전을 자동으로 설정합니다.
|
||||
|
||||
### Dependencies
|
||||
|
||||
종속성은 패키지가 의존하는 다른 SPM 패키지입니다. 모든 Vapor 애플리케이션은 Vapor 패키지에 의존하지만, 원하는 만큼 많은 종속성을 추가할 수 있습니다.
|
||||
|
||||
위의 예제에서는 [vapor/vapor](https://github.com/vapor/vapor) 버전 4.76.0 이상이 이 패키지의 종속성으로 지정되어 있습니다. 패키지에 종속성을 추가할 때, 새로 추가된 모듈에 의존하는 [타겟](#targets)을 알려줘야 합니다.
|
||||
|
||||
### Targets
|
||||
|
||||
타겟은 패키지에 포함된 모듈, 실행 파일 및 테스트입니다. 대부분의 Vapor 앱은 두 개의 타겟을 가지지만, 코드를 구성하기 위해 필요에 따라 원하는 만큼 추가할 수 있습니다. 각 타겟은 어떤 모듈에 의존하는지를 선언해야 합니다. 코드에서 모듈을 가져오려면 여기에 모듈 이름을 추가해야 합니다. 타겟은 프로젝트 내의 다른 타겟이나 추가한 패키지에서 노출된 모듈에 의존할 수 있습니다.
|
||||
|
||||
타겟은 패키지에 포함된 모든 모듈, 실행 파일 및 테스트입니다. 대부분의 Vapor 앱은 두 개의 타겟을 가지지만, 코드를 구성하기 위해 필요에 따라 원하는 만큼 추가할 수 있습니다. 각 타겟은 어떤 모듈에 의존하는지를 선언해야 합니다. 모듈을 코드에서 가져오려면 여기에 모듈 이름을 추가해야 합니다. 타겟은 프로젝트 내의 다른 타겟이나 [main dependencies](#dependencies)배열에 추가한 패키지의 모듈에 의존할 수 있습니다.
|
||||
|
||||
## Folder Structure
|
||||
|
||||
아래는 SPM 패키지의 전형적인 폴더 구조입니다.
|
||||
|
||||
```
|
||||
.
|
||||
├── Sources
|
||||
│ └── App
|
||||
│ └── (Source code)
|
||||
├── Tests
|
||||
│ └── AppTests
|
||||
└── Package.swift
|
||||
```
|
||||
|
||||
각 `.target` 또는 `.executableTarget`은 `Sources` 폴더의 하위 폴더와 대응합니다.
|
||||
각 `.testTarget`은 `Tests` 폴더의 하위 폴더와 대응합니다.
|
||||
|
||||
## Package.resolved
|
||||
|
||||
프로젝트를 처음 빌드할 때 SPM은 각 종속성의 버전을 저장하는 `Package.resolved` 파일을 생성합니다. 프로젝트를 다음으로 빌드할 때에도 새로운 버전이 있더라도 동일한 버전이 사용됩니다.
|
||||
|
||||
종속성을 업데이트하려면 `swift package update` 명령을 실행하세요.
|
||||
|
||||
## Xcode
|
||||
|
||||
Xcode 11 이상을 사용하는 경우 `Package.swift` 파일이 수정될 때마다 종속성, 타겟, products 등의 변경이 자동으로 반영됩니다.
|
||||
|
||||
최신 종속성으로 업데이트하려면 File → Swift Packages → Update To Latest Swift Package Versions을 사용하세요.
|
||||
|
||||
또한 `.swiftpm` 파일을 `.gitignore`에 추가하는 것이 좋습니다. 이곳에는 Xcode가 Xcode 프로젝트 구성을 저장합니다.
|
||||
|
|
@ -0,0 +1,44 @@
|
|||
# Xcode
|
||||
|
||||
이 페이지에서는 Xcode를 사용하는 데 도움이 되는 팁에 대해 알려드립니다. 다른 개발 환경을 사용하는 경우 이 부분을 건너뛰어도 됩니다.
|
||||
|
||||
## Custom Working Directory
|
||||
|
||||
기본적으로 Xcode는 프로젝트를 DerivedData 폴더에서 실행합니다. 이 폴더는 프로젝트의 루트 폴더(즉, Package.swift 파일이 있는 곳)와 다른 폴더입니다. 따라서 Vapor는 .env 또는 _Public_과 같은 파일 및 폴더를 찾을 수 없게 됩니다.
|
||||
|
||||
앱을 실행할 때 다음 경고가 표시된다면 이런 상황이 발생하는 것입니다.
|
||||
|
||||
```fish
|
||||
[ WARNING ] No custom working directory set for this scheme, using /path/to/DerivedData/project-abcdef/Build/
|
||||
```
|
||||
|
||||
이를 해결하기 위해 Xcode scheme에서 custom working directory를 설정하세요.
|
||||
|
||||
먼저, 재생 및 중지 버튼 옆에 있는 scheme selector를 클릭하여 프로젝트의 scheme을 편집하세요.
|
||||
|
||||
|
||||
|
||||
Edit Scheme을 선택합니다.
|
||||
|
||||
|
||||
|
||||
scheme editor에서 Options탭을 선택한 후 Use custom working directory를 클릭한 후 프로젝트 루트폴더 경로를 설정합니다.
|
||||
|
||||
|
||||
|
||||
프로젝트의 루트 폴더의 전체 경로를 얻으려면 해당 위치에서 터미널 창을 열고 `pwd`를 실행하세요.
|
||||
|
||||
```fish
|
||||
# verify we are in vapor project folder
|
||||
vapor --version
|
||||
# get path to this folder
|
||||
pwd
|
||||
```
|
||||
|
||||
다음과 유사한 출력이 나타날 것입니다.
|
||||
|
||||
```
|
||||
framework: 4.x.x
|
||||
toolbox: 18.x.x
|
||||
/path/to/project
|
||||
```
|
||||
|
|
@ -0,0 +1,28 @@
|
|||
Vapor 문서에 오신 걸 환영합니다! Vapor는 Swift를 사용하여 백엔드, 웹 앱 API 및 HTTP 서버를 작성할 수 있는 웹 프레임워크입니다. Vapor은 현대적이고 강력하며 안전한 언어인 Swift로 작성되어 기존의 서버 언어에 비해 여러 가지 이점을 제공합니다.
|
||||
|
||||
## 시작하기
|
||||
|
||||
Vapor를 처음 사용하시는 경우, [설치 → macOS](install/macos.ko.md) 로 이동하여 Swift와 Vapor를 설치하세요.
|
||||
|
||||
Vapor를 설치한 후에는, [시작하기 → Hello, world](getting-started/hello-world.ko.md)를 확인하여 첫 번째 Vapor 앱을 생성해보세요!
|
||||
|
||||
## 추가 정보
|
||||
|
||||
다른 Vapor에 대한 정보를 찾을 수 있는 좋은 자료들이 몇 군데 있습니다. 다음은 몇 가지 예시입니다.
|
||||
|
||||
| 이름 | 설명 | 링크 |
|
||||
|----------------|--------------------------------------------------|-------------------------------------------------------------------|
|
||||
| Vapor 디스코드 | Vapor 개발자들과 소통을 하려면 디스코드를 이용하세요. | [visit →](https://vapor.team) |
|
||||
| API 문서 | 자동 생성된 코드 주석에서 생성된 문서를 참조하세요. | [visit →](https://api.vapor.codes) |
|
||||
| Stack Overflow | `vapor` 태그를 사용하여 질문하고 답변을 받으세요. | [visit →](https://stackoverflow.com/questions/tagged/vapor) |
|
||||
| Swift 포럼 | Swift.org 포럼의 Vapor 섹션에 게시하세요. | [visit →](https://forums.swift.org/c/related-projects/vapor) |
|
||||
| 소스 코드 | Vapor 내부 작동 방식을 배워보세요. | [visit →](https://github.com/vapor/vapor) |
|
||||
| 깃허브 이슈 | GitHub에서 버그를 보고하거나 기능을 요청하세요. | [visit →](https://github.com/vapor/vapor/issues) |
|
||||
|
||||
## 이전 버전 문서
|
||||
|
||||
더 이상 지원되지 않는 Vapor의 이전 버전에 대한 문서는 [https://legacy.docs.vapor.codes/](https://legacy.docs.vapor.codes/)에서 확인할 수 있습니다.
|
||||
|
||||
## 작성자
|
||||
|
||||
Vapor Core 팀 및 Vapor 커뮤니티의 수백 명의 구성원들이 기여하였습니다.
|
||||
|
|
@ -0,0 +1,62 @@
|
|||
# 리눅스에 Vapor 설치하기
|
||||
|
||||
Vapor를 사용하려면 Swift 5.6 이상이 필요합니다. 리눅스에 Swift를 설치하려면, [Swift.org](https://swift.org/download/)에서 제공하는 툴체인을 사용하여 설치할 수 있습니다.
|
||||
|
||||
## 지원되는 배포판 및 버전
|
||||
|
||||
Vapor는 Swift 5.6 이상을 지원하는 Linux 배포판의 동일한 버전을 지원합니다.
|
||||
|
||||
!!! 노트
|
||||
아래에 나열된 지원되는 버전은 언제든지 최신 정보가 아닐 수 있습니다. 공식적으로 지원되는 운영 체제는 [Swift Releases](https://swift.org/download/#releases) 페이지에서 확인할 수 있습니다.
|
||||
|
||||
|배포판|버전|Swift 버전|
|
||||
|-|-|-|
|
||||
|Ubuntu|20.04|>= 5.6|
|
||||
|Fedora|>= 30|>= 5.6|
|
||||
|CentOS|8|>= 5.6|
|
||||
|Amazon Linux|2|>= 5.6|
|
||||
|
||||
공식적으로 지원되지 않는 Linux 배포판은 소스 코드를 컴파일하여 Swift를 실행할 수 있지만, Vapor는 안정성을 보장할 수 없습니다. Swift의 컴파일 방법에 대해서는 [Swift 저장소](https://github.com/apple/swift#getting-started)에서 자세히 알아보세요.
|
||||
|
||||
## Swift 설치하기
|
||||
|
||||
Swift를 Linux에 설치하는 방법은 Swift.org의 [다운로드 및 사용하기](https://swift.org/download/#using-downloads) 가이드를 참조하세요.
|
||||
|
||||
### Fedora
|
||||
|
||||
Fedora 사용자는 다음 명령어를 사용하여 Swift를 설치할 수 있습니다.
|
||||
|
||||
```sh
|
||||
sudo dnf install swift-lang
|
||||
```
|
||||
|
||||
Fedora 30을 사용하는 경우, Swift 5.6 이상 버전을 얻기 위해 EPEL 8을 추가해야 합니다.
|
||||
|
||||
## Docker
|
||||
|
||||
Swift의 공식 Docker 이미지를 사용하여 미리 컴파일된 컴파일러를 사용할 수도 있습니다. [Swift's Docker Hub](https://hub.docker.com/_/swift)에서 더 자세한 내용을 알아보세요.
|
||||
|
||||
## Toolbox 설치하기
|
||||
|
||||
이제 Swift가 설치되었으므로 [Vapor Toolbox](https://github.com/vapor/toolbox)를 설치해봅시다. 이 CLI 도구는 Vapor를 사용하는 데 필수적이지는 않지만, 유용한 유틸리티를 제공합니다.
|
||||
|
||||
Linux에서는 Toolbox를 소스 코드로부터 빌드해야 합니다. GitHub에서 toolbox의 <a href="https://github.com/vapor/toolbox/releases" target="_blank">releases</a>를 확인하여 최신 버전을 찾아보세요.
|
||||
|
||||
```sh
|
||||
git clone https://github.com/vapor/toolbox.git
|
||||
cd toolbox
|
||||
git checkout <desired version>
|
||||
make install
|
||||
```
|
||||
|
||||
Toolbox 설치가 성공적으로 이루어졌는지 확인하기 위해 도움말을 출력해보세요.
|
||||
|
||||
```sh
|
||||
vapor --help
|
||||
```
|
||||
|
||||
사용 가능한 명령어 목록이 표시되어야 합니다.
|
||||
|
||||
## 다음 단계
|
||||
|
||||
Swift를 설치한 후 [시작하기 → Hello, world](../getting-started/hello-world.ko.md)에서 첫 번째 앱을 생성하세요.
|
||||
|
|
@ -0,0 +1,48 @@
|
|||
# macOS에 Vapor 설치하기
|
||||
|
||||
macOS에서 Vapor를 사용하려면 Swift 5.6 이상이 필요합니다. Swift와 그에 필요한 종속성은 Xcode와 함께 번들로 제공됩니다.
|
||||
|
||||
## Xcode 설치하기
|
||||
|
||||
Mac App Store에서 [Xcode](https://itunes.apple.com/us/app/xcode/id497799835?mt=12)를 설치하세요.
|
||||
|
||||
|
||||
|
||||
Xcode가 다운로드되면 설치를 완료하기 위해 Xcode를 열어야 합니다. 이 작업은 시간이 걸릴 수 있습니다.
|
||||
|
||||
터미널을 열고 Swift 버전을 출력하여 설치가 성공적으로 이루어졌는지 다시 한 번 확인하세요.
|
||||
|
||||
```sh
|
||||
swift --version
|
||||
```
|
||||
|
||||
Swift의 버전 정보가 출력되어야 합니다.
|
||||
|
||||
```sh
|
||||
swift-driver version: 1.75.2 Apple Swift version 5.8 (swiftlang-5.8.0.124.2 clang-1403.0.22.11.100)
|
||||
Target: arm64-apple-macosx13.0
|
||||
```
|
||||
|
||||
Vapor 4는 Swift 5.6 이상을 필요로 합니다.
|
||||
|
||||
## Toolbox 설치하기
|
||||
|
||||
Swift 설치가 완료된 후, [Vapor Toolbox](https://github.com/vapor/toolbox)를 설치해 봅니다. 이 CLI 도구는 Vapor를 사용하는 데 필요하지는 않지만, 새 프로젝트를 생성하는 등 유용한 유틸리티를 포함하고 있습니다.
|
||||
|
||||
Toolbox는 Homebrew를 통해 배포됩니다. Homebrew를 아직 설치하지 않았다면, <a href="https://brew.sh" target="_blank">brew.sh</a>에서 설치를 합니다.
|
||||
|
||||
```sh
|
||||
brew install vapor
|
||||
```
|
||||
|
||||
Toolbox 설치가 성공적으로 이루어졌는지 확인하기 위해 도움말을 출력해보세요.
|
||||
|
||||
```sh
|
||||
vapor --help
|
||||
```
|
||||
|
||||
사용 가능한 명령어 목록이 표시되어야 합니다.
|
||||
|
||||
## 다음 단계
|
||||
|
||||
이제 Swift와 Vapor Toolbox를 설치했으므로, [시작하기 → Hello, world](../getting-started/hello-world.ko.md)에서 첫 번째 앱을 생성해보세요.
|
||||
43
mkdocs.yml
43
mkdocs.yml
|
|
@ -105,6 +105,9 @@ plugins:
|
|||
pl:
|
||||
name: Polski
|
||||
site_name: Dokumentacja Vapor
|
||||
ko:
|
||||
name: 한국어
|
||||
site_name: Vapor 문서
|
||||
build: true
|
||||
# Add navigation translations here
|
||||
nav_translations:
|
||||
|
|
@ -407,6 +410,46 @@ plugins:
|
|||
Legacy Docs: Przestażała dokumentacja
|
||||
Upgrading: Aktualizacja
|
||||
Release Notes: Informacja o wersji
|
||||
ko:
|
||||
Welcome: 환영합니다
|
||||
Install: 설치
|
||||
Getting Started: 시작하기
|
||||
Folder Structure: 폴더 구조
|
||||
Basics: 기본 사항
|
||||
Routing: 라우팅
|
||||
Content: 컨텐츠
|
||||
Client: 클라이언트
|
||||
Validation: 유효성 검사
|
||||
Async: 비동기 처리
|
||||
Logging: 로깅
|
||||
Environment: 환경 설정
|
||||
Errors: 에러
|
||||
Overview: 개요
|
||||
Model: 모델
|
||||
Relations: 관계
|
||||
Migrations: 마이그레이션
|
||||
Query: 쿼리
|
||||
Transactions: 트랜잭션
|
||||
Schema: 스키마
|
||||
Advanced: 고급
|
||||
Testing: 테스트
|
||||
Files: 파일
|
||||
Commands: 명령어
|
||||
Queues: 대기열
|
||||
WebSockets: 웹소켓
|
||||
Sessions: 세션
|
||||
Services: 서비스
|
||||
Security: 보안
|
||||
Authentication: 인증
|
||||
Crypto: 암호화
|
||||
Passwords: 비밀번호
|
||||
Deploy: 배포
|
||||
Version (4.0): 버전 (4.0)
|
||||
Legacy Docs: 이전 문서
|
||||
Upgrading: 업그레이드
|
||||
Custom Tags: 사용자 정의 태그
|
||||
Contributing: 기여하기
|
||||
Contributing Guide: 기여 가이드
|
||||
nav:
|
||||
- Welcome: "index.md"
|
||||
- Install:
|
||||
|
|
|
|||
Loading…
Reference in New Issue