개요
gql_code_builder는 GraphQL 스키마 정의(SDL) 및 쿼리 문서를 타입 안전한 Dart 클래스로 변환하는 Dart 코드 생성 패키지입니다. 개발자들이 .graphql 파일에서 모델, 쿼리, 변경, 변수를 직접 생성할 수 있게 해주며, 코드 유지보수성을 향상시키고 반복 코드를 줄여줍니다. build_runner의 강력한 기능을 활용하여 Flutter 및 Dart 프로젝트에 원활하게 통합되며, GraphQL 작업에 대해 강타입과 컴파일 시 안정성을 보장합니다. 생성된 코드는 최소한의 수동 작업으로 클라이언트 측 및 서버 측 사용 사례 모두를 지원합니다.
사용 사례
- 타입 안전한 GraphQL 쿼리 생성
- SDL에서 모델 생성 자동화
- GraphQL 클라이언트에서 반복 코드 줄이기
- 쿼리의 컴파일 시 검증 활성화
- build_runner 워크플로우와의 통합
주요 기능
- .graphql 파일에서 Dart 클래스 생성
- SDL 및 쿼리 문서 분석을 지원합니다
- 형 안전한 모델과 작업을 생성합니다
- build_runner와 통합
- 확장 가능한 코드 생성 훅 제공
적합한 대상
- GraphQL를 사용하는 Flutter 앱
- 강한 타입 지정이 필요한 Dart 프로젝트
- 코드 품질과 유지보수성을 우선시하는 팀
- 자동 코드 생성이 필요한 GraphQL 클라이언트
- gql-dart 생태계를 사용하는 프로젝트
고려 사항
- 빌드 러너 설정이 필요합니다
- 정적 스키마 분석에 제한됨
- 빌드 시간이 증가할 수 있습니다
- 런타임 스키마 변경에 적합하지 않습니다
- 소스 파일 내 올바른 GraphQL 구문에 따라 다름