프로젝트 구조
lib, pubspec.yaml, android, ios, web 폴더가 어떤 역할을 하는지 이해합니다.
개념 먼저 보기
프로젝트 구조의 기본 개념부터 잡기
프로젝트 구조 문서는 먼저 용어의 뜻을 잡고, 그 다음 Flutter 코드에서 어디에 쓰이는지 연결해서 읽는 것이 좋습니다.
아래 항목들은 이 문서에서 다루는 내용을 작은 단위로 나눈 것입니다. 각 항목을 읽은 뒤 예제를 보면 코드가 훨씬 덜 추상적으로 느껴집니다.
종류별로 하나씩
프로젝트 구조에서 나눠 볼 핵심 요소
핵심 파일
lib/main.dart는 앱 실행의 기본 진입점입니다.
언제 쓰나: pubspec.yaml은 패키지 의존성, 앱 자산, 버전 정보를 관리합니다.
Flutter에서: test 폴더는 단위 테스트와 위젯 테스트를 넣는 기본 위치입니다.
// 프로젝트 구조 예제입니다.
// 먼저 코드의 큰 흐름을 보고, 주석을 따라 각 줄의 역할을 확인하세요.
flutter:
assets:
- assets/images/플랫폼 폴더
android와 ios 폴더는 플랫폼별 빌드 설정과 네이티브 코드를 포함합니다.
언제 쓰나: web 폴더는 Flutter Web의 기본 HTML, manifest, favicon 설정을 담습니다.
Flutter에서: 플랫폼 폴더를 직접 수정할 때는 변경 이유를 기록해 두는 것이 좋습니다.
// 프로젝트 구조 예제입니다.
// 먼저 코드의 큰 흐름을 보고, 주석을 따라 각 줄의 역할을 확인하세요.
flutter:
assets:
- assets/images/부연 설명
핵심 파일
- lib/main.dart는 앱 실행의 기본 진입점입니다.
- pubspec.yaml은 패키지 의존성, 앱 자산, 버전 정보를 관리합니다.
- test 폴더는 단위 테스트와 위젯 테스트를 넣는 기본 위치입니다.
부연 설명
플랫폼 폴더
- android와 ios 폴더는 플랫폼별 빌드 설정과 네이티브 코드를 포함합니다.
- web 폴더는 Flutter Web의 기본 HTML, manifest, favicon 설정을 담습니다.
- 플랫폼 폴더를 직접 수정할 때는 변경 이유를 기록해 두는 것이 좋습니다.
깊게 이해하기
프로젝트 구조 문서는 Flutter 앱을 만들 때 반복해서 마주치는 개념을 독립적으로 정리한 페이지입니다. 먼저 용어의 의미를 잡고, 그 다음 실제 코드에서 어디에 배치되는지 연결해 보면 학습 속도가 빨라집니다.
이 주제는 단독으로 외우기보다 앞뒤 문서와 함께 보는 것이 좋습니다. 예를 들어 문법 주제는 위젯 코드에서 어떻게 드러나는지, 배포 주제는 실제 앱 운영 흐름에서 어떤 결정을 요구하는지 함께 확인하세요.
상세 예제
아래 예제는 이 문서의 핵심 개념을 실제 프로젝트에서 작은 단위로 적용하는 형태입니다.
flutter:
assets:
- assets/images/실무에서 주의할 점
- 처음에는 가장 단순한 구현으로 시작하고, 반복되는 시점에 구조를 정리하세요.
- 예제 코드를 그대로 외우기보다 입력, 출력, 책임을 나누어 읽어 보세요.
- 새 문서를 추가할 때는 같은 형식으로 요약, 핵심 설명, 예제, 체크리스트를 유지하세요.