Swagger Codengen 主流環(huán)境安裝

1. 前言

本節(jié)會為大家介紹如何在當下主流操作系統(tǒng)中安裝 Swagger Codegen 代碼生成器。

重點講解內(nèi)容：

• 如何在 Windows 系統(tǒng)中安裝 Swagger Codegen ；

• 如何在 OS X 系統(tǒng) (Mac) 中安裝 Swagger Codegen ；

• Swagger Codegen 安裝是否成功的必要性測試。

2. 如何在 Windows 系統(tǒng)中安裝 Swagger Codegen ?

針對 Windows 環(huán)境，Swagger Codegen 官方并沒有直接提供很好的安裝方法，所以這里我們采用另一種方式，這也是我總結(jié)出來的方法，屢試不爽。

2.1 第一步：獲取 Swagger Codegen Jar 包

我們進入 Swagger Codegen 的開源界面，會得到官網(wǎng)所推薦的下載 jar 包的鏈接，鏈接比較長，這里我已經(jīng)下好了，同學們可以直接從我的 Git 上進行下載：

https://github.com/SteafanMrZhou/MoocSwaggerWiki

2.2 第二步：在 Windows 環(huán)境 安裝 Swagger Codegen

我們在拿到 Swagger Codegen 的 jar 包后，可以使用 Java 提供的命令來解析該 jar 包：

java -jar swagger-codegen-cli.jar help

運行以上命令之后，我們會得到很多關(guān)于 Swagger Codegen 的幫助信息，如下圖所示：

由于我使用的是 Mac 系統(tǒng)，所以我在我的 Mac 上安裝了 Win 的虛擬機來為大家演示。

3. 如何在 OS X 系統(tǒng) (Mac) 中安裝 Swagger Codegen

在 OS X 系統(tǒng)中安裝 Swagger Codegen 和在 Windows 中安裝 Swagger Codegen 大同小異，只是說我們所依賴的平臺和安裝的方式不同而已，接下來讓我們來看看如何在 OS X 系統(tǒng)中安裝 Swagger Codegen 吧。

3.1 第一步 確認 Mac 中是否已經(jīng)安裝 Homebrew

眾所周知，如果你是使用 Mac 來工作的，那么你一定聽說過 Hoembrew 了，Hoembrew 就類似于我們使用的 Maven ，但是不同于 Maven 的是，他即可以管理項目中的依賴包，也可以管理我們電腦中的依賴包，例如：Java 。

如何確認電腦中是否已經(jīng)安裝了 Homebrew 呢 ？ 我們可以在 Mac 的終端中使用以下命令確認：

brew

直接在終端中輸入上述命令，然后按回車，如果會提示以下信息，說明 Homebrew 已經(jīng)安裝：

3.2 第二步 使用 Homebrew 安裝 Swagger-Codegen

當我們的 Mac 中已經(jīng)安裝了 Hoembrew ，那么我們可以通過以下命令來安裝 Swagger-Codegen ：

brew install swagger-codegen

如上圖所示，如果你的 Homebrew 已經(jīng)很長時間沒使用了，那么他會自動更新 Homebrew 中已安裝的依賴包，這需要等待一段時間。

在更新完 Homebrew 之后，我們可以等待 Swagger-Codegen 的安裝完成，如下圖所示：

可以看到，當我們輸入 help 命令時并不會提示我們像 Windows 環(huán)境中的信息，這是因為在 Mac 環(huán)境中 Swagger-Codegen 所使用的命令格式和 Windows 中的不一樣導致，這里就不再詳細介紹了。

4. Swagger Codegen 安裝是否成功的必要性測試及注意事項

4.1 Windows 環(huán)境

當我們運行 jar 包之后出現(xiàn)上述截圖中所顯示的幫助信息，說明我們下載的 jar 包是正確的，并且也說明 Swagger-Codegen 在我們的電腦中已經(jīng)安裝成功了，接下來就可以使用 Swagger-Codegen 為我們提供的命令來使用 Swagger Codegen 了。

4.2 OS X (Mac) 環(huán)境

和 Windows 環(huán)境一樣，如果在 Homebrew 中安裝 Swagger-Codegen 結(jié)束之后，給我們在終端打印出了 Swagger-Codegen 的幫助提示信息，那就說明我們在 Mac 中使用 Homebrew 安裝 Swagger-Codegen 是成功的。

Tips :

1. 我們在安裝 Swagger-Codegen 的時候，無論是 Windows 平臺還是 OS X 平臺，首先都需要將 Swagger-Codegen 的 jar 包下載下來，然后我們再針對平臺分而治之，但是請記住，無論在哪個平臺安裝 Swagger-Codegen ，都要確保電腦上是 Java 7 以及更高的版本才行。
2. 一般在使用 Swagger-Codegen 的時候，絕大多數(shù)情況使用的都是 Swagger-Codegen 的最新穩(wěn)定版本，所以各位在安裝 Swagger-Codegen 時，務必要和本小節(jié)中使用的版本 (2.4.14) 保持一致，以免發(fā)生不必要的問題。

5. 小結(jié)

本小節(jié)針對當下主流操作系統(tǒng)，分別詳細介紹了在 Windows 平臺和 OS X (Mac) 平臺安裝 Swagger-Codegen 的步驟，以及在安裝時候容易出現(xiàn)的問題，針對 Swagger-Codegen 的 Jar 包，考慮到自行下載可能下不動的情況，所以又額外提供了相關(guān)資源連接，同學們可以直接下載。