Dart 입문 도구

Dart 패키지 관리

Dart 패키지 관리 — 초급

패키지 관리

1. 도입 (왜 배워야 하는가)

패키지 관리는 Dart 및 Flutter 개발에서 매우 중요한 개념입니다. 실무에서는 다양한 기능을 구현하기 위해 외부 라이브러리와 패키지를 자주 사용하게 되는데, 이를 올바르게 관리하지 않으면 코드가 복잡해지고, 의존성 충돌이 발생하거나, 프로젝트가 유지보수하기 어려워질 수 있습니다. 패키지를 잘 관리하는 것은 코드의 품질과 생산성을 높이는 데 필수적입니다.

패키지 관리를 소홀히 하면 다음과 같은 문제가 발생할 수 있습니다:

의존성 충돌로 인해 앱이 정상적으로 작동하지 않음
업데이트 시 기존 기능이 깨지거나, 새로운 버전의 패키지가 호환되지 않음
코드의 가독성이 떨어지고, 협업이 어려워짐

2. 핵심 개념 설명

패키지: 재사용 가능한 코드 묶음으로, 특정 기능을 수행하는 라이브러리입니다. 예를 들어, 날짜 및 시간을 다루는 기능을 제공하는 intl 패키지와 같은 것이 있습니다.
pub.dev: Dart와 Flutter의 공식 패키지 저장소로, 다양한 패키지를 검색하고 다운로드할 수 있는 곳입니다.
pubspec.yaml: Dart 프로젝트의 메타데이터와 의존성을 정의하는 파일입니다. 이 파일을 통해 프로젝트에 필요한 패키지를 관리합니다.

용어	설명
패키지	코드의 재사용 가능한 묶음
pub.dev	패키지 저장소
pubspec.yaml	패키지 의존성을 정의하는 파일

3. 기본 코드 예제

Dart 프로젝트에서 패키지를 추가하는 가장 기본적인 방법을 보여드리겠습니다.

pubspec.yaml 파일을 열어보세요.
필요한 패키지를 추가합니다. 예를 들어 http 패키지를 추가하겠습니다.

dependencies:
  http: ^0.13.3

터미널에서 다음 명령어를 실행하여 패키지를 설치합니다.

dart pub get

실행 결과:

http 패키지가 설치되고, 프로젝트의 의존성 목록에 추가됩니다.

코드 한 줄씩 동작 설명:

dependencies:: 여기서부터 필요한 패키지 목록을 작성합니다.
http: ^0.13.3: http 패키지의 버전을 명시합니다. ^ 기호는 해당 버전 이상, 다음 주 버전까지 허용함을 의미합니다.
dart pub get: 지정한 패키지들을 다운로드하고, 프로젝트에 포함시킵니다.

4. 실전 활용 예제

1. API 호출하기

쇼핑몰에서 상품 정보를 가져올 때 http 패키지를 사용합니다.

import 'dart:convert';
import 'package:http/http.dart' as http;

Future<void> fetchProducts() async {
  final response = await http.get(Uri.parse('https://api.example.com/products'));

  if (response.statusCode == 200) {
    List products = json.decode(response.body);
    print(products);
  } else {
    throw Exception('Failed to load products');
  }
}

상황 설명: 쇼핑몰 앱에서 상품 정보를 가져올 때, 외부 API를 호출하여 데이터를 받아옵니다.

2. JSON 데이터 처리하기

받은 JSON 데이터를 모델 객체로 변환해 사용할 수 있습니다.

class Product {
  final String name;
  final double price;

  Product({required this.name, required this.price});

  factory Product.fromJson(Map<String, dynamic> json) {
    return Product(
      name: json['name'],
      price: json['price'],
    );
  }
}

상황 설명: API로부터 받은 JSON 데이터를 Product 객체로 변환하여 앱에서 쉽게 사용할 수 있도록 합니다.

5. 흔한 실수와 주의사항

1. 패키지 버전 충돌

잘못된 코드:

dependencies:
  http: ^0.13.3
  another_package: 0.1.0

올바른 코드:

패키지의 호환성을 확인하고, 필요한 경우 버전을 조정합니다.

2. `pubspec.yaml` 파일의 잘못된 포맷