VS Code로 Flutter 안드로이드 앱 만들기 — 개요

pubspec.yaml 구조 이해

#pubspec #yaml #의존성 #패키지

@devpc | 2026-04-01 23:22:53 |

Context:

Flow v1 → Node v1

# pubspec.yaml 구조 이해

`pubspec.yaml`은 Flutter 프로젝트의 **설정 파일**입니다. 앱 이름, 버전, 사용하는 패키지, 이미지·폰트 리소스를 모두 여기서 관리합니다.

## 기본 구조

```yaml
name: my_first_app
description: A new Flutter project.
publish_to: 'none'     # 패키지 배포 안 할 경우 유지

version: 1.0.0+1       # 앱 버전

environment:
  sdk: '>=3.0.0 <4.0.0'  # 지원하는 Dart SDK 버전

dependencies:
  flutter:
    sdk: flutter
  # 여기에 사용할 패키지 추가

dev_dependencies:
  flutter_test:
    sdk: flutter
  flutter_lints: ^3.0.0

flutter:
  uses-material-design: true
  # 이미지, 폰트 등 리소스 등록
```

## version 필드 설명

```
version: 1.0.0+1
         ─┬─── ─┬
          │      └ build number (플레이스토어 업로드마다 올려야 함)
          └──── 사용자에게 보이는 버전명 (versionName)
```

- `1.0.0` — Major.Minor.Patch (사용자에게 표시되는 버전)
- `+1` — 내부 빌드 번호 (플레이스토어에서 업로드 순서를 구분)

> 플레이스토어에 새로 올릴 때마다 빌드 번호는 반드시 이전보다 커야 합니다.

## 리소스(이미지, 폰트) 등록

```yaml
flutter:
  assets:
    - assets/images/logo.png
    - assets/images/          # 폴더 전체 등록

fonts:
    - family: NotoSans
      fonts:
        - asset: fonts/NotoSans-Regular.ttf
        - asset: fonts/NotoSans-Bold.ttf
          weight: 700
```

## YAML 작성 시 주의사항

- 들여쓰기는 **스페이스 2칸** (탭 사용 금지)
- 콜론(`:`) 뒤에 반드시 한 칸 공백
- 수정 후 `flutter pub get` 실행 필요

pubspec.yaml 구조 이해

// COMMENTS

ON THIS PAGE