擼了一個可調試 gRPC 的 GUI客戶端
本文轉載自微信公眾號「crossoverJie」，作者crossoverJie 。轉載本文請聯系crossoverJie公眾號。
前言
平時大家寫完 gRPC 接口后是如何測試的?往往有以下幾個方法：
寫單測代碼，自己模擬客戶端測試。
可以搭一個 gRPC-Gateway 服務，這樣就可以在 postman 中進行模擬。
但這兩種方法都不是特別優雅;第一種方法當請求結構體嵌套特別復雜時，在代碼中維護起來就不是很直觀;而且代碼會特別長。
第二種方法在 postman 中與請求 HTTP 接口一樣，看起來非常直觀;但需要額為維護一個 gRPC-Gateway 服務，同時接口定義發生變化時也得重新發布，使用起來稍顯復雜。
于是我經過一番搜索找到了兩個看起來還不錯的工具：
- BloomRPC
- https://github.com/fullstorydev/grpcui
首先看 BloomRPC 頁面美觀，功能也很完善;但卻有個非常難受的地方，那就是不支持 int64 數據的請求, 會有精度問題。
這里我寫了一個簡單的接口，直接將請求的 int64 返回回來。
- func (o *Order) Create(ctx context.Context, in *v1.OrderApiCreate) (*v1.Order, error) {
- fmt.Println(in.OrderId)
- return &v1.Order{
- OrderId: in.OrderId,
- Reason: nil,
- }, nil
- }
會發現服務端收到的數據精度已經丟失了。
這個在我們大量使用 int64 的業務中非常難受，大部分接口都沒法用了。
grpcui 是我在使用了 BloomRPC 一段時間之后才發現的工具，功能也比較完善; BloomRPC 中的精度問題也不存在。
但由于我之前已經習慣了在 BloomRPC 中去調試接口，加上日常開發過程中我的瀏覽器幾乎都是開了幾十個 tap 頁面，導致在其中找到 grpcui 不是那么方便。
所以我就想著能不能有一個類似于 BloomRPC 的獨立 APP，也支持 int64 的工具。
準備
找了一圈，貌似沒有發現。恰好前段時間寫了一個 gRPC 的壓測工具，其實已經把該 APP 需要的核心功能也就是泛化調用實現了。
由于核心能力是用 Go 實現的，所以這個 APP 最好也是用 Go 來寫，這樣復用代碼會更方便一些;正好也想看看用 Go 來實現 GUI 應用效果如何。
但可惜 Go 并沒有提供原生的 GUI 庫支持，最后翻來找去發現了一個庫：fyne
從 star 上看用的比較多，同時也支持跨平臺打包;所以最終就決定使用該庫在構建這個應用。
核心功能
整個 App 的交互流程我參考了 BloomRPC ，但作為一個不懂審美、設計的后端開發來說，整個過程中最難的就是布局了。
這是我花了好幾個晚上調試出來的第一版頁面，雖然也能用但查看請求和響應數據非常不方便。
于是又花了一個周末最終版如下(乍一看貌似沒區別)：
雖然頁面上與 BloomRPC 還有一定差距，但也不影響使用;關鍵是 int64 的問題解決了;又可以愉快的擼碼了。
安裝
有類似需求也想體驗的朋友可以在這里下載使用：https://github.com/crossoverJie/ptg/releases/download/0.0.2/ptg-mac-gui.tar
由于我手上暫時沒有 Windows 電腦，所以就沒有打包 exe 程序;有相關需求的朋友可以自行下載源碼編譯：
- git clone git@github.com:crossoverJie/ptg.git
- cd ptg
- make pkg-win
后續計劃
當前版本的功能還比較簡陋，只支持常用的 unary 調用;后續也會逐步加上 stream、metadata、工作空間的存儲與還原等支持。
對頁面、交互有建議也歡迎提出。
原本是準備上傳到 brew 方便安裝的，結果折騰了一晚上因為數據不夠被拒了，所以對大家有幫助或者感興趣的話幫忙點點關注(咋有種直播帶貨的感覺??)
源碼地址：https://github.com/crossoverJie/ptg
