개요
Freezed를 사용하여 불변 데이터 클래스를 생성하고, Dio를 사용하여 HTTP 요청을 수행하는 Flutter/Dart 패키지로, OpenAPI 사양에서 타입 안전한 모델과 API 클라이언트를 생성합니다. API 구조에 맞는 Dart 코드를 자동으로 생성함으로써 백엔드 통합을 간소화하고, 반복 코드를 줄이며 유지보수성을 향상시킵니다. OpenAPI(Swagger)로 정의된 REST API에 의존하는 프로젝트에 적합하며, API 계약과 클라이언트 구현 간의 일관성을 보장합니다.
사용 사례
- OpenAPI 사양에서 API 클라이언트를 자동으로 생성합니다
- Freezed로 불변 데이터 모델 만들기
- Flutter 앱에서 REST API 통합을 단순화합니다
- API와 클라이언트 코드 간의 동기화 유지
- 공유 API 로직으로 다중 플랫폼 앱 지원
주요 기능
- OpenAPI 문서에서 코드 생성
- Freezed를 사용한 불변 모델
- Dio 기반 HTTP 클라이언트 통합
- 타입 안전한 API 엔드포인트
- 사용자 정의 가능한 코드 생성 템플릿
적합한 대상
- OpenAPI로 정의된 API를 사용하는 Flutter 개발자
- 일관된 API 클라이언트 생성이 필요한 팀
- 불변 데이터 모델이 필요한 프로젝트
- 다중 플랫폼을 대상으로 하는 앱
- 수동 API 코드를 줄이고자 하는 개발자
고려 사항
- OpenAPI 사양 파일이 필요합니다
- 업데이트 중 생성된 코드는 신중하게 관리해야 합니다
- OpenAPI 2.0 및 3.x 형식에 제한됨
- 복잡한 스키마의 경우 수동 구성이 필요할 수 있습니다
- 일관된 재생을 위해 CI/CD 파이프라인에서 최적의 사용