개요
OpenAPI 사양에서 클라이언트 SDK를 생성하는 플러터/다트 패키지로, npm의 openapi-generator-cli에 영감을 받았습니다. API 상호작용을 위한 타입 안전한 다트 코드 생성을 자동화하여 수동 작업과 잠재적인 오류를 줄입니다. 생성된 코드는 안드로이드, iOS, 웹, 맥OS, 윈도우, 리눅스 등 여러 플랫폼을 지원하며 환경 간 일관된 API 클라이언트 사용을 가능하게 합니다. OpenAPI/Swagger 정의에 의존하여 애플리케이션 내에서 강력하고 최신 상태의 API 통합을 유지하는 팀에게 이상적입니다.
사용 사례
- OpenAPI 사양에서 API 클라이언트 생성 자동화
- 타입 안전성으로 REST API 통합
- Flutter 앱을 위한 크로스 플랫폼 API 클라이언트
- 백엔드 변경사항과 API 계약을 동기화 유지하기
- API 서비스 계층에서 반복 코드 줄이기
주요 기능
- OpenAPI 3.x 사양에서 Dart 코드 생성
- 다중 플랫폼 출력을 지원합니다
- 형 안전한 API 모델과 서비스를 생성합니다
- Flutter pub add를 통해 통합
- CLI 유사 워크플로우를 사용
적합한 대상
- OpenAPI로 정의된 API를 사용하는 Flutter 개발자
- 자동화된 API 클라이언트 업데이트가 필요한 팀
- 다양한 플랫폼에서 일관된 API 통합이 필요한 프로젝트
- 수동 API 서비스 코드 작성량을 줄이고자 하는 개발자
고려 사항
- 유효한 OpenAPI 사양 파일이 필요합니다
- 생성된 코드는 복잡한 엔드포인트에 맞게 사용자 지정이 필요할 수 있습니다
- 일관성을 위해 CI/CD 파이프라인에서 최적의 사용
- 런타임 라이브러리가 아님 — 소스 코드만 생성