Flutter 개발환경 설치와 첫 실행

사전 준비물 체크리스트

• 운영체제: Windows 10/11, macOS, 또는 Linux (권장 최신 업데이트 적용)
• 디스크 여유 공간: 최소 5GB 권장
• 네트워크: 설치 파일 다운로드 가능 환경
• 권한: 관리자 권한(설치 시 필요할 수 있음)
• 실기기(선택): Android 기기 USB 디버깅 활성화 또는 iOS 기기(맥 필요)

설치 및 설정 단계별 가이드

1. Flutter SDK 설치

• 설치 방법 요약
  • Flutter 공식 배포판을 다운로드하여 압축 해제 후 환경변수에 flutter/bin 경로 추가.
  • Windows: 압축 해제 후 시스템 환경변수 PATH에 C:\path\to\flutter\bin 추가.
  • macOS/Linux: 압축 해제 후 ~/.bashrc 또는 ~/.zshrc에 export PATH="$PATH:/path/to/flutter/bin" 추가.
• 설치 확인 명령

bash

flutter --version
flutter doctor

• 중요 출력 항목
  • flutter --version으로 Flutter 버전 확인
  • flutter doctor로 Android SDK, Xcode(맥), Android Studio, VS Code 플러그인 상태 확인

2. Android Studio 또는 VS Code 설치 및 플러그인

• Android Studio
  • 설치 후 SDK Manager에서 Android SDK와 플랫폼 도구 설치
  • AVD Manager에서 가상 디바이스(예: Pixel 4, API 33) 생성
  • 플러그인: Flutter, Dart 설치
• VS Code
  • 설치 후 확장(Extensions)에서 Flutter, Dart 확장 설치
  • Android SDK 경로가 설정되어 있어야 에뮬레이터/빌드 가능
• 권장 설정
  • 에디터에서 자동 포맷팅과 핫 리로드 단축키 숙지

3. 에뮬레이터 설정 또는 실기기 연결

• 에뮬레이터(AVD)
  • Android Studio → AVD Manager → New Virtual Device → 권장 이미지 선택 → 생성 후 실행
• 실기기 연결(Android)
  • 개발자 옵션에서 USB 디버깅 활성화
  • USB로 연결 후 명령으로 확인

bash

adb devices

• iOS 실기기(맥에서만)
  • Xcode 설치 및 기기 신뢰 설정 필요

4. 첫 Flutter 프로젝트 생성 및 실행

• 프로젝트 생성

bash

flutter create hello_flutter
cd hello_flutter

• 에디터에서 열기: VS Code 또는 Android Studio로 프로젝트 열기
• 앱 실행
  • 에뮬레이터가 켜져 있거나 기기가 연결된 상태에서:

bash

flutter run

• 핫 리로드 테스트
  • 코드 수정 후 r(터미널) 또는 에디터의 Hot Reload 버튼 사용

5. 예제 코드 (main.dart)

dart

import 'package:flutter/material.dart';

void main() => runApp(const MyApp());

class MyApp extends StatelessWidget {
  const MyApp({super.key});

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Hello Flutter',
      home: Scaffold(
        appBar: AppBar(title: const Text('Hello Flutter')),
        body: const Center(child: Text('Welcome to Flutter!')),
      ),
    );
  }
}

자주 발생하는 문제와 해결 팁

• flutter doctor에서 Android SDK 누락
  • Android Studio SDK Manager에서 필요한 SDK 플랫폼과 플랫폼 도구 설치
• adb devices에 기기 미표시
  • USB 디버깅 활성화, USB 케이블 교체, 드라이버(Windows) 설치
• 에뮬레이터가 느리거나 실행 불가
  • HAXM 또는 하드웨어 가속 설정 확인, 메모리 할당 조정
• 권한 문제로 PATH 적용 안 됨
  • 터미널 재시작 또는 시스템 재부팅 후 확인
• iOS 빌드 오류(맥)
  • Xcode 라이선스 동의, CocoaPods 설치 및 pod install 실행

실습 과제 및 점검 항목

• 실습 과제
  1. Flutter SDK 설치 완료 및 flutter doctor 출력 스크린샷 제출
  2. 새 프로젝트 hello_flutter 생성 후 에뮬레이터 또는 실기기에서 앱 실행 화면 캡처 제출
  3. main.dart의 텍스트를 변경하고 핫 리로드로 즉시 반영되는지 확인하여 로그 또는 짧은 동영상 제출
• 점검 항목
  • flutter --version 출력 기록
  • flutter doctor에서 빨간색 에러가 없는 상태
  • 에뮬레이터 또는 실기기에서 앱이 정상 실행되는 화면