mirror of https://github.com/vapor/docs.git
81 lines
2.6 KiB
Markdown
81 lines
2.6 KiB
Markdown
|
||
# 你好，世界
|
||
|
||
本文将指引你逐步创建、编译并运行 Vapor 的项目。
|
||
|
||
如果尚未安装 Swift 和 Vapor Toolbox，请查看安装部分。
|
||
|
||
- [安装 → macOS](../install/macos.md)
|
||
- [安装 → Linux](../install/linux.md)
|
||
|
||
## 创建
|
||
|
||
首先，在电脑上创建 Vapor 项目。打开终端并使用以下 Toolbox 的命令行，这将会在当前目录创建一个包含 Vapor 项目的文件夹。
|
||
|
||
```sh
|
||
vapor new hello -n
|
||
```
|
||
|
||
!!! tip "建议"
|
||
使用 `-n` 为所有的问题自动选择 no 来为你提供一个基本的模板。
|
||
|
||
!!! tip "建议"
|
||
你也可以不使用 Vapor Toolbox，直接从 GitHub 克隆[模板库](https://github.com/vapor/template-bare)来获取最新的模板。
|
||
|
||
!!! tip "建议"
|
||
Vapor 以及自带的模板默认使用 `async`/`await`。如果你的系统不能更新到 macOS 12 或者想继续使用 `EventLoopFuture`。运行命令时可以添加此标志 `--branch macos10-15`。
|
||
|
||
命令完成后，切换到新创建的文件夹
|
||
|
||
```sh
|
||
cd hello
|
||
```
|
||
|
||
## 编译 & 运行
|
||
|
||
### Xcode
|
||
|
||
首先，在Xcode打开项目：
|
||
|
||
```sh
|
||
open Package.swift
|
||
```
|
||
|
||
|
||
Xcode 将自动开始下载 Swift 包管理器依赖，在第一次打开一个项目时，这可能需要一些时间，当依赖下载后，Xcode 将显示可以用的 Scheme。
|
||
|
||
在窗口的顶部，在 Play 和 Stop 按钮的右侧，单击项目名称以选择项目的 Scheme，并选择一个适当的 target ——大概率是 “My Mac”。单击 play 按钮编译并运行项目。
|
||
|
||
你应该会在 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 应用！🎉
|