套件概覽
gql_code_builder 是一個 Dart 程式碼產生套件，可將 GraphQL 模式定義（SDL）和查詢文件轉換為類型安全的 Dart 類別。它讓開發者能夠直接從 .graphql 檔案產生模型、查詢、變更和變數，提升程式碼可維護性並減少重複程式碼。透過利用 build_runner 的功能，它能順暢整合至 Flutter 和 Dart 專案中，確保 GraphQL 操作具備強型別與編譯時期安全性。產生的程式碼支援客戶端與伺服器端使用情境，且手動操作需求極少。
適用情境
- 產生類型安全的 GraphQL 查詢
- 從SDL自動建立模型
- 減少 GraphQL 客戶端中的樣板程式碼
- 啟用查詢的編譯時驗證
- 與 build_runner 工作流程整合
主要特色
- 從 .graphql 檔案產生 Dart 類別
- 支援 SDL 與查詢文件解析
- 產生類型安全的模型和操作
- 與 build_runner 集成
- 提供可擴展的程式碼產生鈎子
適合對象
- 使用 GraphQL 的 Flutter 應用
- 需要強類型的Dart專案
- 注重程式碼品質和可維護性的團隊
- 需要自動化代碼生成的 GraphQL 客戶端
- 使用 gql-dart 生態系統的專案
使用建議
- 需要建構執行器設定
- 僅限靜態架構分析
- 可能會增加建構時間
- 不適用於執行時間架構變更
- 依賴來源檔案中的正確 GraphQL 語法