목표
이번 Flutter 스터디는 크게 3단계로 구성되어 있었다:
1. Flutter 설치 및 환경 설정
2. Android Studio 설치 및 연동
3. Google Stitch로 앱 화면 디자인
간단해 보인다. "환경 설정이야 1시간이면 끝나겠지" 하고 생각했다. 하지만 현실은 달랐다.
첫 번째 난관: flutter doctor의 끝없는 에러
Flutter를 설치하고 신나서 설치 과정을 점검하는 단계에서 시작됐됐다.
>flutter doctor
flutter'은(는) 내부 또는 외부 명령, 실행할 수 있는 프로그램, 또는 배치 파일이 아닙니다.처음부터 잘 안돼는 것 같았다. 😱
"flutter doctor 실행이 안 되는데 어떻게 해야해?"
AI에게 물어보니 다음과 같은 원인을 분석해준다
1. Flutter가 PATH에 설정되지 않았을 가능성
2. Git이 제대로 설치되지 않았을 가능성
3. 이전 설치의 잔여 파일이 남아있을 가능성
확인해보니 결국 예전에 설치했던 Git이 문제를 일으키고 있다는 것을 찾아냈다.
기존 Git 완전 제거 하고 재설치해서 해결할 수 있었다
최신 버전을 다운로드하고 PATH도 자동 설정 옵션을 선택해줬다.
Flutter PATH 설정
add_to_path.ps1 (Claude가 자동 생성)
Write-Host "PATH 환경 변수에 Flutter 추가 중..." -ForegroundColor Cyan
$currentPath = [Environment]::GetEnvironmentVariable("Path", "User")
$flutterPath = "C:\Users\HSKim\flutter\flutter\bin"
if ($currentPath -notlike "*$flutterPath*") {
$newPath = $currentPath + ";$flutterPath"
[Environment]::SetEnvironmentVariable("Path", $newPath, "User")
Write-Host "[✓] Flutter 경로가 추가되었습니다!" -ForegroundColor Green
} else {
Write-Host "[✓] Flutter 경로는 이미 PATH에 있습니다" -ForegroundColor Yellow
}
Write-Host ""스크립트 실행 후 새 터미널을 열자, 성공했다
두 번째 난관: ADB가 보이지 않는다
다음은 Android Studio 설치였다.
Android Studio를 설치하고, 환경변수도 꼼꼼히 설정했다:
ANDROID_HOME = C:\Users\HSKim\AppData\Local\Android\Sdk
Path += %ANDROID_HOME%\platform-tools"이제 됐겠지!" 하고 확인 차원에서 PowerShell에서 점검했는데... 또 아니란다
>adb --version
'adb'은(는) 내부 또는 외부 명령, 실행할 수 있는 프로그램, 또는 배치 파일이 아닙니다.두 번째 실망 ... 😱
환경변수는 분명히 설정했는데 왜 안 될까?
AI 에게 상황을 설명하자, 문제를 점검해줬다.
total 16293
-rwxr-xr-x 1 HSKim 197609 7741592 1월 15 23:30 adb.exe
-rwxr-xr-x 1 HSKim 197609 108184 1월 15 23:30 AdbWinApi.dllADB는 설치되어 있었다! 문제는 PATH 설정이 현재 세션에 반영되지 않은 것이었다.
전체 경로로 실행해서 설치를 확인할 수 있었다.
Android Debug Bridge version 1.0.41
Version 36.0.2-14143358Flutter와 마찬가지로, AI가 스크립트를 만들어주었다:
# add_to_path.ps1 (확장 버전)
$flutterPath = "C:\Users\HSKim\flutter\flutter\bin"
$adbPath = "C:\Users\HSKim\AppData\Local\Android\Sdk\platform-tools"
$currentPath = [Environment]::GetEnvironmentVariable("Path", "User")
# Flutter 경로 추가
if ($currentPath -notlike "*$flutterPath*") {
Write-Host "[+] Flutter 경로 추가 예정: $flutterPath" -ForegroundColor Green
$pathsToAdd += $flutterPath
}
# ADB 경로 추가
if ($currentPath -notlike "*$adbPath*") {
Write-Host "[+] Android SDK 경로 추가 예정: $adbPath" -ForegroundColor Green
$pathsToAdd += $adbPath
}
# PATH 업데이트
if ($pathsToAdd.Count -gt 0) {
$newPath = $currentPath
foreach ($path in $pathsToAdd) {
$newPath += ";$path"
}스크립트 실행 → 터미널 재시작 → 확인:
C:\Users\HSKim\flutter>adb --version
Android Debug Bridge version 1.0.41
C:\Users\HSKim\flutter>flutter doctor
[✓] Flutter (Channel stable, 3.38.7)
[✓] Android toolchain - develop for Android devices이렇게 두 번째 고비도 돌파했다! 🎉
이 모든 과정이 자정을 넘기고 거의 3시간 반이 걸렸다.
AI가 특히 도움이 됐던 점은
1. 체계적인 진단
1. 파일 시스템 확인 (실제로 설치되어 있는지)
2. PATH 설정 확인 (환경변수가 올바른지)
3. 현재 세션 상태 확인 (터미널 재시작이 필요한지)AI가 단계별로 확인하면서 정확한 원인을 찾아주었다.
2. 즉시 실행 가능한 해결책
설명만 해주는 게 아니라, 바로 실행할 수 있는 스크립트를 만들어주었다:
- setup_flutter_env.bat - CMD용 임시 환경 설정
- setup_flutter_env.ps1 - PowerShell용 임시 환경 설정
- add_to_path.ps1 - 영구 PATH 추가 스크립트
각 스크립트마다 명확한 성공/실패 메시지, 진행 상황 표시, 다음 단계 안내를 받았다.
3. 여러 대안 제시
하나의 방법이 막히면, 바로 다른 방법을 제안했다:
방법 1: GUI로 환경변수 직접 수정 (5단계 설명)
방법 2: PowerShell 스크립트로 자동화 (스크립트 제공)
방법 3: 현재 세션에서만 임시로 적용 (즉시 테스트)덕분에 막힐 때마다 빠르게 우회로를 찾을 수 있었다.
결과와 배운 점
얻은 결과
환경 설정 완료!
# 모든 명령어가 정상 작동
flutter doctor
flutter --version
adb --version
adb devices이제 개발 환경이 완벽하게 갖춰졌다. ✨
재사용 가능한 자산
3개의 자동화 스크립트:
1. setup_flutter_env.bat - 빠른 임시 설정
2. setup_flutter_env.ps1 - PowerShell 환경용
3. add_to_path.ps1 - 영구 PATH 추가
다음에 다른 컴퓨터에서 Flutter를 설치할 때, 이 스크립트들만 있으면 5분 안에 환경설정 완료다!
배운 점
1. "안 된다"보다 "이렇게 했더니 이런 오류가 났다"
구체적으로 설명할수록, AI가 정확한 해결책을 제시한다.
예를들면
"flutter 설치가 안돼"이런거 보다는 오류 화면을 붙여 넣고 다음과 같이 설명해준다
"flutter doctor를 실행했더니
'flutter'은(는) 내부 또는 외부 명령... 이라는 오류가 났다.
Flutter는 C:\Users\HSKim\flutter\flutter에 설치했다."2. AI가 만든 스크립트는 자산이다
한 번 만든 스크립트를 휘발시키면 안된다.
- Git에 저장하고
- 다른 프로젝트에 재사용할 수 있다.
일회성이 아니라 지속 가능한 해결책이다.
3. 환경 설정은 문서화가 중요하다
AI와의 대화 내용이 곧 문서다:
- 어떤 문제가 있었는지
- 어떻게 해결했는지
- 같은 문제를 막으려면 어떻게 해야 하는지
다음에 같은 문제를 겪으면, 이 대화를 찾아보면 된다.
다음 단계: Google Stitch로 앱 디자인
환경 설정만으로 자정을 넘겼지만, 이제 기반은 확실히 다져졌다.
Google Stitch로 앱 화면을 디자인하는 부분은 이전에 해 본 경험이 있어서 큰 문제 없을 것 같다
그래서 다음 스터디 시간 전까지 진행해볼 예정이다.
환경 세팅이 끝났으니, 이제부터는 개발에만 집중할 수 있다!
완료된 것과 앞으로의 계획:
1. ✅ Flutter 환경 설정 (완료)
2. ✅ Android Studio 연동 (완료)
3. ⏳ Google Stitch 디자인 (다음 스터디)
4. ⏳ Flutter 앱 개발 시작
환경 점검 프롬프트
이 프로젝트에서 개발환경이 제대로 설정되었는지 점검해줘"이 한마디면 된다.
참고 자료
- [Flutter 공식 설치 가이드](https://flutter.dev/docs/get-started/install)
- [Android Studio 설치 가이드](https://developer.android.com/studio/install)
- [Windows 환경 변수 설정 방법](https://docs.microsoft.com/ko-kr/windows/win32/procthread/environment-variables)
- [Git for Windows](https://gitforwindows.org/)
마무리: 3시간 반의 교훈
혼자였다면 포기했을 수도 있었다.
자정을 넘기고도 해결되지 않는 환경 설정 문제들... "내일 다시 해야 하나?" 하는 생각이 계속 들었다. 하지만 막힐 때마다 스터디장이 해결책을 제시해준 것이 큰 도움이 됐다.
🤖 작성 도구: Claude Code (Sonnet 4.5)
