Flutter 실용가이드 - 프로젝트 CLI 명령어

요약#

• 문제 정의: Flutter 프로젝트를 시작하려면 IDE별 방법과 CLI 명령어를 알아야 한다.
• 해결 방법: VS Code, Android Studio, IntelliJ, Terminal 등 다양한 환경에서 프로젝트를 생성하는 방법을 제공한다.
• 핵심 개념: flutter create¹ 명령어와 IDE 통합 기능을 활용한다.
• 주요 명령어: flutter create, flutter run, flutter build, flutter pub, flutter doctor 등이 있다.
• 적용 대상: Flutter 개발을 처음 시작하거나 CLI에 익숙해지려는 개발자에게 적합하다.

참고 자료#

이 문서는 아래 공식 문서를 기반으로 작성하였다.

• Create a new Flutter app
• Flutter CLI reference

프로젝트 생성#

Flutter 프로젝트를 생성하는 방법은 사용하는 IDE에 따라 다르다. 각 IDE는 Flutter 확장 프로그램을 통해 프로젝트 생성 기능을 제공한다.

터미널에서 직접 flutter create 명령어를 사용하여 프로젝트를 생성할 수 있다.

1
# 기본 앱 생성
2
flutter create my_app
3

4
# 특정 조직 이름으로 생성
5
flutter create --org com.example my_app
6

7
# 빈 앱으로 생성
8
flutter create --empty my_app
9

10
# 특정 플랫폼만 지원
11
flutter create --platforms=ios,android my_app
12

13
# 패키지 생성
14
flutter create --template=package my_package
15

16
# 플러그인 생성
17
flutter create --template=plugin my_plugin

flutter create 옵션#

flutter create 명령어는 다양한 옵션을 제공한다.

1
# 모바일만 지원
2
flutter create --platforms=ios,android my_mobile_app
3

4
# 데스크톱만 지원
5
flutter create --platforms=linux,macos,windows my_desktop_app
6

7
# 웹과 모바일 지원
8
flutter create --platforms=web,ios,android my_cross_platform_app

Flutter CLI 명령어 레퍼런스#

Flutter CLI는 개발 전 과정에서 사용하는 핵심 도구이다. 자주 사용하는 명령어를 카테고리별로 정리하였다.

실행 모드#

Flutter 앱은 세 가지 모드로 실행할 수 있다.

1
# Debug 모드 (기본값)
2
flutter run
3

4
# Profile 모드
5
flutter run --profile
6

7
# Release 모드
8
flutter run --release

flutter doctor 활용#

flutter doctor³는 개발 환경을 진단하는 명령어이다. 문제가 있는 항목을 발견하면 해결 방법을 안내한다.

1
$ flutter doctor
2
Doctor summary (to see all details, run flutter doctor -v):
3
[✓] Flutter (Channel stable, 3.x.x)
4
[✓] Android toolchain - develop for Android devices
5
[✓] Xcode - develop for iOS and macOS
6
[✓] Chrome - develop for the web
7
[✓] Android Studio
8
[✓] VS Code
9
[✓] Connected device (2 available)
10
[✓] Network resources
11

12
• No issues found!

WARNING

[✗] 또는 [!] 표시가 있다면 해당 항목의 문제를 먼저 해결해야 한다. flutter doctor -v 명령어로 상세 정보를 확인할 수 있다.

프로젝트 구조#

flutter create로 생성된 프로젝트의 기본 구조이다.

1
my_app/
2
├── android/          # Android 네이티브 코드
3
├── ios/              # iOS 네이티브 코드
4
├── lib/              # Dart 소스 코드
5
│   └── main.dart     # 앱 진입점
6
├── test/             # 테스트 코드
7
├── web/              # 웹 관련 파일
8
├── pubspec.yaml      # 프로젝트 설정 및 의존성
9
├── pubspec.lock      # 의존성 잠금 파일
10
├── analysis_options.yaml  # 린트 설정
11
└── README.md         # 프로젝트 설명