학습 노트 · Flutter
Flutter의 패키지 배포 환경
Flutter는 다른 개발자가 Flutter 및 Dart 생태계에 기여한 공유 패키지를 사용하도록 지원한다. 이를 통해 모든 것을 처음부터 개발하지 않고도 앱을 빠르게 빌드할 수 있다.
패키지 사용
패키지는 pub.dev에 게시된다. pub.dev의 Flutter 랜딩 페이지는 Flutter와 호환되는 상위 패키지(일반적으로 Flutter와 호환되는 종속성을 선언한 패키지)를 표시하고 게시된 모든 패키지를 검색하는 기능을 지원한다.
pub.dev의 Flutter Favorites 페이지에는 앱을 작성할 때 크게 도움이 되는 패키지들이 나열되어있어 이를 활용하면 보다 빠르게 애플리케이션을 개발할 수 있다.
또한 Android, iOS, web, Linux, Windows, macOS를 필터링하여 현재 환경에서 활용할 수 있는 패키지 목록도 찾아볼 수 있다.
앱에 패키지 종속성 추가하기
예시로 css_colors를 추가해보자
-
dependencies추가- 프로젝트 폴더에 있는
pubspec.yaml파일을 열고dependencies항목에css_colors를 추가한다.
- 프로젝트 폴더에 있는
-
Install
- 터미널:
flutter pub get을 실행한다 - VS Code: 다운로드 아이콘으로 표시된 상단 작업 목록의 패키지 가져오기를 클릭한다.
- Android Studio/IntelliJ:
pubspec.yaml상단의 작업 목록에서 Pub get을 클릭한다.
- 터미널:
-
Import
- Dart code에
import를 사용하여 패키지를 추가한다.
- Dart code에
-
앱 재실행하기
hot reload/restart의 경우 Dart 코드만 업데이트 하므로 패키지가 플랫폼별 코드 (Android의 경우 Kotlin/Java, iOS의 경우 Swift/Objective-C)를 가져오는 경우 앱을 재실행하여 빌드해야한다.
터미널 명령어를 통한 추가
flutter pub add "some-package"를 통해서도 패키지 종속성을 추가할 수 있다. 마찬가지로 css_colors를 예시로 확인해보자.
-
프로젝트 디렉토리 내부 터미널에서 명령어 실행
flutter pub add css_colors
-
Import
- Dart code에
import를 사용하여 패키지를 추가한다.
- Dart code에
-
앱 재실행하기
hot reload/restart의 경우 Dart 코드만 업데이트 하므로 패키지가 플랫폼별 코드 (Android의 경우 Kotlin/Java, iOS의 경우 Swift/Objective-C)를 가져오는 경우 앱을 재실행하여 빌드해야한다.
패키지 종속성 제거
flutter pub remove를 통해 패키지를 제거할 수 있다.
- 프로젝트 디렉토리 내부 터미널에서 명령어 실행
flutter pub add css_colors
문제 해결
앱에서 some_package와 another_package를 사용하려 한다. 두 패키지는 모두 url_launcher를 종속성으로 가지고 있는데 url_launcher의 버전이 다르다고 가정해보자. 그러면 두 패키지를 가져올 때 충돌이 발생하게 될 것이다.
이를 피하는 가장 좋은 방법은 패키지 작성자가 종속성을 지정할 때 특정 버전 대신 범위 버전을 설정하는 것 이다.
종속성을 범위 버전으로 설정해주면 pub은 자동으로 문제를 해결해준다.
만약 해당 패키지를 직접 수정할 수 없는 경우에는 어떻게 할까? pubspec.yaml파일에서 dependency_overrides를 설정하여 종속성을 재정의 할 수 있다.
dependencies:
some_package:
another_package:
dependency_overrides:
url_launcher: "5.4.0"충돌하는 종속성이 패키지 자체가 아니라 Android나 iOS 전용 라이브러리일 경우에는 어떻게 할까? Android의 경우 종속성 재정의 선언을 Gradle 빌드 로직에 추가하여 강제할 수 있다. guava 패키지를 예시로 보자.
configuration.all {
resolutionStrategy {
force 'com.google.guava:guava:28.0-android'
}
}
CocoaPods의 경우 현재(2024-11-19) 종속성 재정의 기능을 제공하지 않고 있다.