你好,世界¶
本文将指引你逐步创建、编译并运行 Vapor 的项目。
如果尚未安装 Swift 和 Vapor Toolbox,请查看安装部分。
创建¶
首先,在电脑上创建 Vapor 项目。打开终端并使用以下 Toolbox 的命令行,这将会在当前目录创建一个包含 Vapor 项目的文件夹。
vapor new hello -n
建议
使用 -n
为所有的问题自动选择 no 来为你提供一个基本的模板。
建议
你也可以不使用 Vapor Toolbox,直接从 GitHub 克隆模板库来获取最新的模板。
建议
Vapor 以及自带的模板默认使用 async
/await
。如果你的系统不能更新到 macOS 12 或者想继续使用 EventLoopFuture
。运行命令时可以添加此标志 --branch macos10-15
。
命令完成后,切换到新创建的文件夹
cd hello
编译 & 运行¶
Xcode¶
首先,在Xcode打开项目:
open Package.swift
Xcode 将自动开始下载 Swift 包管理器依赖,在第一次打开一个项目时,这可能需要一些时间,当依赖下载后,Xcode 将显示可以用的 Scheme。
在窗口的顶部,在 Play 和 Stop 按钮的右侧,单击项目名称以选择项目的 Scheme,并选择一个适当的 target ——大概率是 “My Mac”。单击 play 按钮编译并运行项目。
你应该会在 Xcode 窗口的底部看到控制台输出以下信息。
[ INFO ] Server starting on http://127.0.0.1:8080
Linux¶
在 Linux 和其他操作系统上(甚至在 macOS 上如果你不想使用 Xcode),你可以在你喜欢的编辑器中编辑项目,比如 Vim 或 VSCode 。关于设置其他 IDE 的最新细节,请参阅 Swift Server Guides。
在终端运行以下命令来编译和运行你的项目。
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 应用!🎉