<commit_before># 快速上手

您期望用Perfect和Swift进行编程吗？本文将向您介绍所有需要运行Perfect的基本内容，并帮助您创建第一个应用程序。

阅读本文后，您会了解到：

- 如何创建和运行一个HTTP/HTTPS服务器，将Perfect运转起来
- 安装运行Perfect之前，无论是OS X还是Ubuntu Linux系统都需要安装的必要软件
- 如何为Swift项目编译、测试和管理依存关系
- 如何将Perfect部署到其它环境中，比如Heroku、Amazon Web Services、Docker、Microsoft Azure、Google Cloud、IBM Bluemix CloudFoundry，以及IBM Bluemix Docker

### Swift 3.0

在您从[Swift.org（英文版）](https://swift.org/getting-started/)完成Swift 3.0 toolchain工具集安装之后，请打开一个命令行终端并输入命令
```
swift --version
```

如果能够看到类似于下面的消息就对了：

```
Apple Swift version 3.0 (swiftlang-800.0.33.1 clang-800.0.31)
Target: x86_64-apple-macosx10.9
```
请注意您需要最新版本的Swift 3.0。如果低于3.0版本则Perfect是无法成功编译的。

### Ubuntu Linux
Perfect软件框架可以在Ubuntu Linux 14.04 and 15.10环境下运行。Perfect依赖于若干软件接口库，比如OpenSSL、libssl-dev和uuid-dev。如果需要安装这些内容，请在终端控制台内输入：

```
sudo apt-get install openssl libssl-dev uuid-dev
```

### Perfect项目快速上手

现在一切准备就绪，您可以开始开发您的第一个Web应用入门项目。

### 编译入门项目

执行以下命令能够克隆并编译一个空的入门项目。编译后可以启动一个本地的服务器，监听您计算机的8181端口：

```
git clone https://github.com/PerfectlySoft/PerfectTemplate.git
cd PerfectTemplate
swift build
.build/debug/PerfectTemplate
```

您应该可以在终端控制台中看到类似下面的内容：

```
Starting HTTP server on 0.0.0.0:8181 with document root ./webroot
```

服务器现在已经运行并等待连接。从浏览器打开[http://localhost:8181/](http://127.0.0.1:8181/) 可以看到欢迎信息。在终端控制台中输入组合键“control-c”可以随时终止服务器运行。

完整的源代码请参考[PerfectTemplate项目模板](https://github.com/PerfectlySoft/PerfectTemplate)。

### Xcode

Swift软件包管理器（SPM）能够创建一个Xcode项目，并且能够运行PerfectTemplate模板服务器，还能为您的项目提供完全的源代码编辑和调试。在您的终端命令行内输入：<commit_msg>Update gettingStarted.md<commit_after># 快速上手

您期望用Perfect和Swift进行编程吗？本文将向您介绍所有需要运行Perfect的基本内容，并帮助您创建第一个应用程序。

阅读本文后，您会了解到：

- 如何创建和运行一个HTTP/HTTPS服务器，将Perfect运转起来
- 安装运行Perfect之前，无论是OS X还是Ubuntu Linux系统都需要安装的必要软件
- 如何为Swift项目编译、测试和管理依存关系
- 如何将Perfect部署到其它环境中，比如Heroku、Amazon Web Services、Docker、Microsoft Azure、Google Cloud、IBM Bluemix CloudFoundry，以及IBM Bluemix Docker

### Swift 3.0

在您从[Swift.org（英文版）](https://swift.org/getting-started/)完成Swift 3.0 toolchain工具集安装之后，请打开一个命令行终端并输入命令
```
swift --version
```

如果能够看到类似于下面的消息就对了：

```
Apple Swift version 3.0 (swiftlang-800.0.33.1 clang-800.0.31)
Target: x86_64-apple-macosx10.9
```
请注意您需要最新版本的Swift 3.0。如果低于3.0版本则Perfect是无法成功编译的。

### Ubuntu Linux
Perfect软件框架可以在Ubuntu Linux 14.04 and 15.10环境下运行。Perfect依赖于若干软件接口库，比如OpenSSL、libssl-dev和uuid-dev。如果需要安装这些内容，请在终端控制台内输入：

```
sudo apt-get install openssl libssl-dev uuid-dev
mac os x命令更换为：brew install openssl
```

### Perfect项目快速上手

现在一切准备就绪，您可以开始开发您的第一个Web应用入门项目。

### 编译入门项目

执行以下命令能够克隆并编译一个空的入门项目。编译后可以启动一个本地的服务器，监听您计算机的8181端口：

```
git clone https://github.com/PerfectlySoft/PerfectTemplate.git
cd PerfectTemplate
swift build
.build/debug/PerfectTemplate
```

您应该可以在终端控制台中看到类似下面的内容：

```
Starting HTTP server on 0.0.0.0:8181 with document root ./webroot
```

服务器现在已经运行并等待连接。从浏览器打开[http://localhost:8181/](http://127.0.0.1:8181/) 可以看到欢迎信息。在终端控制台中输入组合键“control-c”可以随时终止服务器运行。

完整的源代码请参考[PerfectTemplate项目模板](https://github.com/PerfectlySoft/PerfectTemplate)。

### Xcode

Swift软件包管理器（SPM）能够创建一个Xcode项目，并且能够运行PerfectTemplate模板服务器，还能为您的项目提供完全的源代码编辑和调试。在您的终端命令行内输入：
{'fraction_non_alphanumeric': 0.11898569570871262, 'fraction_numerical': 0.04161248374512354, 'mean_word_length': 7.407103825136612, 'pattern_counts': {'":': 0, '<': 3, '<?xml version=': 0, '>': 3, 'https://': 6, 'lorem ipsum': 0, 'www.': 0, 'xml': 0}, 'pii_count': 6, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 0, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '5298395', 'n_tokens_mistral': 1908, 'n_tokens_neox': 2040, 'n_words': 157}