一鍵化生成sdk文檔的妙法

上一篇文章提到了API和SDK的區別，感受你們都還挺感興趣的，雖然沒啥人評論，看的人也很少（心頭痛中），因爲工做的緣由，常常要接觸到接口，通常接口文檔編寫完畢，接下來開始寫調用接口的代碼，個人公司（據我所知不少企業也這樣）採用sdk文檔的形式來調用接口。使用的過程當中----上次說到的eolinker提供一鍵化生成sdk文檔，在接口編輯完後，可一鍵生成sdk文檔，不用重複造輪子。不過使用過程仍是有點小技巧的，今天來分享生成SDK文檔。而具體的教程本身去官網看看哈。

首先要開啓「生成sdk」插件，進入項目，點擊「sdk生成」選項

而後點擊建立方案，填入方案名稱、設置環境信息（此處填入請求前置URI、請求頭及全局變量信息），若項目已有環境，可直接選中相關環境。我的以爲這步很關鍵，填寫設置後也方便後續查看和修改。再自定義環境和選中相關環境。填入分組類名，此處填入的分組類名將做爲sdk的類名，故要求類名爲英文，填完後保存。（爲求簡潔，我通常的作法是拼音拼寫，你們能夠本身選本身喜歡的命名方式），因爲eoLinker上支持二級分組，故可選擇子分組類名是否繼承父分組類名，打勾後子類名將話加上父分組類名。

最後點擊生成sdk，選擇語言，sdk文檔便被一鍵化生成了，Sdk壓縮包內容和自動生成的sdk文檔內容，再調用直接在index.php調用便可。

小結：一鍵化自動生成sdk文檔主要是不用再從新寫調用代碼，由於eoLinker生成的文檔內容也還算詳細，對於某些懶癌患者（我向天發4不是我）嫌麻煩，寫多一行註釋都以爲麻煩，嘖嘖噠。