通过文章《后端实践二:Ubuntu18.04安装最新版Swift5.2》可以在 Ubuntu18.04 的服务器上顺利安装最新版本的 Swift
。我们参照 官网文档 安装 Vapor4.0
的开发环境。
官网上的文档跟开发维护的速度有一定的版本误差,所以现在在官网上看到的安装方法是针对
Vapor(>3.0 && < 4.0)
的版本。由于版本间差异比较大,在实践过程中,只会关注到Vapor(>=4.0)
以上版本的新特性。在创建工程和引入依赖库的过程中也会出现微小的差别,我们在后续的实践中会总结到。
验证 Swift 安装
我们通过访问 Swift.org
,可以得到一份如何在 Linux
上安装 Swift
的文档。我们完成对 Swift
的安装之后,在终端中输入如下命令:
如果在终端中输出如下信息:
1 | Apple Swift version 4.1.0 (swiftlang-900.0.69.2 clang-900.0.38) |
那么标识我们在 Linux
上成功安装 Swift
。
安装 Vapor Toolbox
在 Vapor 4.0
发布之前,在 Linux
上安装,只需要在终端中敲入如下命令即可:
1 | curl -sL apt.vapor.sh -o apt.vapor.sh |
这个执行安装的命令已经被废弃。
Toolbox
源代码
由于之后的版本中,不在将该文件托管至软件源,所以我们在安装时需要做出如下操作获取到 Toolbox
源代码到本地文件夹中:
下载 Toolbox
源代码:
1 | git clone https://github.com/vapor/toolbox.git |
编译 Vapor
可执行文件
进入到 Toolbox
工程的根目录:
1 | cd toolbox/ |
编译 Toolbox
发布版本:
1 | swift build -c release |
由于获取的源代码中缺少部分文件,期间或存在报错发现 Toolbox
中没有 LinuxMain.swift
文件在 Tests
文件夹中,这时我们进入到 XCTest
文件夹中。
创建 LinuxMain.swift
文件:
1 | touch LinuxMain.swift |
编辑 LinuxMain.swift
文件:
1 | vim LinuxMain.swift |
向 LinuxMain.swift
文件中添加测试代码:
1 | import XCTest |
保存修改:
1 | :wq! |
重新执行如下命令,完成编译:
1 | swift build -c release |
找到编译成功的 Vapor
文件
执行完
build
命令之后,会在输出的文件中生成一个可执行的二进制文件。
查找 Vapor
所在的目录:
1 | find . -name vapor |
这时会看到输出一个类似如下的文件夹
.build/x86_64-unknown-linux/release/vapor
,这个文件夹里就是我们要使用到的文件Vapor
。
配置 Vapor
的环境变量
将包含可执行文件 Vapor
的文件目录添加在 PATH
中。
配置 Vapor
环境变量:
1 | sudo cp vapor /usr/local/bin/ |
验证是否配置成功:
1 | vapor --help |
总结
至此 Vapor 4.0
的环境配置已经完成。由于 3.0
和 4.0
版本差异比较大,在配置方面也有差异。在创建项目时更需要加上 branch=4
等。后续会加入:创建第一个 Hello World
工程。