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

1. 前言

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

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

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

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

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

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

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

2.1 第一步：獲取 Swagger Codegen Jar 包

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

https://github.com/SteafanMrZhou/MoocSwaggerWiki

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

我們?cè)谀玫?Swagger Codegen 的 jar 包后，可以使用 Java 提供的命令來解析該 jar 包：

java -jar swagger-codegen-cli.jar help

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

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

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

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

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

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

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

brew

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

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

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

brew install swagger-codegen

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

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

可以看到，當(dāng)我們輸入 help 命令時(shí)并不會(huì)提示我們像 Windows 環(huán)境中的信息，這是因?yàn)樵?Mac 環(huán)境中 Swagger-Codegen 所使用的命令格式和 Windows 中的不一樣導(dǎo)致，這里就不再詳細(xì)介紹了。

4. Swagger Codegen 安裝是否成功的必要性測(cè)試及注意事項(xiàng)

4.1 Windows 環(huán)境

當(dāng)我們運(yù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é)束之后，給我們?cè)诮K端打印出了 Swagger-Codegen 的幫助提示信息，那就說明我們?cè)?Mac 中使用 Homebrew 安裝 Swagger-Codegen 是成功的。

Tips :

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

5. 小結(jié)

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