Flutter프로젝트가 안드로이드 프로젝트로 인식 되는 오류

문제 상황

Android Studio에서 Flutter 프로젝트를 열었을 때 Android 프로젝트로 인식되어 다음과 같은 오류가 발생하는 경우:

• "Error: Entrypoint isn't within the current project" 오류 발생
• Flutter 실행 구성이 나타나지 않음
• Flutter Device Selection 드롭다운이 보이지 않음
• 프로젝트가 Android SDK로 열림

해결 방법

1. Flutter 프로젝트 구조 재생성

# 프로젝트 디렉토리로 이동
cd /mobile

# Flutter 프로젝트 구조 재생성
flutter create . --project-name xxxx --org com.xxxx

2. IDE 캐시 및 설정 초기화

# .idea 폴더 삭제 (Android Studio 설정 초기화)
rm -rf .idea

# Flutter 캐시 정리
flutter clean

3. 의존성 재설치 및 코드 생성

# 패키지 의존성 재설치
flutter pub get

# Freezed, Riverpod 등의 코드 생성 (필요한 경우)
flutter pub run build_runner build --delete-conflicting-outputs

4. Android Studio 프로젝트 설정 파일 생성

4.1 모듈 설정 파일 생성

.idea/modules.xml 파일 생성:

<?xml version="1.0" encoding="UTF-8"?>
<project version="4">
  <component name="ProjectModuleManager">
    <modules>
      <module fileurl="file://$PROJECT_DIR$/xxxxx.iml" filepath="$PROJECT_DIR$/xxxxx.iml" />
    </modules>
  </component>
</project>

4.2 Flutter 실행 구성 파일 생성

.idea/runConfigurations/main_dart.xml 파일 생성:

<component name="ProjectRunConfigurationManager">
  <configuration default="false" name="main.dart" type="FlutterRunConfigurationType" factoryName="Flutter">
    <option name="filePath" value="$PROJECT_DIR$/lib/main.dart" />
    <method v="2" />
  </configuration>
</component>

4.3 프로젝트 타입 설정 파일 생성

.idea/misc.xml 파일 생성:

<?xml version="1.0" encoding="UTF-8"?>
<project version="4">
  <component name="ProjectType">
    <option name="id" value="Flutter" />
  </component>
</project>

5. Android Studio에서 프로젝트 다시 열기

1. Android Studio 완전히 종료
2. Android Studio 다시 실행
3. "Open" 선택 (New Project가 아님)
4. Flutter 프로젝트 폴더 선택 (예: /Users/mobile)
5. Open 클릭

확인 사항

정상적으로 Flutter 프로젝트로 인식되었는지 확인:

• ✅ 상단 툴바에 Flutter Device Selection 드롭다운이 표시됨
• ✅ Run Configuration에 main.dart가 자동으로 설정됨
• ✅ 프로젝트 구조에서 Flutter 아이콘이 표시됨
• ✅ lib 폴더가 소스 폴더로 인식됨
• ✅ pubspec.yaml 파일에 Flutter 아이콘이 표시됨

Flutter 플러그인 확인:

1. Android Studio → Preferences (Mac) / Settings (Windows/Linux)
2. Plugins 메뉴 선택
3. Flutter와 Dart 플러그인이 설치되어 있는지 확인
4. 설치되어 있지 않다면 설치 후 Android Studio 재시작

프로젝트 실행

1. 디바이스 연결
   • 에뮬레이터 실행 또는
   • 실제 디바이스를 USB로 연결 (개발자 모드 활성화 필요)
2. 디바이스 선택
   • 상단 툴바의 디바이스 드롭다운에서 연결된 디바이스 선택
3. 앱 실행
   • Run 버튼(▶️) 클릭 또는
   • 단축키: Shift + F10 (Windows/Linux) / Control + R (Mac)

추가 팁

프로젝트가 여전히 인식되지 않는 경우:

1. File → Invalidate Caches and Restart 실행
2. Android Studio를 완전히 삭제 후 재설치
3. Flutter SDK 경로 확인: File → Settings → Languages & Frameworks → Flutter

자주 발생하는 문제:

• 문제: "Flutter SDK not found"
  • 해결: Flutter SDK 경로 설정 확인
• 문제: "Dart SDK is not configured"
  • 해결: Dart SDK는 Flutter SDK 내부에 포함되어 있음. Flutter SDK 경로가 올바른지 확인

스크립트로 자동화

위의 모든 과정을 자동화하는 스크립트:

fix_flutter_project.sh:

#!/bin/bash

echo "🔧 Flutter 프로젝트 Android Studio 설정 수정 중..."

# 1. IDE 설정 초기화
echo "📁 IDE 설정 초기화..."
rm -rf .idea

# 2. Flutter 정리
echo "🧹 Flutter 캐시 정리..."
flutter clean

# 3. 프로젝트 재생성
echo "🏗️ Flutter 프로젝트 구조 재생성..."
flutter create . --project-name $(basename $(pwd)) --org com.example

# 4. 의존성 설치
echo "📦 패키지 설치..."
flutter pub get

# 5. 코드 생성 (선택사항)
if [ -f "pubspec.yaml" ] && grep -q "build_runner" pubspec.yaml; then
    echo "⚙️ 코드 생성 실행..."
    flutter pub run build_runner build --delete-conflicting-outputs
fi

echo "✅ 완료! Android Studio에서 프로젝트를 다시 열어주세요."

사용 방법:

chmod +x fix_flutter_project.sh
./fix_flutter_project.sh

결론

이 문서의 단계를 따라하면 Android Studio가 Flutter 프로젝트를 올바르게 인식하게 됩니다. 가장 중요한 것은 .idea 폴더의 설정 파일들이 Flutter 프로젝트 타입을 명시하도록 하는 것입니다.