1. Flutter SDK 설치 및 설정

플러터 SDK를 설치하려면 공식 SDK 아카이브에서 최신 번들을 다운로드한 후, 원하는 위치에 압축을 풀어야 합니다.

SDK 번들 다운로드

SDK 저장 폴더 생성

  • 압축을 풀 폴더를 만듭니다. 공식적으로는 C:\Users\{사용자이름}\develop (또는 %USERPROFILE%\develop) 경로를 추천합니다.
  • 주의: 경로에 공백이나 특수문자가 포함되지 않아야 하며, **관리자 권한(Elevated privileges)**이 필요한 폴더(예: C:\Program Files)는 피하는 것이 좋습니다.

SDK 압축 해제

터미널(PowerShell)에서 아래 명령어를 사용하여 압축을 풀 수 있습니다.

<sdk_zip_path>는 다운로드한 ZIP 파일 경로로, <destination_directory_path>는 압축을 풀 폴더 경로로 바꿔주세요.

PowerShell
 
# 예시: 다운로드 폴더의 파일을 develop 폴더로 압축 해제할 때
Expand-Archive `
  -Path $env:USERPROFILE\Downloads\flutter_windows_3.29.3-stable.zip `
  -Destination $env:USERPROFILE\develop\

2. 환경 변수(PATH)에 Flutter 추가

터미널 어디서든 flutter 명령어를 사용하려면 SDK의 bin 디렉토리를 시스템의 Path 환경 변수에 추가해야 합니다.

경로 설정 단계

  1. 설치 경로 복사: 플러터를 압축 해제한 폴더 내의 bin 폴더 절대 경로를 복사합니다. (예: C:\Users\Name\develop\flutter\bin)
  2. 환경 변수 설정 진입: * Windows 키 + Pause를 누릅니다. (없다면 Windows + Fn + B)
    • 시스템 > 정보 창이 뜨면 고급 시스템 설정 > 고급 탭 > 환경 변수를 클릭합니다.
  3. Path 추가:
    • '사용자 변수' 섹션에서 Path를 찾아 더블 클릭합니다.
    • 빈 줄을 더블 클릭하고 복사한 bin 폴더 경로를 입력합니다. (예: %USERPROFILE%\develop\flutter\bin)
    • 추가한 항목을 선택하고 [위로 이동] 버튼을 눌러 목록의 가장 위로 올립니다.
  4. 저장: 모든 창에서 확인을 세 번 눌러 설정을 마칩니다.

3. 설정 적용 및 확인

변경 사항을 적용하고 설치가 잘 되었는지 확인해 봅시다.

  1. 터미널 재시작: 현재 열려 있는 모든 명령 프롬프트(CMD), PowerShell 또는 IDE(VS Code 등)를 종속 종료하고 다시 엽니다.
  2. 명령어 실행: 터미널에 다음 명령어를 입력하여 버전을 확인합니다.
Bash
 
flutter --version
dart --version

결과 확인: 만약 "명령어를 찾을 수 없다"는 메시지가 나온다면, 환경 변수에 입력한 경로가 실제 bin 폴더 위치와 일치하는지 다시 한번 체크해 보세요.

💡 다음 단계는 무엇인가요?

설치가 잘 끝났다면, 이제 시스템에 부족한 도구가 없는지 진단해 볼 차례입니다. 터미널에 아래 명령어를 입력해 보세요.

flutter doctor

반응형

+ Recent posts

티스토리툴바