이전 목록으로
#Dart#Architecture

Dart·Flutter 의존성 관리: dependency_overrides, Path, Workspace

Flutter 프로젝트에서 직접·전이 의존성, `pubspec.lock`, Path Dependency, `dependency_overrides`와 Pub Workspace의 차이를 설명하고 재현 가능한 빌드 원칙을 정리한다.

의존성 문제는 pub get 실패만 의미하지 않는다. 로컬과 CI에서 서로 다른 버전이 설치되거나, Patch 빌드에 네이티브 변경이 섞이는 것도 의존성 관리 문제다.

flowchart TD
    A[App pubspec.yaml] --> B[직접 의존성]
    B --> C[전이 의존성]
    A --> D[pubspec.lock]
    D --> E[재현 가능한 실제 버전]

일반 의존성

dependencies:
  dio: ^5.0.0

버전 제약 범위 안에서 Pub가 호환 조합을 선택하고 실제 결과를 pubspec.lock에 기록한다. 앱 프로젝트는 lock 파일을 커밋하는 것이 일반적이다.

flutter pub get --enforce-lockfile
flutter pub deps --style=compact
flutter pub outdated

Path Dependency

dependencies:
  company_design_system:
    path: packages/company_design_system

로컬 패키지의 Dart 코드 수정은 즉시 반영된다. 그러나 해당 패키지의 pubspec.yaml 의존성이 바뀌면 다시 pub get이 필요하다.

dependency_overrides

dependency_overrides:
  some_package: 2.1.0

전이 의존성까지 지정 버전으로 강제한다. 충돌을 임시로 진단하거나 수정된 로컬 Fork를 검증할 때 유용하지만, 호환성을 자동으로 만들어 주지는 않는다.

dependency_overrides:
  some_package:
    path: ../patched_some_package

사용 시 다음을 기록한다.

  • 왜 Override가 필요한가?
  • 어떤 이슈나 PR이 해결되면 제거할 수 있는가?
  • 강제한 버전으로 어떤 테스트를 통과했는가?

Pub Workspace

# root/pubspec.yaml
name: workspace_root
publish_to: none

environment:
  sdk: ^3.6.0

workspace:
  - apps/driver_app
  - apps/admin_app
  - packages/design_system
  - packages/domain
# packages/design_system/pubspec.yaml
name: design_system
resolution: workspace

Workspace는 여러 패키지가 하나의 의존성 해석과 lock 파일을 공유하게 한다. 공통 패키지를 운영하는 모노레포에 적합하지만 모든 앱이 같은 버전 제약을 만족해야 한다.

선택 기준

상황 권장 방식
외부 패키지 사용 일반 version dependency
같은 저장소의 공통 패키지 Workspace + path 구조
패키지 수정 검증 임시 path override
버전 충돌 응급 대응 근거가 있는 override
앱 빌드 재현 lock 파일 커밋

관련 문서

목록으로 돌아가기

다른 게시글

#Android#Flutter

현장 Flutter 앱 디버깅에 자주 쓴 ADB 명령어

기기 지정, Logcat, APK 설치, 파일 복사, 포트 reverse를 실기기 점검 흐름으로 정리한다.

#Android#Kotlin

Android 입력 장치 목록 조회하기: 키보드·마우스·HID 스캐너 구분

Android `InputManager`와 `InputDevice` API로 연결된 입력 장치를 조회하고, 키보드·포인터·외부 장치 여부를 판별하는 방법을 정리한다. USB·Bluetooth HID 바코드 스캐너를 일반 키보드와 구분할 때의 한계와 연결 변경 감지 방법도 함께 살펴본다.

#Android#Kotlin

Android 위치 권한과 FusedLocationProvider 실전 정리: 현재 위치·지속 추적·GPS 설정

Jetpack Compose 앱에서 Android 위치 권한을 요청하고, Fused Location Provider로 캐시 위치·일회성 현재 위치·지속 위치 업데이트를 처리하는 흐름을 정리한다. Android 12의 대략적·정확한 위치 선택, 백그라운드 위치 정책, GPS 설정 확인과 생명주기 연동까지 예제 코드로 살펴본다.